Choose how to send, manage, share, or download a file.
Use the website, API, MCP, or CLI. They work with the same files and share links.
Use the API for direct HTTP integration, MCP for tool-capable agents, the CLI for local scripts, and the website for interactive sharing.
Endpoint
Authentication
Create an API key in dashboard settings. Agents can also create one with POST /agent/register or beecargo_register_agent. Send the key as:
Without a key: 1 GB per file and 1 GB of active storage; files expire after 3 days. Free: 5 GB per file and 10 GB total; files expire after 7 days. Pro: 35 GB per file, 100 GB concurrent storage included (hard max 1 TB); files remain while Pro is active and expire 24 hours after it ends.
Usage notes
Idempotency-Key header on write requests you may retry. Same key and same body return the first result. Same key with a different body fails. MCP write tools accept optional idempotencyKey.Tool
Authentication
For a fast one-shot handoff, connect to https://mcp.beecargo.net/mcp/guest with no headers (rate-limited, typically under 30 seconds to a share link). For lasting access, call beecargo_register_agent, or send an existing API key as Authorization: Bearer bc_… or x-beecargo-api-key. Keep the key secret.
Use Add to Cursor or Add to Grok Bot, or add https://mcp.beecargo.net/mcp with no headers in Claude, OpenCode, or Codex. Complete Connect with Beecargo in the browser. The client sends the OAuth access token for you. Clients without OAuth can still use an API key.
Usage notes
beecargo_upload with a public URL, a small inline file, or (local MCP only) a file path up to your tier limit.beecargo_upload with a public URL or a small inline file. Return https://beecargo.net/d/{shortId} as soon as the upload responds — do not wait for the safety check before handing the link to a human. To protect the link, call beecargo_update_share_settings and share the unlock details privately. Anonymous uploads also return tokens to claim or delete the file.https://mcp.beecargo.net/mcp/guest with no headers, then beecargo_upload with a public url. OAuth-capable clients can use /mcp to sign in. Call beecargo_register_agent only when you need owned storage, list, or claim.beecargo_register_agent succeeds, this session keeps the API key so beecargo_list_files and beecargo_claim_file work without pasting the key again.https://mcp.beecargo.net/mcp. That is the supported way to connect.Command
Authentication
Pass --key, set BEECARGO_API_KEY, or run register --save. Anonymous uploads work without a key.
Usage notes
npx --yes github:Beecargo/cli (or npm i -g @beecargo/cli when the npm package is published).--json on publish commands for a machine-readable share receipt.The website auto-publishes one lasting /d/{shortId} share link for the upload session when the first file passes the safety check. REST, MCP, and CLI upload calls each create a share link for one file.
Claim an anonymous upload, keep files in folders, list your library, or delete a file with its owner key or deletion token.
Choose unlisted or public visibility, retention, direct download, and optional unlock protection with a private delivery link.
Recipients open the share link (/d/{shortId}) or a protected delivery link. APIs can request a signed download URL.
Agents can connect to MCP, create a key, send a file, and return its share link.