Deploy and Host html-hoster on Railway

html-hoster is a lightweight REST API server that lets you publish static HTML pages programmatically. Send HTML via curl or an AI agent, get back a public URL — no CMS, no dashboard, no deploy pipeline needed.

About Hosting html-hoster

html-hoster runs as a single Bun HTTP server exposing REST endpoints and a native MCP server for AI agent integration. This template deploys the full stack automatically: the Bun server is provisioned via the included nixpacks.toml, storage is pre-configured, and your public URL is set to the Railway-generated domain. The only thing you choose is your API_KEY — the secret token that protects all write operations. Once deployed, pages are served publicly at / with no authentication required.

Common Use Cases

• AI agent publishing — connect Claude, Cursor, or any MCP-compatible agent to publish HTML reports, dashboards, or generated pages directly from a prompt
• Programmatic landing pages — deploy marketing pages or campaign content via API from CI/CD pipelines or backend services
• HTML snippet hosting — expose lightweight static content (changelogs, status pages, embeds) without managing a CMS or object storage CDN config

Dependencies for html-hoster Hosting

• Bun runtime — provisioned automatically; no manual install needed
• Local filesystem storage — pages are stored on the Railway volume, pre-configured by the template

Deployment Dependencies

• Bun — JavaScript/TypeScript runtime
• mcp-remote — bridge for connecting AI agents to the MCP endpoint (client-side only, not deployed)

Implementation Details

After deploy, connect any MCP-compatible AI agent to your instance at https://your-app.up.railway.app/mcp:

{
  "mcpServers": {
    "html-hoster": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://your-app.up.railway.app/mcp", "--header", "Authorization:${HTML_HOSTER_AUTH}"],
      "env": { "HTML_HOSTER_AUTH": "Bearer your-api-key" }
    }
  }
}

Why Deploy html-hoster on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying html-hoster on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.