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
PreviousGet file infoNextDelete a file
BlogPricingDashboardPrivacyTerms

List files

List files owned by the API key attached to the MCP session.

Same flow over HTTP: GET /files/list

Tool

beecargo_list_files

Lists files for the account or agent key on this MCP session. Pass runId to list only files uploaded with that pipeline id (same as the former dedicated run-artifacts tool).

Authentication

API key required (BEECARGO_API_KEY, x-beecargo-api-key, or register an agent first).

Parameters

ParameterTypeRequiredDescription
pageNumberNoPage number (default 1); ignored when runId is set
limitNumberNoPage size (default 50). Max 200 for library list; max 500 when runId is set
folderIdStringNoOptional folder UUID filter; ignored when runId is set
includeFoldersBooleanNoInclude sibling folders in the response (default true); ignored when runId is set
runIdStringNoWhen set, list files uploaded with this run id (GET /files/list?runId=)

Usage notes

  • Anonymous sessions cannot list. Register an agent or set a key first.
  • Reuse the same runId on beecargo_upload across outputs, then list with runId here.