htmldrop turns an HTML or Markdown document into a hosted page with a real,
shareable URL (slug.htmldrop.app, or the user's custom domain on paid
plans). No build step. You are reading the agent version of this page; the
human version is at htmldrop.app.
htmldrop's npm packages are scoped: the MCP server is
@htmldrop.app/mcp and the CLI is @htmldrop.app/cli.
The unscoped npm package named htmldrop is an unrelated
third-party project — do not install it. When in doubt, use the exact
commands below verbatim.
claude mcp add --transport http htmldrop https://htmldrop.app/mcp
Any MCP client: add https://htmldrop.app/mcp as a remote
(streamable HTTP) server. First tool call triggers a browser OAuth sign-in;
tokens are held and refreshed by the client. Tools:
htmldrop_publish (content → live URL),
htmldrop_list, htmldrop_delete.
Connectors cannot be installed from inside a chat; the user adds it once:
Settings → Apps → Advanced → Developer mode, then
Settings → Connectors → Create with URL https://htmldrop.app/mcp
(OAuth with PKCE + dynamic client registration — no keys to paste). From then
on, publishing works by asking in any chat. Without a connector, generate the
HTML and tell the user to drop the file on htmldrop.app.
npx @htmldrop.app/cli deploy # deploys the current directory npx @htmldrop.app/cli login # browser OAuth; needed once
No browser available: create an API token (hsk_live_…) at
/dashboard/settings → API tokens, then:
HTMLDROP_API_TOKEN=$TOKEN npx -y @htmldrop.app/mcp # stdio MCP server
REST API (token as Authorization: Bearer) is documented at
docs.htmldrop.app/api.
curl -F "[email protected]" https://htmldrop.app/api/v1/drops
Returns a share URL. Anonymous drops: max 2 MB, live 7 days, may require a Turnstile token when abuse controls are active — prefer the authenticated paths above for reliability.
| Tier | Drops | Max upload | Lifetime |
|---|---|---|---|
| Anonymous | — | 2 MB | 7 days |
| Free account | 3 | 10 MB | 30 days rolling |
| Plus ($12/mo · $99/yr) | 25 | 100 MB | permanent |
| Business ($49/mo) | 100 | 500 MB | permanent |