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
PreviousRemote uploadNextFolders
BlogPricingDashboardPrivacyTerms

Large uploads and jobs

Upload local files up to your tier limit or run long remote imports with progress.

Hosted MCP cannot read a local path. On stdio, beecargo_upload with path chooses direct or multipart automatically. For slow or large remote imports, use beecargo_upload with url and background: true, then beecargo_upload_status. REST clients can still call /files/multipart/* and /files/remote-multipart/* directly.

Authentication

API key optional. Anonymous limits apply without a key. Preserve upload session secrets and anonymous ownership tokens.

Tools

beecargo_upload

beecargo_upload

Stdio: local path with auto multipart. Any transport: public url (sync or background: true).

ParameterTypeRequiredDescription
pathStringstdio onlyLocal filesystem path (not on hosted HTTP)
urlString (URL)hosted / remotePublic HTTPS source URL
backgroundBooleanNoStart async remote job for large/slow URLs
waitSecondsNumberNoWhen background is true, wait up to N seconds
  • Tier limits match the web app and REST API (anonymous / free / Pro).
  • Hosted HTTP cannot use path; use url or small contentBase64 on the main upload page.

beecargo_upload_status

beecargo_upload_status

Poll or wait for a background URL upload started with background: true.

ParameterTypeRequiredDescription
jobIdUUIDYesJob id from beecargo_upload
jobSecretStringYes for new jobsSecret returned with the job
waitSecondsNumberNoPoll up to N seconds (max 600)
  • Completed jobs include fileId, shortId, and sharePath.