> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trycherry.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect an agent over MCP

> Give Claude — or any MCP client — direct access to your books.

Cherry's MCP server lives at:

```
https://api.trycherry.ai/mcp
```

It speaks Streamable HTTP and authenticates with the same API keys as the REST API. Configure your client with a bearer token:

```json theme={null}
{
  "mcpServers": {
    "cherry": {
      "url": "https://api.trycherry.ai/mcp",
      "headers": {
        "Authorization": "Bearer ck_live_…"
      }
    }
  }
}
```

For Claude Code:

```bash theme={null}
claude mcp add --transport http cherry https://api.trycherry.ai/mcp \
  --header "Authorization: Bearer ck_live_…"
```

## Tools

| Tool                     | Scope | What it does                                              |
| ------------------------ | ----- | --------------------------------------------------------- |
| `query_transactions`     | read  | Search bank transactions by date range, category, or text |
| `list_accounts`          | read  | The chart of accounts                                     |
| `query_ledger`           | read  | Query journal entries and account activity                |
| `trial_balance`          | read  | Trial balance as of a date                                |
| `generate_statement`     | read  | Profit & loss, balance sheet, or cash flow for a period   |
| `list_entities`          | read  | Your business entities (tax IDs masked)                   |
| `list_obligations`       | read  | Compliance obligations and their status                   |
| `fiscal_health_score`    | read  | Cherry's readiness score for your books                   |
| `tax_estimate`           | read  | Quarterly estimated tax                                   |
| `categorize_transaction` | write | Correct a transaction's category                          |

A `read` key exposes only the read tools; `categorize_transaction` needs a `write` key.

## What an agent can do with this

Ask questions like *"what did we spend on software last quarter?"*, *"generate a P\&L for H1"*, or *"which obligations are due this month?"* — the agent picks the right tools and works against your live books, scoped to the one business the key belongs to.