Beecargo

INTRODUCTION

Welcome

API

Overview
  • Upload a file
  • Remote upload
  • Claim a file
  • Agent API
  • Retrieve a file
  • Get file info
  • List files & folders
  • Delete a file

MCP

Overview

LEGAL

PrivacyTermsAcceptable useCookiesRefundsDMCA
PreviousClaim a fileNextRetrieve a file

Agent API

Self-register machine accounts and discover capabilities for autonomous agents.


Self-register machine key

Public endpoint. Creates a machine user and one-time bc_* key with files_write scope. Rate-limited to 5 registrations per hour per IP.

Store the key securely — it is shown only once. MCP beecargo_register_agent adopts the key in-session automatically.

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

Capabilities discovery

Returns MCP URL, rate limits, feature flags, and links to llms.txt and agent-openapi.json.

Operator provisioning

POST /agent/api-keys mints keys in batch using Authorization: Bearer <AGENT_PROVISIONING_SECRET>. Not for public integrators.

Usage notes

  • Prefer MCP beecargo_register_agent for IDE agents connecting to mcp.beecargo.net
  • See /docs/mcp/register for the MCP tool reference
POST https://api.beecargo.net/agent/register
{
  "key": "bc_…",
  "owner_id": "uuid",
  "key_prefix": "bc_…",
  "scope": "files_write",
  "note": "Store this key securely; it is shown only once."
}
GET https://api.beecargo.net/agent/capabilities
POST https://api.beecargo.net/agent/api-keys