MCP server

Share HTML exposes a Model Context Protocol server with five tools - publish_page, get_page, update_page, delete_page, and list_pages. Each tool maps one-to-one onto a REST API operation, so clients that don't speak MCP can reach the same surface over HTTP. Clients namespace tools by server, so the names carry no share_html_ prefix.

Two transports are supported:

Connect over streamable HTTP#

Claude Code supports the streamable-HTTP transport natively. Add the server with a single command:

claude mcp add --transport http share-html https://mcp.share-html.com/mcp

The endpoint accepts GET, POST, and DELETE requests and follows the streamable-HTTP transport defined by the MCP specification.

Connect through the stdio bridge#

The @share-html/mcp package wraps the hosted endpoint and exposes it over stdio. Install on demand with npx; no global install is required.

Claude Code#

claude mcp add share-html npx -- -y @share-html/mcp

Cursor#

Add the following to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "share-html": {
      "command": "npx",
      "args": ["-y", "@share-html/mcp"]
    }
  }
}

Claude Desktop, Codex, and other stdio clients#

Any client that launches an MCP server as a stdio subprocess works with the same invocation. The command is npx -y @share-html/mcp; the package takes no additional flags.

Configure the bridge#

The bridge requires SHARE_HTML_API_KEY. Without it the bridge prints a setup error and exits.

{
  "mcpServers": {
    "share-html": {
      "command": "npx",
      "args": ["-y", "@share-html/mcp"],
      "env": { "SHARE_HTML_API_KEY": "sh_live_…" }
    }
  }
}

Authentication#

The hosted endpoint is not anonymous. There are two ways to authenticate:

OAuth 2.1 (browser-capable clients)#

Claude Code and any other MCP client that speaks the streamable-HTTP transport with OAuth handles the flow automatically. On first call, a browser tab opens for consent; on approval, the client stores an access token and refresh token. Subsequent calls send Authorization: Bearer <access_token> and the OAuth provider validates against OAUTH_KV.

To manage active grants, sign in at share-html.com/app/connections and revoke any client. The next call from that client will trigger a fresh OAuth flow.

Authorization: Bearer sh_live_… (stdio bridge)#

The stdio bridge (@share-html/mcp) wraps streamable HTTP for clients that only speak stdio (Cursor, Claude Desktop, Codex). It sends Authorization: Bearer ${SHARE_HTML_API_KEY} on every request. The MCP Worker's dual-accept shim recognizes sh_live_<48 hex> tokens, bcrypt-verifies against the api_keys table, and dispatches to the MCP agent with the user's identity.

Create an API key at share-html.com/app/keys.

No credentials are passed in tool arguments. The hosted endpoint rejects any request without a valid bearer token (401 invalid_token).

Publish HTML#

Publishes an HTML document and returns its public URL. Maps to POST /api/v1/pages.

{
  "url": "https://pages.share-html.com/launch-notes",
  "slug": "launch-notes"
}

Update a page#

Updates one or more fields on a page you own - HTML, TTL, password, or visibility. Maps to PATCH /api/v1/pages/{slug}. At least one mutable field is required.

{
  "url": "https://pages.share-html.com/launch-notes",
  "slug": "launch-notes"
}

Delete a page#

Permanently deletes a page you own. The URL returns 404 immediately after this call; there is no soft-delete or restore window. Maps to DELETE /api/v1/pages/{slug}.

{ "ok": true }

Read page metadata#

Returns non-secret metadata for a published page. Maps to GET /api/v1/pages/{slug}. Read-only; no authentication required.

{
  "slug": "launch-notes",
  "url": "https://pages.share-html.com/launch-notes",
  "title": "Launch notes",
  "owner": "user",
  "size_bytes": 4217,
  "has_password": false,
  "discoverable": false,
  "view_count": 132,
  "expires_at": null,
  "created_at": "2026-05-12T09:31:00.000Z",
  "updated_at": "2026-05-19T14:02:00.000Z"
}

List my pages#

Lists pages owned by the authenticated user. Maps to GET /api/v1/me/pages.

{
  "data": [
    {
      "slug": "launch-notes",
      "url": "https://pages.share-html.com/launch-notes",
      "title": "Launch notes",
      "owner": "user",
      "size_bytes": 4217,
      "has_password": false,
      "discoverable": false,
      "view_count": 132,
      "expires_at": null,
      "created_at": "2026-05-12T09:31:00.000Z",
      "updated_at": "2026-05-19T14:02:00.000Z"
    }
  ],
  "pagination": {
    "limit": 20,
    "offset": 0,
    "total": 47,
    "has_more": true,
    "next_offset": 20
  }
}

Discovery#

• Server descriptor - /.well-known/mcp
• Equivalent REST schema - /api/openapi.json
• Marketing page - /mcp