Connect your AI to Crane Ledger
Crane Ledger is the ledger of record. Your AI tool of choice is the generative UI — you ask in natural language; the model calls Crane Ledger over MCP or REST.
You → ChatGPT / Claude / Copilot / … → MCP or REST → Crane Ledger → books
Building an agent or MCP integration? Start with Crane Ledger for AI builders — what the ledger is, why real books beat a QBO wrapper, pricing, and the first prompt to run.
The future of accounting is agent-run: Agent-run accounting — why you should not sign into QuickBooks every day.
REST vs MCP is a client choice. Same organizations, credits, and double-entry rules either way.
1. Create a Crane Ledger account
Browser: Sign up at craneledger.ai with GitHub, Google, Apple, or an email magic link. New orgs get 500 free credits. GitHub is optional.
Agent / API (no browser):
curl -s https://api.craneledger.ai/accounts/master \
-H "Content-Type: application/json" \
-d '{"name":"My Business","base_currency_code":"USD"}'
Save the one-time api_key (ha_live_…) and organization_id.
2. Pick how to connect
| Method | Best for |
|---|---|
| OAuth (recommended) | ChatGPT, Claude, Perplexity, Grok, and other connector UIs — sign in and approve scopes |
| API key | Cursor, GitHub Copilot, Windsurf, scripts, CLI tools — Authorization: Bearer ha_live_… |
| REST | Custom agents and apps that call HTTP directly |
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.
See Authentication and MCP tools.
3. Choose your client
| Client | Guide |
|---|---|
| ChatGPT | Connect ChatGPT |
| Claude | Connect Claude |
| Claude Code | Connect Claude Code |
| GitHub Copilot | Connect GitHub Copilot |
| Microsoft 365 Copilot | Connect Microsoft 365 Copilot |
| Gemini | Connect Gemini |
| Perplexity | Connect Perplexity |
| Grok | Connect Grok |
| Cursor | Connect Cursor |
| Windsurf | Connect Windsurf |
| Mistral Le Chat | Connect Mistral |
| Other MCP clients | Any MCP client |
| Custom agents | REST agents |
Example prompts
Once connected, try:
- "Set up a basic chart of accounts for a small service business"
- "Create an invoice for $2,500 to Acme Corp for consulting"
- "What's our cash position right now?"
- "Show me profit and loss for last quarter"
- "How many credits do I have left?"
Related
- Agent-run accounting
- Crane Ledger for AI builders
- Quick Start
- Why Choose Crane Ledger?
- Drafts & Approval — human-in-the-loop writes
- MCP protocol reference
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