Beecargo

Get set up

  • ○Sign in
  • ○Connect your agent
  • ○Share a file

API

OverviewUpload a fileRemote uploadShare settingsClaim a fileAgent APIWebhooksRetrieve a fileGet file infoList files & foldersDelete a file

MCP

OverviewRegister an agentUpload a fileUpload statusRemote uploadLarge uploads & jobsFoldersShare settingsClaim fileSearch toolsCreate checkoutRetrieve a fileGet file infoList filesDelete a fileFiles from a runUpload delegation
PricingDashboard

Buy a priced share

Pay for a one-time priced share through MCP, then unlock a machine download.

When beecargo_get_download_url returns payment required (HTTP 402), call beecargo_purchase_checkout, send checkoutUrl to the human, then beecargo_purchase_claim with sessionId, then retry download with purchaseToken. This is not Premium billing (beecargo_create_checkout). Humans can also pay on /d/{shortId}.

Authentication

No API key required. An optional key associates the buyer account when present. Share owners cannot buy their own share.

Tools

beecargo_purchase_checkout

beecargo_purchase_checkout

Mint a Stripe Checkout URL for a priced share.

ParameterTypeRequiredDescription
shortIdStringNo*Share shortId from /d/{shortId}
fileIdStringNo*Priced file id when known
bundleIdStringNo*Priced bundle/shipment id when known
  • Pass at least one of shortId, fileId, or bundleId.
  • Save sessionId from the response for beecargo_purchase_claim after the human pays.

beecargo_purchase_claim

beecargo_purchase_claim

Exchange a paid Checkout session for a purchaseToken.

ParameterTypeRequiredDescription
sessionIdStringYesStripe Checkout session id (cs_…) from purchase checkout or ?purchase= on the share success URL
  • Pass purchaseToken to beecargo_get_download_url. Also pass unlock credentials when unlockRequired is true.