@htmldrop.app/mcp

Model Context Protocol server for htmldrop — publish HTML or Markdown to a real hosted URL straight from Claude Desktop, Claude Code, Cursor, or any MCP-aware client.

Quick start

1. Create an API token. Sign in at htmldrop.app/dashboard/settings → API tokens → Create token. Copy the hsk_live_… value — it's shown only once.

2. Add to your MCP client config. For Claude Desktop edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

   {
     "mcpServers": {
       "htmldrop": {
         "command": "npx",
         "args": ["-y", "@htmldrop.app/mcp"],
         "env": {
           "HTMLDROP_API_TOKEN": "hsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
         }
       }
     }
   }

   For Claude Code: add the same block under mcpServers in ~/.config/claude-code/config.json (or wherever your Claude Code MCP config lives).

   For Cursor: Settings → MCP → Add server with command npx, args ["-y", "@htmldrop.app/mcp"], env HTMLDROP_API_TOKEN.

3. Restart your MCP client. It will fetch and launch the server on first use.

4. Ask the model. Try: "Make a single-page HTML CV for Alex Rivera and publish it to htmldrop." The model will call htmldrop_publish and reply with the public URL.

Tools

| Tool | What it does | |---|---| | htmldrop_publish | Publish an HTML or Markdown document. Returns the public share URL, site id, and slug. Accepts an optional slug and title. | | htmldrop_list | List every site the authenticated tenant owns. | | htmldrop_delete | Delete a site by id. |

Configuration

| Env var | Default | Purpose | |---|---|---| | HTMLDROP_API_TOKEN | (required) | The hsk_live_… token minted in your dashboard. | | HTMLDROP_API_URL | https://htmldrop.app/api/v1 | Override for staging or self-hosted htmldrop instances. |

Plan limits

The MCP server hits the same API your dashboard does, so all plan caps apply:

• Free: 3 active drops, 30-day TTL.
• Starter ($5/mo): 10 drops, no TTL, 1 custom domain.
• Pro ($12/mo): 25 drops, 3 custom domains.
• Business ($39/mo): 100 drops, 10 custom domains.

When you hit a cap the tool call returns a clear error (plan_limit) that the model surfaces in chat — no silent failure.

Security notes

• Tokens carry full tenant privileges. Keep them out of source control.
• Revoke a token from Settings → API tokens; the revoke is effective immediately.
• The server runs on your machine over stdio. No traffic flows through htmldrop other than the API calls the tool makes on your behalf.

License

MIT — © Middle East Software Solutions Limited