MCP Server logo

MCP Server

by hostsmith

Deploy static files to Hostsmith, manage sites and domains, and receive public HTTPS URLs through MCP.

Install MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "mcp-server-122": {
      "command": "npx",
      "args": [
        "-y",
        "@hostsmith/mcp-server"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

hostsmith/mcp-server MCP server connects AI clients to the Hostsmith hosting platform for artifact-first static site deployment. It can create, inspect, list, and delete sites, manage domain information, read account usage, and deploy inline or uploaded files. OAuth 2.0 protects access, with hosted Streamable HTTP and local stdio or HTTP options. Reach for it when an agent needs to publish generated HTML or other static assets without a repository, CI pipeline, or build step.

Use cases

  • Publish generated HTML reports
  • Deploy static demos for preview
  • Create one-page sites from agent-produced files
  • Upload large static binaries
  • Check hosting usage and subscription details

Key features

  • Static site creation and deletion
  • Inline and direct-upload deployments
  • Site, domain, and account inspection
  • EU or US data partition support
  • OAuth 2.0 authentication
  • Hosted Streamable HTTP and local stdio modes

Tools9

What MCP Server lets your agent do. Expand a tool for its parameters.

Self-reported~113 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

8/8 checks healthy over the last 43d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 1d ago via OSV.dev · @hostsmith/mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads630Package downloads in the last 30 days.
Last commit3d agoMost recent push to the default branch.
Tools exposed9Callable tools this server registers over MCP.

How MCP Server works

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.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Server

hostsmith/mcp-server is an MCP server that connects AI clients to Hostsmith static hosting. Its main tools create, inspect, list, and delete sites; list domains; read account usage; and deploy files either inline or through a staged upload for larger binaries.

Install it in an MCP client by launching `npx -y @hostsmith/mcp-server` with the stdio configuration, or connect to `https://mcp.hostsmith.net/mcp` over Streamable HTTP. The first tool call starts OAuth authorization in a browser.

Yes, hostsmith/mcp-server works with Cursor. Add the hosted endpoint `https://mcp.hostsmith.net/mcp` through Cursor's MCP installation flow, or configure the package as a stdio server. OAuth authorization begins on the first tool call.

Use `deploy_create_upload` to start a direct upload, then call `deploy_finalize` to commit it. Smaller or inline file contents can be published with `deploy_files` instead.

Yes, the server supports EU or US data partitions. Site listing and deployment operations use the selected partition, and API-domain configuration can override the upstream hosts used for those partitions.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/mcp-server-122?style=directory)](https://allmcps.com/mcp/mcp-server-122)
HTML Embed
<a href="https://allmcps.com/mcp/mcp-server-122"><img src="https://allmcps.com/api/badge/mcp-server-122?style=directory" alt="MCP Server on AllMCPs" /></a>