# Cherry > Cherry public API and MCP server documentation. ## Docs - [Overview](https://docs.trycherry.ai/index.md): Cherry keeps your books. The API and MCP server let your systems read them — and write to them. - [Quickstart](https://docs.trycherry.ai/quickstart.md): Create a key and read your books in two minutes. - [Authentication](https://docs.trycherry.ai/authentication.md): API keys, scopes, and how tenancy works. - [Conventions](https://docs.trycherry.ai/conventions.md): Envelopes, pagination, rate limits, and error shapes — consistent across every endpoint. - [Push your own transactions](https://docs.trycherry.ai/guides/manual-banks.md): Create bank accounts and push transactions without connecting Plaid. - [Connect an agent over MCP](https://docs.trycherry.ai/guides/mcp.md): Give Claude — or any MCP client — direct access to your books. - [This OpenAPI document](https://docs.trycherry.ai/api-reference/meta/this-openapi-document.md): The machine-readable contract for the whole /v1 surface. The only unauthenticated endpoint — it discloses the API's shape, never data. - [List bank transactions](https://docs.trycherry.ai/api-reference/transactions/list-bank-transactions.md): Bank transactions in a date window (default: the last 30 days), newest first, with each row's categorization and whether it still needs human review. Filter with `category` (a ledger account number from GET /accounts) to see everything filed under one account, or `search` for a case-insensitive subs… - [Push transactions into a manual bank account (write scope)](https://docs.trycherry.ai/api-reference/transactions/push-transactions-into-a-manual-bank-account-write-scope.md): Import transactions into a manual bank institution previously created with POST /bank-accounts — the no-Plaid path for bringing your own bank feed. Rows land in the same pipeline Plaid-synced transactions use; Cherry categorizes and books them asynchronously (they appear uncategorized at first and a… - [One bank transaction](https://docs.trycherry.ai/api-reference/transactions/one-bank-transaction.md): A single transaction by the id returned from the list endpoint. - [Recategorize a transaction (write scope)](https://docs.trycherry.ai/api-reference/transactions/recategorize-a-transaction-write-scope.md): File the transaction under a different ledger account — the same correction a person makes in the app. The decision is recorded as a human override (confidence 1.0), the prior ledger posting is reversed and re-booked against the new account, and Cherry learns the merchant→account preference for futu… - [The chart of accounts](https://docs.trycherry.ai/api-reference/accounts/the-chart-of-accounts.md): Every ledger account: number, name, category (asset/liability/equity/revenue/expense), and active flag. Account numbers are the vocabulary the rest of the API speaks — transaction categories and journal lines both resolve against this list. Small enough to return whole; not paginated. - [List connected bank accounts](https://docs.trycherry.ai/api-reference/bank-accounts/list-connected-bank-accounts.md): Every bank account the tenant has connected — Plaid-linked and manual — with its institution, currency, kind, balances, and whether it is mapped to a ledger account. `derivedBalance` (opening balance rolled forward through settled transactions) is the current figure for manual accounts; Plaid accoun… - [Create a manual bank institution + accounts (write scope)](https://docs.trycherry.ai/api-reference/bank-accounts/create-a-manual-bank-institution-+-accounts-write-scope.md): Create (or idempotently update) a manual bank institution and its accounts — the first step of the no-Plaid flow: create accounts here, then push their transactions through POST /transactions using the same `institutionName` and each account's `externalId`. - [Journal entries in a period](https://docs.trycherry.ai/api-reference/journal/journal-entries-in-a-period.md): The double-entry journal between `from` and `to` (both required), oldest first, each entry with its balanced debit/credit lines. Add `accountNumber` to see only the entries touching one account — the drill-down behind any statement or trial-balance figure. - [One journal entry](https://docs.trycherry.ai/api-reference/journal/one-journal-entry.md): A single journal entry with its lines, by UUID. - [Trial balance as of a date](https://docs.trycherry.ai/api-reference/reports/trial-balance-as-of-a-date.md): One row per ledger account with cumulative debits, credits, and the natural-direction balance through `asOf` (inclusive) — where everything is sitting right now. The backbone for any custom management report. - [Generate a financial statement](https://docs.trycherry.ai/api-reference/reports/generate-a-financial-statement.md): A financial statement computed from the live ledger — the exact generator the Cherry app uses, so figures here always match the product. `profit_and_loss` and `cash_flow` cover the `from`..`to` period (both required); `balance_sheet` is a snapshot as of `to` (`from` is ignored). The response shape v… - [List legal entities](https://docs.trycherry.ai/api-reference/entities/list-legal-entities.md): Every legal entity behind the tenant (a business can have several — e.g. a Delaware C-Corp and a Mexican operating company). Tax ids are masked to their last 4 characters. Use the entity ids to scope journal and report reads. - [One legal entity](https://docs.trycherry.ai/api-reference/entities/one-legal-entity.md): A single entity by UUID, tax id masked. - [The tax obligations calendar](https://docs.trycherry.ai/api-reference/obligations/the-tax-obligations-calendar.md): Every confirmed tax/compliance obligation Cherry is tracking, deadline ascending: type, period, frequency, deadline, status, jurisdiction, authority, and form reference. Filter with `status` (comma-separated: upcoming, payment_pending, confirmed, filed) — e.g. `status=upcoming` for what's due next —… - [Fiscal health score](https://docs.trycherry.ai/api-reference/health/fiscal-health-score.md): Cherry's composite fiscal readiness score (0-100 with a grade): profile completeness of the primary entity, obligation hygiene (overdue filings cost points), and the latest document-detector findings. The single number to watch for "is this business's fiscal house in order", with the issues that cos… ## OpenAPI Specs - [openapi](https://docs.trycherry.ai/openapi.json)