Skip to content

drophost

drophost MCP

drophost MCP lets Claude or ChatGPT upload a file or static site and return a public drophost URL.Humans connect with the MCP URL only (Clerk OAuth browser login). Agents and CI send Authorization: Bearer dh_…. Recipients open a normal browser link. Guided setup: /mcp.Agent publishes. User gets a live URL.
  • OAuth URL-only or Bearer dh_… at /api/mcp
  • Same plan limits as the dashboard
  • MCP publish included on Free, Starter, and Pro

Endpoint and auth

MCP URL: https://drophost.space/api/mcp. OAuth (recommended for humans): URL-only config; client discovers /.well-known/oauth-protected-resource/api/mcp and completes Clerk login (PKCE; enable CIMD and DCR in the Clerk Dashboard for Claude/ChatGPT). API keys: Authorization: Bearer dh_… from Settings → Agent publish. Invalid tokens return 401 with WWW-Authenticate resource_metadata for discovery. HTTP /api/v1 remains API-key only.

mcp.json (OAuth)

{
  "mcpServers": {
    "drophost": {
      "url": "https://drophost.space/api/mcp"
    }
  }
}

Tools

publish_file uploads one document or image (filename + content_base64) and returns its public URL. publish_site hosts HTML or a zip with index.html. list_projects returns id, name, slug, and url. Pass project_id to publish into an existing project so the URL stays the same. delete_file removes one file. delete_project removes the project and its live URL. MCP oneshot uploads max out at 4 MB; larger files should use the dashboard or POST /api/v1/publish.

Example prompt

Publish ./proposal.pdf

What the agent should reply

After a successful publish, the agent should lead with the live URL and project name. Do not paste file contents into chat. Recipients do not need Claude, ChatGPT, or a drophost account — they just open the link.

MCP endpoint and auth

drophost exposes MCP at /api/mcp. Humans authenticate with URL-only OAuth (Clerk browser login; protected-resource metadata at /.well-known/oauth-protected-resource/api/mcp). Agents and CI send Authorization: Bearer dh_… from a hashed Settings key. Tools: publish_file, publish_site, list_projects, delete_file, delete_project. MCP oneshot uploads max at 4 MB; larger payloads use POST /api/v1/publish (API key only).

How MCP publishes count against plans

On drophost, Free allows one project and 2 MB. Starter at €5/mo or €50/yr raises limits to 8 projects and 100 MB with passwords and custom domains. Pro at €12/mo reaches 30 projects and 500 MB. Use the HTTP API when payloads exceed the 4 MB oneshot cap.

Common questions

What is the drophost MCP URL?

https://drophost.space/api/mcp. Send Authorization: Bearer with an API key from Settings → Agent publish.

Which MCP tools does drophost expose?

drophost MCP exposes publish_file, publish_site, list_projects, delete_file, and delete_project. After a successful publish, the agent should reply with the live URL first. Plan limits still apply.

Can I use Claude or ChatGPT with drophost?

Yes. Connect drophost MCP in Settings, paste the config into Claude or ChatGPT, then ask the agent to publish. Recipients just open the link.

Do I need MCP to use drophost?

No. MCP is optional. Drag-and-drop still works.

Related

Ready to publish?

Drop a file on the homepage and get a live drophost URL in seconds.