@hostsmith/mcp-server
MCP server for the Hostsmith hosting platform
Versions
1.5.2latest1.5.2-rc.d2ee5421.5.11.5.1-rc.7cb0c971.5.0+ show 27 moreshow less
1.4.01.3.01.2.11.2.01.2.0-rc.ca3615d1.2.0-rc.d47c6521.2.0-rc.cc385fb1.2.0-rc.ffcc2391.2.0-rc.3394a5d1.2.0-rc.566aa0d1.2.0-rc.8debd991.1.11.1.01.1.0-rc.231.0.41.0.4-rc.201.0.4-rc.181.0.4-rc.141.0.4-rc.121.0.31.0.3-rc.11.0.3-rc-rel.11.0.21.0.11.0.00.1.00.0.2Tools 7
list_sites List Hostsmith sites in the user\
list_domains 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
get_account Get the user
get_site 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 live and grab the URL to share with the user. Defaults to the user
delete_site 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; otherwise the call returns an error explaining the safeguard.
deploy_files 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 URL to share. The site must already exist - call `create_site` first if you do not have a `siteId`. Deploying to a site that already has content overwrites it - confirm overwrite with the user first.\n\n**Anti-pattern:** do not use this tool to ship binaries (images, PDFs, video, fonts, zips) by base64-embedding or data-URI inlining them into HTML/CSS/JSON. Binaries belong on `deploy_create_upload`. If that path is blocked by sandbox/network, escalate to the user (ask them to enable egress, or offer manual upload of the presigned URL) - never reach for this tool as a workaround. Inlining bloats pages, breaks browser caching, and reships the bytes on every deploy.
deploy_finalize 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 completion entry). Returns the live site URL on success. The site must belong to the authenticated user; bearer-token auth is re-validated server-side, so holding presigned URLs alone does not let an unrelated caller finalize.
Permissions 3
network medium filesystem low env_vars low