title: Richbee Docs · status: DRAFT (not approved, not published)

Richbee docs

Richbee is the CRM your agents run: MCP and REST only, billed per call, never per seat.

There's no UI. Your agent reads the docs, so we wrote them for it.

Richbee CRM

Headless, multi-tenant CRM covering companies, contacts, deals and notes.

Resource	URL	Notes
llms.txt	`<your-richbee-endpoint>/llms.txt`	Agent-readable overview. TODO: confirm it's hosted
OpenAPI 3.1	`<your-richbee-endpoint>/openapi.json`	TODO: confirm the served path
MCP endpoint	`<your-richbee-endpoint>/mcp`	JSON-RPC 2.0, streamable HTTP, bearer auth

Auth: an API key or an OAuth2 client_credentials token (POST /oauth/token). Scopes are crm:read, crm:write and admin. TODO: how to get a key.
Same names everywhere: MCP tool names match REST operations, e.g. create_contact and bulk_update_deals.
Built for agents: errors are RFC 7807 with a fix-it hint. Creates accept an Idempotency-Key (24h replay), and atomic bulk ops take up to 100 items.
Safe by default: every workspace is isolated, with an append-only audit log and export plus hard delete with receipts.

KMS, BPM, DMS and ATS at [service].richbee.ai (roadmap). TODO: dates.

Per call, never per seat. TODO: rates and free tier (proposal not final).