List the chart of accounts
Every account with its code, type, role and balance on a day.
Free*
*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.
An example
What's the balance of each of our accounts today?
Your agent callsbooks_list_accountsFree*
The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.
{
"as_of": "2026-10-14"
}Use it when
To find an account code, or see what each account holds.
What it does
Every account with its code, type, role and balance on as_of (default today). Balance sheet accounts show their balance; income and expense accounts show the fiscal year so far.
What comes back
The currency, the day, and every account with its code, name, type, role, description, balance (balance sheet accounts on the day, income and expenses for the fiscal year so far) and archived. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
as_of | string | YYYY-MM-DD. Matches ^\d{4}-\d{2}-\d{2}$. |
include_archived | boolean | Default: false. |
The call
Over MCP, call books_list_accounts on https://api.conecto.chat/mcp/books. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/books_list_accounts \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"as_of":"2026-10-14"}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
no_books409 | The business keeps no books yet. | Set them up with books_setup (base currency, start date). |
invalid_input400 | A date is not a date like 2026-10-01, or from is after to. | Fix the date. |
More Bookkeeping tools
All 33 tools- Set up the books
books_setupStarts the business's double-entry books (currency, start date, chart of accounts) or changes their settings.$0.001 a call - Read the books' settings
books_getThe books' settings: currency, start date, fiscal year, locked period, roles, payment accounts, taxes, and what is waiting.Free* - Add or change accounts
books_save_accountsAdds accounts or changes them, matched by code: name, type, description, code, role or archived.$0.001 a call - Add or change a tax
books_save_taxAdds or changes a tax rate the books use (VAT, GST, sales tax), matched by name.$0.001 a call - Book an expense
books_record_expenseBooks a cost the business paid, with its tax split off and the receipt attached.$0.01 a call - Book a journal entry
books_record_entryBooks a journal entry of two or more balancing lines, for whatever the other tools do not cover.$0.01 a call - Attach a receipt
books_attach_receiptAttaches a receipt from the file store to an entry that has none.$0.01 a call - Reverse an entry
books_reverse_entryUndoes an entry by booking its mirror image; entries are never edited or deleted.$0.01 a call
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md