Home · Setup · Claude Code
The one document that answers what a client actually owes you, aged as at any date you name, with the chaser drafted. It reads the three books this collection already keeps, the invoice ledger, the credit notes and the deposits, and turns them into a statement of account for a period: the balance carried at the start, every invoice issued, every payment received, every credit note given, the deposits applied broken out of the receipts rather than added on top of them, and the balance at the end. The movements come back in date order and the opening balance plus their sum is the closing balance, so the document reconciles line by line rather than only at the bottom. statement_aging splits what is still open into 0-30, 31-60, 61-90 and over 90 days past the due date AS AT the date you ask for, which means an invoice issued after that date is not on the books, a payment made after it has not happened, and a credit note issued after it has not been given. Due today is not overdue: day zero sits in a not-yet-due line reported beside the four buckets rather than hidden inside them. On the invoice the paid_minor field is the authority and the payment rows are only the attribution, so money that a deposit application put on an invoice without writing a payment row still appears, and when the two books disagree the difference is reported by name rather than scaled away. It writes into no book it reports on: the bytes and the mtimes of the sibling stores are unchanged across all six tools, and the only file it owns is a register of the statements it built. Nothing here invents a late fee, an interest rate or a legal cost, and a dunning letter escalates in tone and never in figures.
`claude mcp add statement-of-account` at user scope is the level that matches the meter: five statements a calendar month is a business's allowance, not a repository's, and the invoice ledger it reads lives once per machine anyway. There is no network call in the server, so an aging report answers the same offline as online.
| You say | Tool |
|---|---|
| Send Acme Ltd a statement of account for June. What is the closing balance, and does it reconcile from the opening balance and the movements? | statement_build |
| Who owes me money right now, aged into 0-30, 31-60, 61-90 and over 90 days, per currency? | statement_aging |
| What was outstanding on 10 June, and how much of that was already overdue on that date? | statement_aging |
Aging a past date with today's payment figures does not go slightly wrong, it goes silently empty. Measured on this server's worked month at 2026-06-10: the as-at rule reports 2,500.00 outstanding of which 500.00 is 31 days late, while the ordinary rule almost every aging report is written as, subtract paid_minor and bucket by the due date, reports 1,700.00 outstanding and ZERO overdue, because a payment that arrived on 12 June has already been subtracted on the 10th. A third of the balance and all of the overdue disappear, the buckets still add up, and the answer cannot be reproduced next month because the input keeps moving. The dated subtraction is the step nobody writes a test for and the only one that decides who gets chased. A second measured figure from the same month: reconstructing receipts from the invoice payments[] rows alone would have lost 300.00 of 900.00 of cash, because deposit_apply raises paid_minor and writes no payment row, so paid_minor is treated as the authority and the rows only as the attribution.
The file is .mcp.json, and the key inside it is mcpServers.
| Scope | Path |
|---|---|
| local (default) | ~/.claude.json, this project only |
| project | .mcp.json at the repository root |
| user | ~/.claude.json, every project |
claude mcp add statement-of-account -- npx -y @theluckystrike/mcp-statement-of-account
claude mcp list # health-check it before the first prompt
# or --scope project, committed to .mcp.json for the teamNo restart. The entry is picked up in the next session, and `/mcp` reconnects one on demand.
The npm publish of @theluckystrike/mcp-statement-of-account is pending; until then use the .mcpb bundle or a clone and build from the latest release.
The same server runs at https://mcp.zovo.one/mcp/https://mcp.zovo.one/mcp/statement-of-account over MCP streamable HTTP, no install. Mint a free token with curl https://mcp.zovo.one/mcp/token, or use a Pro key. It has no filesystem, so a file comes back as a one-hour download link.
claude mcp add --transport http statement-of-account https://mcp.zovo.one/mcp/https://mcp.zovo.one/mcp/statement-of-account \
--header "Authorization: Bearer <token>"The `--` is load-bearing: it separates Claude Code's own options, such as --transport, --env and --scope, from the command that runs the server. And the default scope is local, private to you and to the directory you ran it in, so adding it in the wrong folder leaves the tools absent with no error at all.
Free: statement_aging is free and unlimited on every tier, for one client or for all of them: who owes me money is the question this server exists for, and a free tier that hides it is a demo rather than a tool. The meter is on the document that actually goes to a client, five distinct statements a calendar month, counted by client, period and currency, so rebuilding one already in the register is free forever. Plain-text statements and dunning letters at level 1 and level 2 are free. Pro is $19 once, verified offline.
Local, the default, writes ~/.claude.json and is private to you and that directory. --scope project writes .mcp.json at the repository root, shared through version control. --scope user loads it everywhere.
Measured, not documented: of three fresh projects, one first prompt made zero tool calls although initialize answered in 1.05 seconds. Run claude mcp list once first: it prints Connected, and the next run used the tool.
Yes: claude mcp add --transport http https://mcp.zovo.one/mcp/statement-of-account https://mcp.zovo.one/mcp/https://mcp.zovo.one/mcp/statement-of-account --header "Authorization: Bearer <token>". Mint a free token at https://mcp.zovo.one/mcp/token or use a Pro key. -t and -H are the short forms.
MCP Statement of Account in detail · The same server in Claude Desktop and Cursor · Every server in Claude Code · Guides · Claude Code docs · Buy Pro