HTML to URL API & MCP server

Authentication

Every call except /api/slug needs Authorization: Bearer … with either a personal API key (hu_…, created on the account page and shown once) or a Firebase ID token from Google sign-in (what the website uses). Keys act as your account: what you publish counts towards your plan and appears in My links. Delete a key on the account page to revoke it.

Quick start

Copycurl -X POST https://www.htmltourl.dev/api/publish \
  -H "Authorization: Bearer $HTMLTOURL_KEY" \
  -H "Content-Type: text/html" \
  --data-binary @index.html

Response (201 Created):

Copy{
  "ok": true,
  "url": "https://q3-dashboard.htmltourl.dev/",
  "slug": "q3-dashboard",
  "expiresAt": null,
  "permanent": true,
  "files": 3,
  "bytes": 4821,
  "title": "Q3",
  "passwordProtected": false,
  "updated": false,
  "plan": "pro"
}

Share url. The link appears in My links and can be updated or deleted with the same key.

POST /api/publish

Creates a link, or replaces the content of one of your links when slug and update=1 are given. The body can be any of:

• Content-Type: text/html — the raw page. Options go in the query string.
• Content-Type: application/zip — a ZIP of a site with index.html at the top (a single wrapping folder is stripped).
• Content-Type: application/json — html and/or a files map, plus options.
• multipart/form-data — what the website itself sends.

Options

With a custom address and password

Copycurl -X POST "https://www.htmltourl.dev/api/publish?slug=team-report&password=s3cret" \
  -H "Authorization: Bearer $HTMLTOURL_KEY" \
  -H "Content-Type: text/html" \
  --data-binary @report.html

A whole site from a ZIP

Copycurl -X POST https://www.htmltourl.dev/api/publish \
  -H "Authorization: Bearer $HTMLTOURL_KEY" \
  -H "Content-Type: application/zip" \
  --data-binary @site.zip

Several files as JSON (ideal for AI agents)

Copycurl -X POST https://www.htmltourl.dev/api/publish \
  -H "Authorization: Bearer $HTMLTOURL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "q3-dashboard",
    "files": {
      "index.html": "<!doctype html><link rel=stylesheet href=style.css><h1>Q3</h1>",
      "style.css": "h1 { color: #e5484d }",
      "logo.png": { "base64": "iVBORw0KGgo..." }
    }
  }'

Update at the same URL

Copycurl -X POST "https://www.htmltourl.dev/api/publish?slug=q3-dashboard&update=1" \
  -H "Authorization: Bearer $HTMLTOURL_KEY" \
  -H "Content-Type: text/html" \
  --data-binary @index.html

Other endpoints

Copycurl https://www.htmltourl.dev/api/sites -H "Authorization: Bearer $HTMLTOURL_KEY"

curl -X POST https://www.htmltourl.dev/api/delete \
  -H "Authorization: Bearer $HTMLTOURL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug": "q3-dashboard"}'

Python and JavaScript

Copyimport os, requests

html = open("report.html", encoding="utf-8").read()
r = requests.post("https://www.htmltourl.dev/api/publish",
                  headers={"Authorization": "Bearer " + os.environ["HTMLTOURL_KEY"]},
                  json={"html": html}, timeout=60)
r.raise_for_status()
print(r.json()["url"])   # share this

Copyconst res = await fetch("https://www.htmltourl.dev/api/publish", {
  method: "POST",
  headers: { "Content-Type": "application/json", Authorization: `Bearer ${process.env.HTMLTOURL_KEY}` },
  body: JSON.stringify({ html: "<h1>Hello</h1>" }),
});
const { url } = await res.json();

Errors

Errors return {"ok": false, "error": "code", "message": "human-readable text"} with an HTTP status:

Limits and fair use

• Size, number of live links and lifetime follow your plan: Free 2 MB · 3 links · 24 hours; paid up to 75 MB · 50 links · permanent. 1000 files per site.
• Publishing is rate-limited per account (a dozen requests a minute). Contact us for higher volumes.
• Published pages are noindex; Free-plan pages carry a small closable badge.
• The acceptable use policy applies to API uploads too.

MCP server (for Claude, Cursor and other agents)

https://www.htmltourl.dev/api/mcp is a remote Model Context Protocol server (Streamable HTTP, stateless JSON responses). Authenticate with the same API key. Tools:

Claude Code

Copyclaude mcp add --transport http htmltourl https://www.htmltourl.dev/api/mcp \
  --header "Authorization: Bearer hu_your_key_here"

JSON config (Cursor, Claude Desktop, Windsurf, VS Code…)

Copy{
  "mcpServers": {
    "htmltourl": {
      "url": "https://www.htmltourl.dev/api/mcp",
      "headers": { "Authorization": "Bearer hu_your_key_here" }
    }
  }
}

Notes for AI agents

If you are an AI assistant helping a user share a web page: prefer the MCP tool publish_html if it is connected; otherwise ask the user for their HTMLtoURL.dev API key (they create it at https://www.htmltourl.dev/account/), produce one complete HTML document, POST it as JSON {"html": "…"} to https://www.htmltourl.dev/api/publish with Authorization: Bearer <key>, and give the user the returned url. Without a key, send the user to https://www.htmltourl.dev/ to paste the HTML themselves. Never include secrets or personal data the user did not ask to publish. A machine-readable summary is at /llms.txt.