English Français العربية

Beecargo

Registre officiel Archivé IA et agents

Publish a file from an agent and get a durable beecargo.net/d/{shortId} share link.

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http beecargo 'https://mcp.beecargo.net/mcp'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "beecargo": {
            "type": "http",
            "url": "https://mcp.beecargo.net/mcp"
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. Beecargo MCP
  2. Fastest path (agents)
  3. Tools
  4. Stdio (local)
  5. HTTP (hosted)
  6. Official MCP Registry
  7. CLI (local scripts)
  8. Parity with lomi MCP
  9. Publish

Beecargo MCP

Model Context Protocol server for the Beecargo file hosting API.

Portable marketplace packaging (Agent Plugins 1.0 + Cursor manifest) lives in ../agent-plugin.

Fastest path (agents)

Publish a durable share link with no human dashboard login:

  1. Add hosted MCP with no headers: https://mcp.beecargo.net/mcp (full tools; see examples/cursor-http.mcp.json). If /mcp requires auth, use https://mcp.beecargo.net/mcp/guest for bootstrap-only tools.
  2. Call beecargo_register_agent → solves a short PoW, returns bootstrap bc_* (10GB / 100rpm; session adopts the key).
  3. Call beecargo_upload with a public HTTPS url → hand off https://beecargo.net/d/{shortId} (always the full share URL). Multi-file handoff: openShare: true on the first file, then shareShortId on later uploads (same link, one unlock).
  4. Optional: beecargo_update_share_settings with protect: true (+ handoffMessage) on fileId or Shipment shortId → return unlockCode and handoffUrl (/h/…) on a private channel.

For production agents (100GB included concurrent storage / 1000rpm / high remote/hr): mint a Pro-tier key via dashboard POST /api-keys/agent (Pro required) or operator POST /agent/api-keys.

Skip registration for ephemeral uploads: beecargo_upload works anonymously (stricter limits; save deletionToken).

Tools

ToolAuthDescription
beecargo_register_agentNoneSelf-mint bootstrap bc_* (PoW + rate-limited)
beecargo_uploadOptionalURL, small base64, or local path (stdio); openShare / shareShortId for growable multi-file shares
beecargo_upload_statusOptionalPoll async URL upload jobs
beecargo_create_checkoutNoneMint Premium Stripe checkout (recommended: 2-day trial then weekly)
beecargo_purchase_checkoutOptionalMint pay link for a priced share (shortId / fileId / bundleId)
beecargo_purchase_claimNoneAfter pay: sessionId → purchaseToken for beecargo_get_download_url
beecargo_claim_fileAPI keyClaim anonymous upload with claimToken
beecargo_search_toolsNoneKeyword search over tools
beecargo_update_share_settingsAPI keyVisibility, priceCents / currency, direct, retention, protect / handoffMessage (fileId or shortId)
beecargo_connectDashboard key / OAuthSeller Stripe Connect (action: status \onboard \login)
beecargo_foldersAPI keyCreate or list folders (action: create \list)
beecargo_get_download_urlNoneSigned download URL (unlockCode / unlockToken / handoffToken / purchaseToken when needed)
beecargo_file_infoOptionalMetadata by short codes (unlockRequired)
beecargo_list_filesRequiredList owned files (includeFolders; optional runId for pipeline manifests)
beecargo_delete_fileKey or deletion tokenDelete file
Advanced
ToolAuthDescription
beecargo_create_upload_delegationAPI keyMint a short-lived uploadUrl + delegationToken for a worker that must not hold bc_*. Prefer beecargo_upload for normal agent uploads.

Detailed guides: upload, upload status, run artifacts, upload delegation, folders, share settings, seller payouts, and buy a priced share.

Stdio (local)

cd apps/mcp && pnpm build && pnpm start

Optional: BEECARGO_API_KEY=bc_… in env. After beecargo_register_agent, the stdio session adopts the new key automatically.

See examples/cursor-stdio.mcp.json.

HTTP (hosted)

https://mcp.beecargo.net/mcp (full tools when authenticated). Guest bootstrap: https://mcp.beecargo.net/mcp/guest. See examples/cursor-http.mcp.json.

Existing key: examples/cursor-http-with-key.mcp.json.

Env: see .env.example. Highlights:

  • BEECARGO_API_URL: default https://api.beecargo.net
  • BEECARGO_API_FETCH_TIMEOUT_MS: raise for large sync remotes (default guidance: 300000)
  • BEECARGO_MCP_REQUIRE_AUTH: set true to require transport bearer or bc_* on /mcp (default: open bootstrap, rate-limited)
  • BEECARGO_MCP_BEARER_TOKEN: optional shared transport secret when REQUIRE_AUTH=true
  • BEECARGO_MERCHANT_OAUTH_ENABLED: publish OAuth resource metadata and enable Connect with Beecargo (requires matching INTERNAL_API_KEY on API + MCP)

Official MCP Registry

server.json is the Official MCP Registry manifest for io.github.Beecargo/mcp (schema 2025-12-11). The hosted remote is https://mcp.beecargo.net/mcp. Discovery copies also live at /.well-known/mcp/server.json on this host and on https://beecargo.net.

This file does not mean the server is already listed in the registry.

CLI (local scripts)

Use the dedicated package @beecargo/cli:

npx --yes github:Beecargo/cli upload ./artifact.zip --json
npx --yes github:Beecargo/cli remote https://example.com/file.bin --async --json
npx --yes github:Beecargo/cli share FILE_ID --price-cents 500 --key YOUR_BC_KEY
npx --yes github:Beecargo/cli download FILE_ID ./out.bin --purchase-token TOKEN

From the monorepo: pnpm cli upload ./artifact.zip. Publish flags (--ttl, --protect, …) match MCP beecargo_upload. share --price-cents / download --purchase-token match MCP share-settings and retrieve.

pnpm smoke:http   # MCP transport (no API)
BEECARGO_API_URL=http://localhost:3001 pnpm smoke:api   # live upload against API

Parity with lomi MCP

lomiBeecargo
OpenAPI-generated toolsHand-written file tools (smaller surface)
lomi_search_toolsbeecargo_search_tools
Zero-header HTTP connectSame (default); optional BEECARGO_MCP_REQUIRE_AUTH
x-lomi-api-key + OAuthx-beecargo-api-key / Bearer bc_* + anonymous
GET/POST/DELETE /mcpSame
/health, /readySame
Retries + timeout on RESTBEECARGO_API_FETCH_* env
Tool results{ ok, status, body } + share link hints

Publish

Scope is @beecargo. First publish is manual with --otp. After that, set Trusted Publisher on the npm package to GitHub Beecargo/mcp workflow publish.yml. Then bump the patch in package.json and push main.

pnpm typecheck && pnpm publish --access public --otp=XXXXXX

Questions fréquentes

Qu'est-ce que Beecargo ?

Publish a file from an agent and get a durable beecargo.net/d/{shortId} share link.

Comment installer Beecargo ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http beecargo 'https://mcp.beecargo.net/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Beecargo ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

Beecargo est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Beecargo ?

Il est publié par Beecargo. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.