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 publishing a one-pager from claude.ai or Desktop. 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 |
| listsites | List all sites in your account for a given data partition |
| getsite | Get details of a specific site |
| createsite | Create a new site |
| deletesite | Delete a site |
| listdomains | List available domains (shared and custom) |
| getaccount | Get account info, subscription plan, and usage |
| deployfiles | Deploy inline file contents to a site |
| deploycreateupload | Start a direct upload for binaries / large files |
| deployfinalize | Commit a deploy started with deploycreateupload |
## Usage
Authentication is via OAuth 2.0. Static access tokens are not supported.
### Claude (claude.ai, Desktop, Cowork, mobile)
Add Hostsmith once as a custom connector and it works in every Claude app on your account.
1. In Claude, open Customize > Connectors, click + Add, then Add custom connector.
2. Enter Hostsmith as the name and paste the MCP server URL:
https://mcp.hostsmith.net/mcp
3. Click Continue, finish adding the connector, then connect it. Claude opens Hostsmith in your browser to authorize the connector against your Hostsmith account.
Free Claude plans allow one custom connector. On Team and Enterprise plans, an owner adds the connector under Organization settings > Connectors, and each member then clicks Connect next to Hostsmith under Customize > Connectors to sign in with their own Hostsmith account.
Claude asks for your approval before each tool call. To change that, open Hostsmith under Customize > Connectors and set its Tool permissions.
To revoke, open Hostsmith under Customize > Connectors, click ⋯, then Remove (Team and Enterprise owners: Organization settings > Connectors). To force a re-auth, click Disconnect, then Connect.
### Stdio (Claude Code, Cursor, Cline, Windsurf, Zed)
Add this entry to your MCP client's config:
json
"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:
json
"mcpServers": {
"hostsmith": {
"url": "https://mcp.hostsmith.net/mcp"
The client handles the OAuth flow automatically - you'll be redirected to Hostsmith to authorize access.
Claude Code can use the hosted server directly too:
bash
claude mcp add --transport http hostsmith https://mcp.hostsmith.net/mcp
### Cursor (one-click install)