jcaiagent7143-ui / sendpage-mcp

SendPage MCP server

Publish an HTML document as a shareable link the recipient can open in one tap — without leaving the conversation that wrote it.

Endpoint: https://sendpageapp.com/mcp · Transport: Streamable HTTP (stateless) · Auth: bearer API key, free, no signup

---

Why

An HTML file is a set of drawing instructions, not a document. Sent as an attachment it arrives as raw source, gets stripped by corporate mail filters as a known phishing vector, or simply will not open on a phone — which is where most people read first. Printing to PDF loses interactive charts and quietly cuts the right-hand columns off wide tables, which is the failure worth fearing: nobody notices until a client asks about a figure that is not in the document.

A link avoids all of it. The recipient taps once and reads the page as designed, on whatever device they have.

Connect it

Generate a free key at https://sendpageapp.com/docs/mcp, then:

claude mcp add --transport http sendpage https://sendpageapp.com/mcp \
  --header "Authorization: Bearer sp_live_..."

Or by hand, in .mcp.json:

{
  "mcpServers": {
    "sendpage": {
      "type": "http",
      "url": "https://sendpageapp.com/mcp",
      "headers": { "Authorization": "Bearer sp_live_..." }
    }
  }
}

Tools

Tool	What it does
publish_document	HTML in, share link out. Returns the link, the document id and an edit token — plus a warning naming any images that would fail to load.
update_document	Replace the contents or title. The link does not change, so a typo found after sending costs a correction rather than a second URL.
list_documents	Documents published with this key, with links and view counts.

The missing-image warning

AI tools emit a page plus an images/ folder, and people paste only the HTML — so the images 404 and every reader sees broken icons. publish_document returns the offending files by name, so they can be inlined as data URIs and the document updated before the link is handed over. This is the single most common way a published page is quietly wrong.

The Skill

skills/sendpage/SKILL.md teaches Claude when to offer a link, how to repair a document whose images would not load, and to update an existing document rather than publish a second one.

mkdir -p ~/.claude/skills/sendpage
curl -o ~/.claude/skills/sendpage/SKILL.md \
  https://sendpageapp.com/skills/sendpage/SKILL.md

Limits

• Free: 5 documents a month, each with a small "Made with SendPage" footer. Pro removes both.
• 2 MB per document, inlined images included.
• Links are unlisted, not secret. Anyone with the URL can read the document, and robots.txt keeps them out of search results. Password protection exists for anything confidential, and it gates the exports and the preview thumbnail too — not just the page.
• The API key is stored only as a hash. It is shown once when generated and cannot be recovered; if you lose it, revoke it and generate another.

Notes on the transport

Stateless Streamable HTTP: a single POST returns one JSON body, and GET answers 405 to decline the optional server-initiated SSE stream. Sessions are never created, so any instance can serve any request — which is what makes the server hostable on a serverless runtime, where a long-lived SSE connection would be killed by the execution limit rather than by anything the client did.

Without a key the endpoint answers 401 with a WWW-Authenticate header — that is a missing credential, not a broken server.

Issues

This repository holds the connection metadata and the Skill. For problems with the server itself, open an issue here.

---

Use it in DeepSeek Harness (dsh)

This repo is also a DeepSeek Harness bundle — install it and SendPage's tools mount straight into dsh, with no manual MCP config:

dsh plugin --profile web add https://github.com/jcaiagent7143-ui/sendpage-mcp

Then set your free key (get one at https://sendpageapp.com/docs/mcp) so publishing and exporting work — in the environment, or in $DSH_HOME/.credentials.yaml:

SENDPAGE_API_KEY: <your key>

The tools appear under the sendpage namespace — mcp__sendpage__publish_document, mcp__sendpage__export_document (png/pdf/docx), and the rest. Prefer to wire the raw endpoint yourself? It's https://sendpageapp.com/mcp (Streamable HTTP).