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 settingsSeller payoutsBuy a priced shareClaim fileSearch toolsCreate checkoutRetrieve a fileGet file infoList filesDelete a fileFiles from a runUpload delegation
PreviousCreate checkoutNextGet file info
BlogPricingDashboardPrivacyTerms

Retrieve a file

Get a signed download URL by fileId via MCP.

Same flow over HTTP: GET /files/download/:fileId

Tool

beecargo_get_download_url

Returns a temporary signed download URL for the given fileId. When the share is protected, pass unlockCode, unlockToken, or handoffToken. Priced shares also need purchaseToken (or owner auth).

Authentication

No API key required.

Parameters

ParameterTypeRequiredDescription
fileIdStringYesFile id from upload (data.id), not a UUID
unlockCodeStringNo6-character unlock code (needed when unlockRequired is true, unless you pass unlockToken or handoffToken)
unlockTokenStringNoShort-lived token from POST /downloads/unlock after a successful unlock
handoffTokenStringNoSecret from the delivery link /h/{token} (alternative to unlockCode)
purchaseTokenStringNoRequired for priced shares after the human pays on /d/{shortId} (from POST /purchases/claim)

Usage notes

  • After upload, Beecargo runs a safety check. Hand humans the share link right away. Wait for the check before machine downloads.
  • If this tool says the file is not ready, the body may include scanPending: true and retryAfterSeconds (about 15). Wait and retry, or wait for the file.ready webhook. Some responses use errorCode: SCAN_PENDING.
  • If the file is unavailable after the check, download fails as not found / blocked (scanBlocked). Poll GET /files/share/{shortId} for scanStatus (pending, scanning, clean, unavailable). Download only when it is clean.
  • beecargo_file_info does not include scanStatus. Use share metadata for readiness.
  • Signed URLs expire (usually about 1 hour). Request a fresh one when needed.
  • Check unlockRequired and paymentRequired / priceCents with beecargo_file_info or GET /files/share/{shortId} before calling this tool.
  • If unlockRequired is true, the /d/{shortId} link alone is not enough to download.
  • If payment is required (HTTP 402), call beecargo_purchase_checkout → send checkoutUrl → beecargo_purchase_claim → retry with purchaseToken. Or send the human to /d/{shortId}. CLI: beecargo download FILE_ID ./out --purchase-token TOKEN.