MCP (Model Context Protocol)
Crane Ledger exposes accounting operations over the Model Context Protocol so AI assistants can call tools instead of inventing ad-hoc API scripts. MCP is a transport and tool layer on top of the same REST backend — same auth, credits, and validation.
Connect your client (start here)
Per-product setup lives under Connect your AI:
- Overview
- ChatGPT · Claude · Claude Code
- GitHub Copilot · Microsoft 365 Copilot
- Gemini · Perplexity · Grok
- Cursor · Windsurf · Mistral
- Any MCP client
MCP endpoint
| Setting | Value |
|---|---|
| URL | https://api.craneledger.ai/mcp |
| Transport | Streamable HTTP |
| Auth (OAuth) | Sign in at consent UI — no key in the client |
| Auth (API key) | Authorization: Bearer ha_live_… |
| Consent | https://craneledger.ai/oauth/consent |
Organization scope comes from your OAuth token or API key — you do not pass organization_id separately.
Scopes: ledger:read, ledger:write, and optionally ledger:admin.
ChatGPT directory / custom connector listings should use https://api.craneledger.ai/mcp/chatgpt instead (same tools minus credit purchase and x402 top-up). See Connect ChatGPT.
See Authentication and MCP tools.
ChatGPT directory / custom connector listings should use https://api.craneledger.ai/mcp/chatgpt — the same server without credit purchase or x402 top-up tools. Product agents keep https://api.craneledger.ai/mcp.
How MCP relates to REST
AI assistant → MCP client → POST /mcp → REST API → Database
Every tool call becomes one or more REST operations. Credits, org scoping, and audit behavior match the REST API.
What you can do
- Chart of accounts, transactions, invoices, bills, contacts
- Reports (trial balance, P&L, balance sheet, …)
- Credits and billing helpers
- Draft → validate → approve for human-in-the-loop writes (Drafts)
Full catalog: MCP Protocol & tools.
Bootstrap without a key
curl -s https://api.craneledger.ai/accounts/master \
-H "Content-Type: application/json" \
-d '{"name":"My Agent Org","base_currency_code":"USD"}'
Save api_key and organization_id (500 free credits). Then connect with Bearer auth, or use OAuth from ChatGPT/Claude connectors without pasting a key.
Agent path: pricing.md · llms.txt.
Credits
| Operation | Credits |
|---|---|
| Reads / reports | 0 (free) |
| Writes | 1 ($0.01) |
Next steps
Need help?
Create a free account (GitHub, Google, Apple, or email) to access our support portal. Once signed in, use the Support tab in your dashboard to submit a support ticket — no GitHub account required. Our team typically responds within 24 hours.
- ✨ For LLMs/AI assistants: Read our structured API reference
- Legal: Terms of Service · Privacy Policy