Agent services

Create a key, find tools, send files, and return their share links.

Hosted MCP is the simplest option for agents. Use the API when you prefer direct HTTP calls.

Recommended MCP steps

Connect to https://mcp.beecargo.net/mcp without headers, call beecargo_register_agent, then use beecargo_remote_upload. Return /d/{shortId} or the short code plus /get.

MCPHosted MCP (HTTP)Connect Cursor, Claude Desktop, or your own agents to Beecargo with MCP. Publish files and get share links back.

Tool

https://mcp.beecargo.net/mcp

Authentication

You can connect to hosted MCP without headers for rate-limited access. For persistent access, call beecargo_register_agent, or send an existing bc_* key as Authorization: Bearer bc_… or x-beecargo-api-key: bc_…. Keep the key secret.

If your MCP client offers “Connect with Beecargo,” complete the browser sign-in and consent flow. The client sends the OAuth access token for you. Clients without OAuth can use the hosted URL with no headers or authenticate with a bc_* API key.

Usage notes

MCP lets agents send, download, and organize files. Use remote upload for a file at a public URL. Use multipart for local files over 4 MB.
Add the URL with no headers (rate-limited). Then call beecargo_register_agent, then beecargo_remote_upload.
After beecargo_register_agent succeeds, this session keeps the bc_* key so beecargo_list_files and beecargo_claim_file work without pasting the key again.
Use the hosted HTTP endpoint at https://mcp.beecargo.net/mcp. That is the supported way to connect.

Open: Hosted MCP (HTTP)

MCPAgent autoregistrationCreate a lasting `bc_*` API key for storage without a human account.

Tool

beecargo_register_agent

Authentication

No API key required. About 5 registrations per hour per client IP.

Parameters

Parameter	Type	Required	Description
`label`	String	No	Optional label for the key (max 120 characters, default `mcp-agent`)

Usage notes

Creates an agent account with a lasting bc_* key for file writes. This MCP session keeps the key, so you can list files and claim uploads in the same connection without pasting the key again.
The key is shown only once. Store it if you need it outside this session.
API equivalent: POST https://api.beecargo.net/agent/register
After register, prefer beecargo_remote_upload for uploads on your agent account.

Open: Agent autoregistration

API steps

Call POST /agent/register to create a bc_* key, then send it as a Bearer token with file requests.

APISelf-register agent keyRegister agent accounts and discover what the API supports.

Endpoint

POSThttps://api.beecargo.net/agent/register

Request examples

curl -X POST https://api.beecargo.net/agent/register \
  -H "Content-Type: application/json" \
  -d '{"label":"my-agent"}'

Usage notes

Public endpoint. Creates an agent account and a one-time bc_* key with files_write scope. Limited to about 5 registrations per hour per IP.
Store the key securely. It is shown only once. MCP beecargo_register_agent keeps the key in the session for you.

Open: Self-register agent key

APICapabilities discoveryReturns the public MCP URL, current limits, supported features, and links to `llms.txt` and `agent-openapi.json`.

Endpoint

GEThttps://api.beecargo.net/agent/capabilities

Usage notes

Prefer MCP beecargo_register_agent for IDE agents on mcp.beecargo.net
See /docs/mcp/register for the MCP tool reference

Open: Capabilities discovery

APIUse your API keyFor later API requests, send the key as `Authorization: Bearer bc_…`. You can also use `x-beecargo-api-key: bc_…`. Keep the key in a server-side secret or secure agent configuration.

Endpoint

POSThttps://api.beecargo.net/agent/api-keys

Open: Use your API key

Find a tool

Use beecargo_search_tools to find the right tool for large files, folders, sharing, or downloads.

MCPSearch toolsKeyword search over available Beecargo MCP tools.

Tool

beecargo_search_tools

Authentication

No API key required.

Parameters

Parameter	Type	Required	Description
`query`	String	No	Keyword filter (empty lists all tools up to the limit)
`limit`	Integer	No	Max results (1–20, default 10)

Usage notes

Find tools by name or summary. Useful when you are not sure which upload or file tool to call.
Returns JSON with matching tool names and short summaries.
Use when you are unsure which upload or file tool to call.

Open: Search tools

Recommended MCP steps

Connect to https://mcp.beecargo.net/mcp without headers, call beecargo_register_agent, then use beecargo_remote_upload. Return /d/{shortId} or the short code plus /get.

MCPHosted MCP (HTTP)Connect Cursor, Claude Desktop, or your own agents to Beecargo with MCP. Publish files and get share links back.

Tool

https://mcp.beecargo.net/mcp

Authentication

Usage notes

MCP lets agents send, download, and organize files. Use remote upload for a file at a public URL. Use multipart for local files over 4 MB.
Add the URL with no headers (rate-limited). Then call beecargo_register_agent, then beecargo_remote_upload.
After beecargo_register_agent succeeds, this session keeps the bc_* key so beecargo_list_files and beecargo_claim_file work without pasting the key again.
Use the hosted HTTP endpoint at https://mcp.beecargo.net/mcp. That is the supported way to connect.

Open: Hosted MCP (HTTP)

MCPAgent autoregistrationCreate a lasting `bc_*` API key for storage without a human account.

Tool

beecargo_register_agent

Authentication

No API key required. About 5 registrations per hour per client IP.

Parameters

Parameter	Type	Required	Description
`label`	String	No	Optional label for the key (max 120 characters, default `mcp-agent`)

Usage notes

Creates an agent account with a lasting bc_* key for file writes. This MCP session keeps the key, so you can list files and claim uploads in the same connection without pasting the key again.
The key is shown only once. Store it if you need it outside this session.
API equivalent: POST https://api.beecargo.net/agent/register
After register, prefer beecargo_remote_upload for uploads on your agent account.

Open: Agent autoregistration

API steps

Call POST /agent/register to create a bc_* key, then send it as a Bearer token with file requests.

APISelf-register agent keyRegister agent accounts and discover what the API supports.

Endpoint

POSThttps://api.beecargo.net/agent/register

Request examples

curl -X POST https://api.beecargo.net/agent/register \
  -H "Content-Type: application/json" \
  -d '{"label":"my-agent"}'

Usage notes

Public endpoint. Creates an agent account and a one-time bc_* key with files_write scope. Limited to about 5 registrations per hour per IP.
Store the key securely. It is shown only once. MCP beecargo_register_agent keeps the key in the session for you.

Open: Self-register agent key

APICapabilities discoveryReturns the public MCP URL, current limits, supported features, and links to `llms.txt` and `agent-openapi.json`.

Endpoint

GEThttps://api.beecargo.net/agent/capabilities

Usage notes

Prefer MCP beecargo_register_agent for IDE agents on mcp.beecargo.net
See /docs/mcp/register for the MCP tool reference

Open: Capabilities discovery

Endpoint

POSThttps://api.beecargo.net/agent/api-keys

Open: Use your API key

Find a tool

Use beecargo_search_tools to find the right tool for large files, folders, sharing, or downloads.

MCPSearch toolsKeyword search over available Beecargo MCP tools.

Tool

beecargo_search_tools

Authentication

No API key required.

Parameters

Parameter	Type	Required	Description
`query`	String	No	Keyword filter (empty lists all tools up to the limit)
`limit`	Integer	No	Max results (1–20, default 10)

Usage notes

Find tools by name or summary. Useful when you are not sure which upload or file tool to call.
Returns JSON with matching tool names and short summaries.
Use when you are unsure which upload or file tool to call.

Open: Search tools