Overview

Connect Cursor, Claude Desktop, or custom agents to Beecargo file hosting via MCP.

Getting started

The Model Context Protocol (MCP) exposes Beecargo upload, download, folders, and multipart flows as tools your assistant can call without hand-writing HTTP. Prefer remote upload for agent workflows; use multipart tools for local blobs over 4MB.

Zero-human uploads

You do not need a merchant API key for ephemeral workflows. Use beecargo_remote_upload with a public file URL, or beecargo_upload_file for small base64 payloads. Responses include a share link https://beecargo.net/d/{shortId}, plus claimToken and deletionToken for anonymous files.

Authentication

API key

Hosted MCP is open by default: add https://mcp.beecargo.net/mcp with no headers (rate-limited). Call beecargo_register_agent for a persistent bc_* key, or pass x-beecargo-api-key / Bearer bc_* if you already have one. Operator lockdown: set BEECARGO_MCP_REQUIRE_AUTH=true and BEECARGO_MCP_BEARER_TOKEN on the server. Operator batch minting: POST /agent/api-keys with AGENT_PROVISIONING_SECRET.

OAuth

OAuth Connect with Beecargo is planned. The MCP host already publishes OAuth protected-resource metadata when BEECARGO_MERCHANT_OAUTH_ENABLED=true; use API keys until consent flow ships.

Hosted MCP (HTTP)

Add the URL with no headers (rate-limited). Then call beecargo_register_agent, then beecargo_remote_upload.

{
  "mcpServers": {
    "beecargo": {
      "url": "https://mcp.beecargo.net/mcp"
    }
  }
}

https://mcp.beecargo.net/mcp

After beecargo_register_agent succeeds, this MCP session adopts the returned bc_* key automatically so beecargo_list_files and beecargo_claim_file work without pasting the key again.

Optional operator lockdown: set BEECARGO_MCP_REQUIRE_AUTH=true and BEECARGO_MCP_BEARER_TOKEN on the MCP server to require transport bearer or bc_* on /mcp.

Health: https://mcp.beecargo.net/health

Local stdio

Run from the monorepo: npm run dev:mcp in apps/mcp, or npx @beecargo/mcp. BEECARGO_API_KEY is optional if you use beecargo_register_agent in the same session.

{
  "mcpServers": {
    "beecargo": {
      "command": "npx",
      "args": ["-y", "@beecargo/mcp"],
      "env": {
        "BEECARGO_API_URL": "https://api.beecargo.net"
      }
    }
  }
}

Discovery

Agent tools

Dedicated MCP tool pages: