Machine-readable reference for AI agents and crawlers. Humans: use the main site or /docs.

# Beecargo — agent integration steps

Source: https://www.beecargo.net/agents/integration

## How to integrate (agents)

1. Read /llms.txt for the API and MCP map (artifact handoff happy path).
2. Connect to https://mcp.beecargo.net/mcp (stdio alternative: @beecargo/mcp npm package).
3. Call beecargo_register_agent to obtain bc_* (files_write, free-tier quotas). The MCP session adopts the key.
4. Publish via beecargo_remote_upload with a public HTTPS url (preferred) or beecargo_upload_file for small base64 payloads.
5. Complete handoff: return the share link https://www.beecargo.net/d/{shortId} (and use beecargo_get_download_url when another tool needs a signed GET).
6. REST equivalent: POST /agent/register then POST /files/remote-upload with Authorization: Bearer bc_*.
7. Save fileId (short id), claimToken and deletionToken for anonymous uploads.