Docs MCP
Hostsmith MCP server
Hostsmith ships an official Model Context Protocol server so AI agents can publish files as live HTTPS URLs without a repo, build step, or CI pipeline. Install it once in your client, run the OAuth flow, and your agent can create sites, deploy artifacts, and manage custom domains directly.
AI agents can make mistakes. They may deploy the wrong file, overwrite a site you wanted to keep, delete a site that looked unused, or pick the wrong data partition. Review each tool call before approving destructive actions, and treat any agent-driven deploy as something you might need to undo. Hostsmith and ops42 OU are not liable for damages caused by AI-generated actions - see the Terms of Service.
Why use the MCP server
- Artifact-first. Generate a file in your agent, get a public URL back. No git push, no deploy script.
- Native to your client. Works with Claude Desktop connectors, stdio (Claude Code, Cursor, Cline, Windsurf, Zed), and any MCP-compatible Streamable-HTTP client.
- Scoped OAuth, not API keys. The user authorizes the server once in the browser. No long-lived secrets in client config.
- Multi-partition aware. Tools accept an explicit
partitionargument; otherwise the server uses the home partition encoded in your access token.
Supported clients
| Client | Transport | Setup |
|---|---|---|
| Claude Desktop | Streamable HTTP | Custom connector URL |
| Claude Code, Cursor, Cline, Windsurf, Zed | stdio | npx @hostsmith/mcp-server |
| Other MCP clients with Streamable-HTTP support | Streamable HTTP | Remote URL |
| Self-hosted | HTTP | npx @hostsmith/mcp-server http |
When to use MCP vs the REST API or SDK
| You want to... | Use |
|---|---|
| Deploy an artifact your agent just generated | MCP |
| Let a chat user manage their sites by typing in the chat | MCP |
| Build a backend integration or CI pipeline | REST API |
| Build a TypeScript or JavaScript client | JS SDK |
Where to next
- Quick start - install in your client and ship your first deploy in under a minute.
- Clients - one-time setup for each supported client.
- Authentication - how OAuth works for the MCP server, what scopes are requested, and how to revoke access.
- Tools - reference for every tool the server exposes.
- Recipes - task-shaped how-tos for the things people actually want to do.
- Limits and errors - quotas, error taxonomy, and retry guidance.
- FAQ - the questions that come up most often.