drophost
drophost MCP
- 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.