Back to Browse

Mcp MCP Server

Developer ToolsLow Risk10.0MCP RegistryRemote
Free

Server data from the Official MCP Registry

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

About

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

Remote endpoints: streamable-http: https://mcp.beecargo.net/mcp

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (2 strong, 2 medium validity signals). No known CVEs in dependencies. Imported from the Official MCP Registry.

Endpoint verified · Requires authentication · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

How to Connect

Remote Plugin

No local installation needed. Your AI client connects to the remote endpoint directly.

Add this to your MCP configuration to connect:

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

Documentation

View on GitHub

From the project's GitHub README.

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: sessionIdpurchaseToken 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)

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

Reviews

No reviews yet

Be the first to review this server!