dochost MCP server

Publish Markdown or HTML to a clean, shareable link — straight from your AI assistant. The dochost MCP server gives Claude, ChatGPT, Cursor and any other MCP client a publish tool: ask your assistant to share a document and it hands back a public dochost link. No copy-paste, no separate dashboard.

🌐 Website: https://dochost.io
🔌 MCP server: https://dochost.io/mcp
🛰️ Endpoint: https://dochost.io/api/mcp (Streamable HTTP, OAuth)
🔑 Auth: OAuth sign-in — no API keys

Why

Your LLM produced a report, a README, an HTML artifact. Sending it shouldn't mean a screenshot or a raw .md blob. dochost turns that output into a normal web page at its own URL, in one tool call. Markdown and HTML are rendered live.

Quick start

Claude Code (one line):

claude mcp add --transport http dochost https://dochost.io/api/mcp

Then run /mcp inside Claude Code and approve in the browser. Add --scope user to use it in every project.

Claude Desktop / Cursor / VS Code / Windsurf — add a remote HTTP server:

{
  "mcpServers": {
    "dochost": {
      "type": "http",
      "url": "https://dochost.io/api/mcp"
    }
  }
}

You authorize once via OAuth in the browser; the assistant then publishes as you, and output follows your dochost plan's entitlements.

Which auth method?

| Client | Recommended auth | Why | |---|---|---| | OpenClaw, Hermes | API key | Headless agents (e.g. a Telegram orchestrator). A static Bearer key works with the plain-HTTP skill and any MCP runner, with no browser step per session. | | Claude, Cursor, ChatGPT, VS Code, Windsurf, and all other MCP clients | OAuth | One browser approval, nothing long-lived stored in config; the assistant publishes as you. |

Keep the API key like any secret: store it as an environment variable / host secret (never commit it), and revoke or rotate it from Settings → API keys if it leaks.

Agents (OpenClaw, Hermes) — API key

OpenClaw and Hermes are headless, so they authenticate with an API key. Create one at dochost.io → Settings → API keys, export it as DOCHOST_API_KEY, and either:

Install the skill — a self-contained publish skill that works on any agent that can make an HTTP request: skills/dochost-publish/.
Wire the MCP — point the agent at https://dochost.io/api/mcp with the key as a Bearer header: examples/mcporter.config.json.

Per-host install guides:

OpenClaw → clients/openclaw.md
Hermes → clients/hermes.md

One-shot from a shell: examples/publish.sh.

Tools

`publish`

Publish Markdown or HTML as a hosted page and get a shareable URL.

| Parameter | Type | Notes | |---|---|---| | body | string (required) | The Markdown or HTML content to publish. | | format | "markdown" | "html" | Auto-detected when omitted. | | public | boolean | List on Explore. Defaults to false (unlisted). | | customSlug | string · Pro | Choose the link path instead of a random slug. | | password | string · Pro | Gate the page behind a password. | | noBranding | boolean · Pro | Hide the dochost footer badge. |

Returns url, slug, expiresAt, and an editToken.

Example: "Publish my Q3 report as a private page with a password." → dochost.io/d/q3-report (password-gated, 7-day link on free).

`list_my_pages`

List the pages you have published, newest first (paginated).

Notes

Ownership and entitlements come from your authenticated account, never from tool input.
Free links last 7 days; permanent links, password, custom slug, custom subdomain and branding removal are on the paid plans — see dochost.io.

License

MIT — see LICENSE.

MCP Servers