{
  "markdown": "# @hostsmith/mcp-server\n\n[![CI](https://github.com/hostsmith/mcp-server/actions/workflows/ci.yml/badge.svg)](https://github.com/hostsmith/mcp-server/actions/workflows/ci.yml)\n[![Latest Release](https://img.shields.io/github/v/release/hostsmith/mcp-server)](https://github.com/hostsmith/mcp-server/releases/latest)\n[![Node Version](https://img.shields.io/node/v/@hostsmith/mcp-server)](./package.json)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)\n[![MCP](https://img.shields.io/badge/MCP-compatible-0a7bbb.svg)](https://modelcontextprotocol.io)\n[![smithery badge](https://smithery.ai/badge/hostsmith/mcp-server)](https://smithery.ai/servers/hostsmith/mcp-server)\n\nOfficial [Model Context Protocol](https://modelcontextprotocol.io) server for the [Hostsmith](https://hostsmith.net) hosting platform.\n\n**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.\n\n![Deploy a page from Claude Code and get a live URL](./demo.gif)\n\n### Why Hostsmith\n\n- **Artifact-first.** No repo, no build config - drop a file (or have the agent generate one), get a URL.\n- **Built for agents.** MCP-native, OAuth-scoped, structured tool descriptions agents can chain.\n- **EU or US data residency.** Pick where the user's data lives, architecturally - not via a checkbox.\n\n## Tools\n\n| Tool                   | Description                                                  |\n| ---------------------- | ------------------------------------------------------------ |\n| `list_sites`           | List all sites in your account for a given data partition    |\n| `get_site`             | Get details of a specific site                               |\n| `create_site`          | Create a new site                                            |\n| `delete_site`          | Delete a site                                                |\n| `list_domains`         | List available domains (shared and custom)                   |\n| `get_account`          | Get account info, subscription plan, and usage               |\n| `deploy_files`         | Deploy inline file contents to a site                        |\n| `deploy_create_upload` | Start a direct upload for binaries / large files             |\n| `deploy_finalize`      | Commit a deploy started with `deploy_create_upload`          |\n\n## Usage\n\nAuthentication is via OAuth 2.0. Static access tokens are not supported.\n\n### Claude Desktop\n\nOpen **Settings → Connectors → Add custom connector** and enter:\n\n```\nhttps://mcp.hostsmith.net/mcp\n```\n\nClaude Desktop runs the OAuth flow in your browser to authorize the connector against your Hostsmith account.\n\n### Stdio (Claude Code, Cursor, Cline, Windsurf, Zed)\n\nAdd this entry to your MCP client's config:\n\n```json\n{\n  \"mcpServers\": {\n    \"hostsmith\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@hostsmith/mcp-server\"]\n    }\n  }\n}\n```\n\nThe first tool call triggers an OAuth flow in your browser to authorize the server against your Hostsmith account.\n\n### Remote URL (other clients)\n\nAny MCP client that supports remote Streamable HTTP transport can point directly at the hosted server:\n\n```json\n{\n  \"mcpServers\": {\n    \"hostsmith\": {\n      \"url\": \"https://mcp.hostsmith.net/mcp\"\n    }\n  }\n}\n```\n\nThe client handles the OAuth flow automatically - you'll be redirected to Hostsmith to authorize access.\n\n### Cursor (one-click install)\n\n[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=Hostsmith&config=eyJ1cmwiOiJodHRwczovL21jcC5ob3N0c21pdGgubmV0L21jcCJ9)\n\nClick the badge to add the remote Hostsmith server (`https://mcp.hostsmith.net/mcp`) to Cursor. The first tool call triggers OAuth in your browser.\n\n### Local HTTP (self-hosted)\n\nRun the server in HTTP mode and have your MCP client perform OAuth against it:\n\n```bash\nnpx @hostsmith/mcp-server http\n```\n\n```json\n{\n  \"mcpServers\": {\n    \"hostsmith\": {\n      \"url\": \"http://localhost:3100/mcp\"\n    }\n  }\n}\n```\n\n## Environment variables\n\n| Variable               | Default                  | Description                                                                                                                                                                                                                                                                                                                       |\n| ---------------------- | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `HOSTSMITH_URL`        | `https://hostsmith.net`  | Hostsmith app URL (OAuth endpoints).                                                                                                                                                                                                                                                                                              |\n| `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. |\n| `HOSTSMITH_BASE_URL`   | -                        | Override the API base URL with a single fixed value, bypassing partition selection entirely.                                                                                                                                                                                                                                      |\n| `PORT`                 | `3100`                   | HTTP server port.                                                                                                                                                                                                                                                                                                                 |\n| `MCP_BASE_URL`         | `http://localhost:$PORT` | Public URL of the MCP server, used in OAuth metadata.                                                                                                                                                                                                                                                                             |\n\n## Network access\n\nThe 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.\n\nThe 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:\n\n- `us.api.hostsmith.net` (for sites in the `us` partition)\n- `eu.api.hostsmith.net` (for sites in the `eu` partition)\n\nSandbox-specific snippets (Cursor `sandbox.json`, Claude Code `settings.json`, Codex `config.toml`, generic firewall guidance) live in the [Network access](https://hostsmith.net/docs/mcp/network-access) docs.\n\n## Troubleshooting\n\n- **Tool calls return 401**: the OAuth session expired. Reconnect from your MCP client to re-authorize.\n- **OAuth redirect loops**: confirm `MCP_BASE_URL` matches the URL your MCP client uses to reach the server.\n- **Wrong partition**: tool calls accept an explicit `partition` arg; if you omit it, the partition is inferred from your access token.\n- **Upload PUT fails (DNS, refused, proxy, timeout)**: the agent's shell can't reach the partition API host. See [Network access](https://hostsmith.net/docs/mcp/network-access).\n- **Inspect the install**: `npx @modelcontextprotocol/inspector npx -y @hostsmith/mcp-server http` to browse tools interactively.\n\n## Documentation\n\nDeeper material lives at [hostsmith.net/docs/mcp](https://hostsmith.net/docs/mcp).\n\n## Contributing\n\nSee [CONTRIBUTING.md](./CONTRIBUTING.md) (including the [Releases](./CONTRIBUTING.md#releases) section for the version-stamping flow). Security issues: see [SECURITY.md](./SECURITY.md).\n\n## License\n\n[MIT](./LICENSE)\n",
  "bytes": 8619,
  "sha": "ea3849c011728a707f60116a547cdaa55045a5b2eed6c64ec6ebd0f1217fe0cd",
  "repo_slug": "hostsmith/mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_hostsmith_mcp_server_bddd987c/readme"
}