Connect an agent over MCP

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:

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

For Claude Code:

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
`list_incorporations`	read	Companies being formed and their filing status
`list_entity_filings`	read	State/federal filings linked to an entity
`start_incorporation`	write	Form a new company (LLC or corporation), optionally with an EIN order
`list_ein_applications`	read	EIN applications Cherry files on paper, and where each one has got to
`generate_ein_form`	write	Render the application onto IRS Form SS-4, ready to sign
`request_ein_signature`	write	Email the responsible party their SS-4 to sign
`cancel_ein_signature`	write	Void an outstanding signature request
`mark_ein_application_filed`	write	Record that the signed form went to the IRS
`complete_ein_application`	write	Record the issued EIN and propagate it to the entity

A read key exposes only the read tools; every write tool needs a write key, and a key’s scopes are clamped to its owner’s role. start_incorporation files real state paperwork and incurs filing costs — agents are instructed to confirm every detail before calling it.

The no-SSN EIN route

A responsible party with no US SSN or ITIN cannot use the IRS online tool, so Cherry prepares Form SS-4 and files it on paper as third-party designee. Call start_incorporation with an EIN block and no responsiblePartySsn; that records an application, and the six *_ein_* tools above carry it through ready_to_file → awaiting_signature → signed → filed → ein_received. Three things worth knowing before wiring an agent to it:

request_ein_signature emails a real person a federal declaration. The address must belong to someone Cherry already knows, and the name on file for it must be the responsible party the form names — a colleague cannot be nominated in their place. The signing link is never returned to the agent; it is mailed to that person and nowhere else. Poll list_ein_applications for the status.
The IRS takes weeks. These are faxed and typically answer in four to eight weeks, against same-day for an applicant with an SSN. filed with no EIN yet is normal, not stuck. The company is formed either way — the EIN is what opens a bank account.
The PDF is not a tool result. Fetch it from GET /v1/ein-applications/{id}/ss4.pdf with the same 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.

Getting started

Guides

Connect an agent over MCP

Tools

The no-SSN EIN route

What an agent can do with this

​Tools

​The no-SSN EIN route

​What an agent can do with this

Tools

The no-SSN EIN route

What an agent can do with this