Summary
Connects Claude to Hostsmith's hosting platform so agents can deploy static sites and get back live HTTPS URLs without touching a repo or CI pipeline. Exposes site CRUD, domain management, account queries, and two deployment paths: inline file upload for small artifacts or a chunked upload flow for binaries. Authentication is OAuth only, no static tokens. Supports EU and US data residency with partition selection baked into the tool calls. Ships as stdio for most editors, remote streamable HTTP for Claude Desktop and Cursor, or self-hosted HTTP if you want to run it locally. Built for the workflow where an agent generates an HTML report or demo page and you want it live in seconds.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
9 tools
list_sitesList Hostsmith sites in the user's account. Returns each site's `siteId`, `subdomain`, `domain`, and current status - feed `siteId` into `get_site`, `deploy_files`, `deploy_create_upload`, or `delete_site`. This is the source of truth for "does the user already have a site at...1 params
List Hostsmith sites in the user's account. Returns each site's `siteId`, `subdomain`, `domain`, and current status - feed `siteId` into `get_site`, `deploy_files`, `deploy_create_upload`, or `delete_site`. This is the source of truth for "does the user already have a site at...
Parameters* required
partitionstringFilter by data partition. Omit to query all partitions.one of
us · eulist_domainsList domains the user can host sites under. Returns shared hosting domains (e.g. `hostsmith.link`, available to everyone) and custom domains owned by the user's organization. Use this to pick a `domain` value before calling `create_site`. By default queries all partitions and...2 params
List domains the user can host sites under. Returns shared hosting domains (e.g. `hostsmith.link`, available to everyone) and custom domains owned by the user's organization. Use this to pick a `domain` value before calling `create_site`. By default queries all partitions and...
Parameters* required
sharedbooleanFilter by domain type: true for shared only, false for custom only. Omit for both.
partitionstringFilter by data partition. Omit to query all partitions.one of
us · euget_accountGet the user's account: organization details (`orgId`, `orgName`), the calling user's home partition under `user.homePartition`, current subscription plan with its limits (max sites, max domains, storage, bandwidth), and current usage counts. Use to check how much headroom the...
Get the user's account: organization details (`orgId`, `orgName`), the calling user's home partition under `user.homePartition`, current subscription plan with its limits (max sites, max domains, storage, bandwidth), and current usage counts. Use to check how much headroom the...
No parameter schema in public metadata yet.
get_siteGet full details of a specific Hostsmith site by ID, including its public URL (`https://<subdomain>.<domain>`), current deployment status, and configuration. Use after `list_sites` to inspect a single site, or after `deploy_files` / `deploy_finalize` to confirm the site is liv...2 params
Get full details of a specific Hostsmith site by ID, including its public URL (`https://<subdomain>.<domain>`), current deployment status, and configuration. Use after `list_sites` to inspect a single site, or after `deploy_files` / `deploy_finalize` to confirm the site is liv...
Parameters* required
siteIdstringThe site ID returned by `list_sites` or `create_site`.
partitionstringData partition the site lives in (visible in list_sites output). Omit to use the user's home partition.one of
us · eucreate_siteCreate a new Hostsmith site and return its `siteId`, full URL, and configuration. Use when the user wants to publish or host new content and no suitable site already exists. After creation, deploy content with `deploy_files` (small inline text) or `deploy_create_upload` + `dep...3 params
Create a new Hostsmith site and return its `siteId`, full URL, and configuration. Use when the user wants to publish or host new content and no suitable site already exists. After creation, deploy content with `deploy_files` (small inline text) or `deploy_create_upload` + `dep...
Parameters* required
domainstringParent domain for the site, MUST be one returned by `list_domains` for this user. Examples: "us.hostsmith.link", "eu.hostsmith.link", or a custom domain the user owns. Do not invent domains.
partitionstringData partition for the new site. Must match the partition of the selected domain.one of
us · eusubdomainstringSubdomain prefix; auto-generated if omitted. Lowercase alphanumeric with hyphens only - no dots, uppercase, or underscores. Pass `subdomain: "www"` only when the chosen `domain` has `enableApexDomain: true` in `list_domains` (creates the canonical site at `www.<apex>` with the bare apex redirecting to it). For any other subdomain the chosen `domain` must have `enableSubdomains: true`.
delete_sitePermanently delete a Hostsmith site and all of its deployed files. **Destructive - only call after explicit user confirmation.** The site URL becomes unreachable immediately and the content cannot be recovered. The user must pass `confirm: true` for the deletion to proceed; ot...3 params
Permanently delete a Hostsmith site and all of its deployed files. **Destructive - only call after explicit user confirmation.** The site URL becomes unreachable immediately and the content cannot be recovered. The user must pass `confirm: true` for the deletion to proceed; ot...
Parameters* required
siteIdstringThe site ID to delete (from `list_sites` or `get_site`).
confirmbooleanSet to true only after the user has explicitly confirmed they want to permanently delete this site. Required safeguard - never pass true speculatively.
partitionstringData partition the site lives in. Omit to use the user's home partition.one of
us · eudeploy_filesPublish in-memory file contents to a Hostsmith site without writing to disk. Use when you have just generated content (an HTML page, a report, JSON data) and the user wants it live. Returns the deployment version and status; call `get_site` afterwards if you need the public UR...3 params
Publish in-memory file contents to a Hostsmith site without writing to disk. Use when you have just generated content (an HTML page, a report, JSON data) and the user wants it live. Returns the deployment version and status; call `get_site` afterwards if you need the public UR...
Parameters* required
filesarrayFiles to deploy. For an HTML site, include an `index.html` as the entry point; otherwise any single file (PDF, image, JSON, etc.) works on its own.
siteIdstringThe site ID to deploy to (from `list_sites` or `create_site`).
partitionstringData partition the site lives in. Omit to use the user's home partition.one of
us · eudeploy_create_uploadStart a direct-to-S3 upload for binary or large files. Use this instead of `deploy_files` for binaries (PDF, image, video, zip) or any file > ~1 MB. The MCP server has no access to the user's filesystem and `deploy_files` ships content inline through Lambda (capped at ~6 MB JS...3 params
Start a direct-to-S3 upload for binary or large files. Use this instead of `deploy_files` for binaries (PDF, image, video, zip) or any file > ~1 MB. The MCP server has no access to the user's filesystem and `deploy_files` ships content inline through Lambda (capped at ~6 MB JS...
Parameters* required
filesarrayFiles to upload. Most user requests are a single file.
siteIdstringThe site ID to deploy to (from `list_sites` or `create_site`).
partitionstringData partition the site lives in. Omit to use the user's home partition.one of
us · eudeploy_finalizeCommit a deploy started with `deploy_create_upload`. Pass the `versionId` from the start response and a `completions` array containing the agent-collected ETags for each multi-part file (single-part uploads - those whose start response had an empty `uploadId` - do not need a c...4 params
Commit a deploy started with `deploy_create_upload`. Pass the `versionId` from the start response and a `completions` array containing the agent-collected ETags for each multi-part file (single-part uploads - those whose start response had an empty `uploadId` - do not need a c...
Parameters* required
siteIdstringThe site ID being deployed to (must match the start call).
partitionstringData partition the site lives in. Omit to use the user's home partition.one of
us · euversionIdstringThe `versionId` returned by `deploy_create_upload`.
completionsarrayCompletions for multi-part uploads. Omit or pass an empty array if every file was single-part.
@hostsmith/mcp-server
Official Model Context Protocol server for the Hostsmith hosting platform.
Static hosting for agents - give it a file, get a live URL. Claude Code shipping an HTML report. Cursor previewing a generated demo. Claude Desktop publishing a one-pager. One MCP call → public HTTPS URL in seconds. No repo, no CI, no build step. Custom domains, private sites, EU or US data residency.
Why Hostsmith
- Artifact-first. No repo, no build config - drop a file (or have the agent generate one), get a URL.
- Built for agents. MCP-native, OAuth-scoped, structured tool descriptions agents can chain.
- EU or US data residency. Pick where the user's data lives, architecturally - not via a checkbox.
Tools
| Tool | Description |
|---|---|
list_sites | List all sites in your account for a given data partition |
get_site | Get details of a specific site |
create_site | Create a new site |
delete_site | Delete a site |
list_domains | List available domains (shared and custom) |
get_account | Get account info, subscription plan, and usage |
deploy_files | Deploy inline file contents to a site |
deploy_create_upload | Start a direct upload for binaries / large files |
deploy_finalize | Commit a deploy started with deploy_create_upload |
Usage
Authentication is via OAuth 2.0. Static access tokens are not supported.
Claude Desktop
Open Settings → Connectors → Add custom connector and enter:
https://mcp.hostsmith.net/mcp
Claude Desktop runs the OAuth flow in your browser to authorize the connector against your Hostsmith account.
Stdio (Claude Code, Cursor, Cline, Windsurf, Zed)
Add this entry to your MCP client's config:
{
"mcpServers": {
"hostsmith": {
"command": "npx",
"args": ["-y", "@hostsmith/mcp-server"]
}
}
}
The first tool call triggers an OAuth flow in your browser to authorize the server against your Hostsmith account.
Remote URL (other clients)
Any MCP client that supports remote Streamable HTTP transport can point directly at the hosted server:
{
"mcpServers": {
"hostsmith": {
"url": "https://mcp.hostsmith.net/mcp"
}
}
}
The client handles the OAuth flow automatically - you'll be redirected to Hostsmith to authorize access.
Cursor (one-click install)
Click the badge to add the remote Hostsmith server (https://mcp.hostsmith.net/mcp) to Cursor. The first tool call triggers OAuth in your browser.
Local HTTP (self-hosted)
Run the server in HTTP mode and have your MCP client perform OAuth against it:
npx @hostsmith/mcp-server http
{
"mcpServers": {
"hostsmith": {
"url": "http://localhost:3100/mcp"
}
}
}
Environment variables
| Variable | Default | Description |
|---|---|---|
HOSTSMITH_URL | https://hostsmith.net | Hostsmith app URL (OAuth endpoints). |
HOSTSMITH_API_DOMAIN | - | Override the upstream API domain across both partitions. The server prepends us.api. and eu.api. to the value you set. Example: HOSTSMITH_API_DOMAIN=staging.example.com routes calls to https://us.api.staging.example.com and https://eu.api.staging.example.com. Use this to point at a staging or proxied API host. |
HOSTSMITH_BASE_URL | - | Override the API base URL with a single fixed value, bypassing partition selection entirely. |
PORT | 3100 | HTTP server port. |
MCP_BASE_URL | http://localhost:$PORT | Public URL of the MCP server, used in OAuth metadata. |
Network access
The MCP transport and OAuth flow run in your client's app process and need no agent-sandbox configuration - if your MCP client connected, those paths are working.
The one place sandboxed agents commonly fail is the upload PUT during deploy_create_upload + deploy_finalize: the bytes go from the agent's shell to the partition API host. From the agent terminal, allow outbound HTTPS (port 443) to:
us.api.hostsmith.net(for sites in theuspartition)eu.api.hostsmith.net(for sites in theeupartition)
Sandbox-specific snippets (Cursor sandbox.json, Claude Code settings.json, Codex config.toml, generic firewall guidance) live in the Network access docs.
Troubleshooting
- Tool calls return 401: the OAuth session expired. Reconnect from your MCP client to re-authorize.
- OAuth redirect loops: confirm
MCP_BASE_URLmatches the URL your MCP client uses to reach the server. - Wrong partition: tool calls accept an explicit
partitionarg; if you omit it, the partition is inferred from your access token. - Upload PUT fails (DNS, refused, proxy, timeout): the agent's shell can't reach the partition API host. See Network access.
- Inspect the install:
npx @modelcontextprotocol/inspector npx -y @hostsmith/mcp-server httpto browse tools interactively.
Documentation
Deeper material lives at hostsmith.net/docs/mcp.
Contributing
See CONTRIBUTING.md (including the Releases section for the version-stamping flow). Security issues: see SECURITY.md.
License
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Configuration
HOSTSMITH_URLdefault: https://hostsmith.netHostsmith app URL (OAuth endpoints).
HOSTSMITH_API_DOMAINOverride the upstream API domain across both partitions; 'us.api.' and 'eu.api.' are prepended to this value.
HOSTSMITH_BASE_URLOverride the API base URL with a single fixed value, bypassing partition selection entirely.