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
PreviousUpload statusNextLarge uploads & jobs
BlogPricingDashboardPrivacyTerms

Remote upload

Import a file from a public HTTPS URL via MCP.

Same flow over HTTP: POST /files/remote-upload

Tool

beecargo_upload

Pass url to beecargo_upload. Beecargo fetches the URL and stores the file. For large or slow sources, set background: true and poll with beecargo_upload_status.

Authentication

API key optional. Best path for agent uploads with no human in the loop.

Parameters

ParameterTypeRequiredDescription
urlStringYesPublic HTTPS URL to fetch
backgroundBooleanNoAsync job with progress; use beecargo_upload_status
folderIdStringNoOptional folder UUID (signed-in users only)
visibilityunlisted | publicNoPublic needs a username; Free public TTL is 7 days
directBooleanNoPro: auto-download on the /d link
retentionttl | foreverNoPublic + Pro for forever
expiresAtString (ISO)NoExpiry when retention is ttl
ttlStringNoKeep-time preset from now, such as 1h, 24h, or 7d
onceBooleanNoWhen true, the share can be downloaded only once
maxDownloadsNumberNoMax downloads allowed (ignored when once is true)
protectBooleanNoCreate an unlock code and private delivery link (returned once)
handoffMessageStringNoOptional note on the delivery link
runIdStringNoOptional pipeline id; list related files later with beecargo_list_files

Usage notes

  • Save deletionToken and claimToken from anonymous responses.
  • Share links look like https://beecargo.net/d/{shortId}.
  • Publish options match [Upload a file](/docs/mcp/upload), including protect, ttl, once, and runId.
  • See also [Upload a file](/docs/mcp/upload) for contentBase64 and stdio path.