host-html

io.github.phanoshPublished by GitHub account phanoshv0.2.1Updated Nov 11, 2026

Publish AI-generated HTML as a shareable link, and update it in place at the same URL.

The publisher's own server: Host.al: .al domains and servers in Albania

VerifiedStreamable HTTPWeb executableProductivity & WorkflowFiles & Storage

Overview

AI-generated overview

Publishes AI-generated HTML as a public link and updates that same link in place, so reports, dashboards or decks can be shared.

What you can do
  • Publish a self-contained HTML document and receive a public URL
  • Replace the HTML of a page you already published while keeping the same link
  • Read back page metadata such as the URL, page ID and expiry timestamp
When to use it
Useful when an assistant produces an HTML report, dashboard, deck, prototype or one-page site and the user wants a link they can open and share instead of a local file. Also suited to iterating on a published page without breaking links already sent out.
Requirements
A free, email-verified host-html account and a personal API key (hh_...) set as HOSTHTML_API_KEY, or sent as an Authorization bearer token for the remote endpoint. Runs as a local npm package via npx or as a remote streamable HTTP endpoint; network access required.
Before you install
The API key is a secret and is shown only once; keep it out of shared configs. Published pages are public by default, so anything in the HTML is exposed to anyone with the link. Free-plan pages expire after 3 days; permanent hosting, custom slugs and password protection require a paid plan. Only pages owned by the same account can be updated.

Installation

In SourceWeft

  1. Open host-html in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.phanosh%2Fhost-html/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "host-html": {
      "type": "http",
      "url": "https://suifgsvtcbrawzdhyuhk.supabase.co/functions/v1/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

host-html

[host-html.com]

Publish any HTML file as a live link — instantly. Free account required. No deploy pipeline, no server to manage. → 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)

jsonc
// 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)

bash
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:

    bash
    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:

bash
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):

bash
curl -X POST https://suifgsvtcbrawzdhyuhk.supabase.co/functions/v1/publish \  -H "Authorization: Bearer $HOSTHTML_API_KEY" \  -H "Content-Type: application/json" \  -d '{"html": "<h1>Hello</h1>", "title": "my page"}'

Request

FieldTypeRequiredDescription
htmlstring✓HTML content (max 1MB)
titlestringPage title
slugstringCustom URL path matching ^[a-z0-9-]{2,64}$ (paid plans)
passwordstringPassword-protect the page (4–72 chars, paid plans, JSON body only)

Response 201

json
{  "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

Source: README.md at commit 121b8cc

Tools

2

publish_html

Publish HTML as a hosted link

Publish a self-contained HTML document and get back a public URL. Use this whenever the user wants to share, send, or host HTML you produced — a report, dashboard, deck, prototype or one-page site — instead of leaving it as a file they cannot open. The HTML must be self-contained: inline the CSS and JS, or reference them by absolute URL.

Parametershtmlrequiredslugtitlepassword

update_page

Update a published page in place

Replace the HTML of a page you already published, keeping the SAME link. Use this for every revision — a fix, a new draft, refreshed numbers — instead of publishing a new page, so a link the user already shared keeps working. Only pages owned by the same account can be updated.

Parametershtmlrequiredslugrequired

Version history

1
  1. v0.2.1LatestNov 11, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Host integrations