pages-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@pages-mcpDeploy a static site with an index.html containing 'Hello World'."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
pages-mcp
A tiny static-site host with an MCP upload tool. Claude (or any MCP client) uploads static sites/artifacts; they're served over HTTPS at an internal hostname.
Serve:
https://pages.internal.white.fm/<site>/(open on the tailnet)Upload (MCP):
https://pages-mcp.internal.white.fm/mcp—Authorization: Bearer <MCP_TOKEN>Storage: files persist under
SITES_DIR(default/data/sites), one dir per site.
A <base href="/<site>/"> is injected into served HTML (when absent) so relative-path
multi-file sites work under the path prefix, not just self-contained single files.
MCP tools
Tool | Purpose |
| Upload a site. |
| All sites with URL, file count, size, last-modified. |
| One site's stats + the list of file paths. |
| Remove a site and all its files. |
/healthz is open (used by k8s probes). Site names are lowercase DNS labels
(a-z, 0-9, -), 1–63 chars.
Related MCP server: Torreable
Env
Var | Default | Notes |
| (empty) | Bearer token for the control plane. Empty = auth disabled (don't run that way). |
|
| |
|
| Persistent storage root. |
|
| Content host (Host header → serving plane). |
|
| Control host (Host header → |
|
| Base used in returned URLs. |
|
| Per-site upload cap. |
Build
GitHub Actions (.github/workflows/build.yml) builds ghcr.io/robertdwhite/pages-mcp
(linux/amd64) on push to main / v* tags. Pin the resulting digest in the cluster
repo at apps/ai/pages/kustomization.yaml.
Register with Claude Code
# Token from the k8s secret:
sops -d apps/ai/pages/11-secret.sops.yaml | grep MCP_TOKEN
claude mcp add --transport http pages \
https://pages-mcp.internal.white.fm/mcp \
--header "Authorization: Bearer <MCP_TOKEN>"This server cannot be deployed
Maintenance
Related MCP Connectors
Publish HTML, Markdown, and multi-file sites as shareable URLs instantly via MCP.
Hosted MCP for creating, checking, deploying, and hosting static sites for AI agents.
Deploy HTML from any agent: POST markup, get a live URL. Static hosting API with MCP tools.
Deploy HTML or dist/ to a live HTTPS URL. No account. Drop, MCP, or CLI.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to edit and serve a static website via natural language, providing file management tools over MCP and HTTP hosting.-
- AlicenseNot gradedqualityCmaintenancePublish static websites as Tor hidden services (.onion sites) via MCP.2MIT
- FlicenseNot gradedqualityCmaintenanceEnables publishing, updating, and sharing HTML artifacts with strict security isolation (origin separation, CSP, API keys) via MCP tools.1-
- AlicenseAqualityBmaintenanceEnables publishing sanitized static HTML pages from an MCP agent and receiving shareable URLs, with tools for updating, listing, publishing, and deleting pages.125 npmMIT