# hostsmith/mcp-server [Health: Active]

**Category:** ☁️ Cloud Platforms  
**Repository:** https://github.com/hostsmith/mcp-server  
**GitHub Stars:** 0  
**npm Downloads (last month):** 630  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/mcp-server-122

## Description
Deploy static sites on Hostsmith - give it a file, get a live HTTPS URL. EU/US residency.

## Tools
Capabilities this server exposes over MCP:

- **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

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "mcp-server": {
    "command": "npx",
    "args": ["-y","@hostsmith/mcp-server"]
  }
}
```

## Documentation

## What hostsmith/mcp-server MCP server does

hostsmith/mcp-server exposes Hostsmith static hosting operations through the Model Context Protocol. An agent can create a site, upload generated files, and use the resulting live HTTPS address for a report, demo, landing page, or other static artifact. It also provides account and site administration tools, including site details, deletion, domain discovery, subscription information, and usage data.

Hostsmith supports shared and custom domains, private sites, and separate EU or US data partitions. The server is suited to workflows where the agent produces deployable files directly rather than working through a source repository, build configuration, or continuous integration system.

## How it works

Authentication uses OAuth 2.0; static access tokens are not supported. The hosted MCP endpoint is available at `https://mcp.hostsmith.net/mcp`, and clients that support remote Streamable HTTP can connect to it directly. During the first tool call, the client redirects the user to Hostsmith to authorize access.

For local stdio use, an MCP client can launch the package with `npx -y @hostsmith/mcp-server`. The package also supports a local HTTP mode through `npx @hostsmith/mcp-server http`, exposing the MCP endpoint at port 3100 by default. Claude Code can use either the stdio configuration or the hosted HTTP endpoint.

Deployments may send file contents inline with `deploy_files`. For binaries or larger files, `deploy_create_upload` starts a direct upload and `deploy_finalize` commits it. Site and domain operations use the selected Hostsmith data partition.

## Setup and configuration

Claude users can add the hosted endpoint as a custom connector and authorize it in the browser. Cursor can add the same remote endpoint through its MCP installation flow. Claude Code, Cursor, Cline, Windsurf, and Zed can also launch the package through the standard stdio configuration.

The HTTP handler can be embedded in a Lambda, edge worker, or Node server through `createFetchHandler`. It accepts configuration for the Hostsmith URL and MCP base URL, and an optional `onServer` hook that runs for authenticated MCP requests. The package itself sends no telemetry; the hosted service may attach its own usage analytics hook.

Configuration can override the Hostsmith application URL, API domain, API base URL, HTTP port, and MCP base URL. API-domain overrides can route requests to staging or proxied hosts, while a fixed base URL bypasses partition selection.

## Tools and capabilities

- `list_sites` retrieves sites for an account and data partition.
- `get_site` returns details for a selected site.
- `create_site` provisions a new site.
- `delete_site` removes a site.
- `list_domains` shows shared and custom domains available to the account.
- `get_account` reports account details, subscription plan, and usage.
- `deploy_files` publishes inline file contents.
- `deploy_create_upload` begins a direct upload for binaries or large files.
- `deploy_finalize` commits a previously started upload.

## Limitations and notes

OAuth 2.0 authorization is required, and static access tokens cannot be used. The server is focused on static hosting; its documented deployment flow sends files rather than building an application from a repository. When embedding the handler, decoded token claims supplied to `onServer` are not verified by the hook itself; Hostsmith verifies the token during each tool call.

_Full upstream README: https://allmcps.com/mcp/mcp-server-122/readme_