Why does my credit card lower the total instead of adding to it?

Each row shows the card as a positive amount owed, same as elsewhere — it's only the grand total that nets card debt against cash, which is what makes the total an honest net cash figure instead of one that overstates what you actually have on hand.

Where do I get the id reconcile_account needs?

From here — specifically the bankAccountIds array on the account's row, not chartAccountId. list_transactions also returns a bankAccountId, but cash_position is where you see it mapped to a chart account and balance.

Can I see cash position as of a past date, not just right now?

Not through this tool directly — it's a live snapshot. For a specific past date, balance_sheet's assets section or general_ledger on a specific cash account will get you there instead.

cash_positionRead-only

See how much cash you actually have, across every account

You want a single, immediate answer to "how much money do we actually have" without opening each bank account separately or waiting on a full financial statement.

This is the quickest report in BalanceMCP, and usually the most-asked-for one: the current balance of every bank account and credit card tied to a book, plus a single total. No date range to specify, no report to configure — just the number, right now, across everything.

Each row displays a credit card as a positive amount owed, the same convention used everywhere else in BalanceMCP. It's the total that's signed: it nets every card's debt against cash on hand, so the total genuinely reflects net cash position rather than overstating what you have if a card carries a balance.

This report doubles as a lookup tool for ids the rest of BalanceMCP needs. Each row separates chartAccountId (the ledger account, used by general_ledger and most other reports) from bankAccountIds (the bank account or accounts behind it, used specifically by reconcile_account). They look similar and are easy to mix up — list_transactions also returns a bankAccountId on every row, but cash_position is the tool that maps that id to its chart account and current balance, which is why reconciling an account starts here.

What you would actually say"How much cash do we actually have right now, across everything?"

What this does not do

list_transactions also returns a bankAccountId on every row, but this is the tool that maps one to its chart account and current balance — reconciling always starts here for that reason.
Shows a point-in-time snapshot as of now; it doesn't take a date parameter, so you can't ask for cash position as of a past date through this tool.

Arguments

Name	Type	Required	What it is
`bookId`	`uuid`	Required	—

Generated from the tool definition, so it cannot describe arguments the tool does not accept. Unrecognised arguments are rejected rather than ignored.

Common questions

Why does my credit card lower the total instead of adding to it?: Each row shows the card as a positive amount owed, same as elsewhere — it's only the grand total that nets card debt against cash, which is what makes the total an honest net cash figure instead of one that overstates what you actually have on hand.
Where do I get the id reconcile_account needs?: From here — specifically the bankAccountIds array on the account's row, not chartAccountId. list_transactions also returns a bankAccountId, but cash_position is where you see it mapped to a chart account and balance.
Can I see cash position as of a past date, not just right now?: Not through this tool directly — it's a live snapshot. For a specific past date, balance_sheet's assets section or general_ledger on a specific cash account will get you there instead.