host-html

host-html

Publish any HTML file as a live link — instantly.

Free account required. No deploy pipeline, no server to manage.

→ [host-html.com](https://host-html.com)

Heads up — breaking change in v2.0.0: Anonymous publishing has been

retired. Publishing now requires a free, email-verified host-html account

and a personal API key set as HOSTHTML_API_KEY. See

Setup: get an API key. Older releases that relied

on the built-in shared key will stop publishing.

Install

Claude Code

/plugin marketplace add phanosh/host-html

/plugin install host-html@host-html

The official Claude Code marketplace listing is in the works — until it lands, install directly from this repo with the two commands above.

Claude Desktop, Cursor, Codex (MCP server)

// claude_desktop_config.json / .cursor/mcp.json / .mcp.json

{ "mcpServers": { "host-html": { "command": "npx", "args": ["-y", "host-html-mcp"], "env": { "HOSTHTML_API_KEY": "hh_your_key_here" } } } }

Two tools: `publish_html` (HTML in, link out) and `update_page` (new HTML, **same link**).

Source and docs: mcp-server/ · npm: host-html-mcp

Other AI Agents (Skills)

npx skills add phanosh/host-html -g -y

Then use the skills:

/host-html          # publish HTML as a live link

/host-pdf # export HTML slides to PDF

/host-html finds the HTML, publishes it, and hands you a live URL in seconds. /host-pdf captures each slide at retina quality and assembles a PDF.

Works with Claude Code, Cursor, Codex, Copilot, and 40+ more agents.

Setup: get an API key

Publishing now requires a free host-html account:

1. Sign in (free) at host-html.com
2. Confirm your email
3. Go to Account → API keys → Create key
4. Copy the generated key (starts with hh_… — shown once)
5. Set it as an environment variable:

   export HOSTHTML_API_KEY=hh_your_key_here

The skill reads HOSTHTML_API_KEY automatically. Custom slugs (see the Direct API table below) still require a Pro/Team plan; publishing itself does not.

Update

When a new version is released here, pull it into your local Claude Code with:

/plugin marketplace update phanosh/host-html

That single command refreshes the marketplace catalog and installs any version bumps in marketplace.json, plugin.json, or the skill frontmatter. To check what you're on:

/plugin

To stay current automatically, open /plugin, go to the Marketplaces tab, select phanosh/host-html, and toggle auto-update on — Claude Code will then pull updates on startup.

For the standalone skills install (npx skills add ...), re-run the same command to upgrade:

npx skills add phanosh/host-html -g -y

Direct API

The publish edge function requires a personal host-html API key (format hh_…) as the bearer token — see Setup to generate one. Pass it via the Authorization header (no apikey header is needed):

curl -X POST https://suifgsvtcbrawzdhyuhk.supabase.co/functions/v1/publish \

-H "Authorization: Bearer $HOSTHTML_API_KEY" \ -H "Content-Type: application/json" \ -d '{"html": " Hello ", "title": "my page"}'

Request

Response `201`

{

"url": "https://host-html.com/p/abc123", "slug": "abc123", "edit_token": "...", "page_id": "...", "has_password": false, "expires_at": "2026-03-16T..." }

has_password is true when the request set a password (the page is locked and served from private storage); false otherwise.

expires_at is string | null. On a free plan it is the ISO timestamp when the page goes dark; on a paid plan the page never expires and the field is null. It is the authoritative expiry — read it from the response rather than assuming a fixed duration, and handle the null rather than formatting it as a date.

License

MIT