Browse docs

MCP tools

Once a client is connected, AI Accounting exposes the full accounting engine as MCP tools. Each tool maps to a REST operation documented in the API reference — same behavior, same data, same auth.

Accounts

ToolDescription
list_accountsList accounts (filterable).
get_accountFetch a single account.
create_accountCreate an account.
update_accountUpdate an account.
get_account_treeThe chart of accounts as a hierarchy.
get_account_balanceAn account's current balance.
get_account_ledgerAn account's individual postings.
seed_accountsSeed the standard chart of accounts.

Contacts

ToolDescription
list_contactsList customers and vendors.
get_contactFetch a single contact.
create_contactCreate a contact.
update_contactUpdate a contact.

Journal entries

ToolDescription
list_journal_entriesList journal entries; filter by status/date/reference/source, page with cursor, trim columns with fields. Lean columns by default (no source_data).
count_journal_entriesCount entries matching a filter without fetching rows — cheap backlog sizing.
get_journal_entryFetch a single entry.
create_journal_entryCreate an entry (draft or auto-posted); each line takes account_id or account (code/name).
batch_create_journal_entriesCreate many entries in one call. Compact response by default; include_entries echoes them.
post_journal_entryPost a draft entry. Accepts idempotency_key (retry returns the posted entry, not an error).
batch_post_journal_entriesPost up to 100 draft entries by id. Compact response by default; include_entries echoes them.
post_journal_entriesPost all draft entries matching a filter (date/reference/source) — no id list, no 100 cap; safe to re-run.
reverse_journal_entryReverse a posted entry.
discard_journal_entryDelete a draft entry.

Import & categorization

ToolDescription
import_csvBulk-import contacts, pre-balanced journal entries, or a bank statement from a CSV — three targets, all with content de-duplication of re-uploads. See CSV import.
set_payee_rulesMemorize payee → account rules so future bank imports auto-categorize matching rows.
list_payee_rulesList the memorized payee → account rules.
delete_payee_ruleForget a memorized payee rule.

The payee-rule tools are MCP-only (there's no REST equivalent) — over REST you supply categorization inline via a category_account column or a category_map. Large CSVs are queued over REST (202 + a job id); over MCP, split the file (see CSV import).

Periods

ToolDescription
close_periodClose an accounting period.
reopen_periodReopen a closed period.
list_closed_periodsList closed periods.

Reports

ToolDescription
get_trial_balanceTrial balance as of a date.
get_income_statementIncome statement (P&L) over a range.
get_balance_sheetBalance sheet as of a date.
get_cash_flow_statementCash flow statement over a range.
get_general_ledgerGeneral ledger over a range.

Every report tool (and get_account_balance / get_account_ledger) is posted-only by default; pass include_drafts: true to fold in unposted drafts — e.g. to validate an import in aggregate before committing it.

Webhooks

ToolDescription
list_webhooksList webhook endpoints.
get_webhookFetch a single endpoint.
create_webhookRegister an endpoint.
update_webhookUpdate an endpoint.
delete_webhookRemove an endpoint.

Skills & capability requests

ToolDescription
list_skillsList the skill catalog.
get_skillFetch a skill's instructions.
suggest_capabilityRecord a capability request or feedback.

Resources

Beyond tools, the server exposes read-only MCP resources for quick context — chart_of_accounts, recent_transactions, and accounting_skills.

Note

Tool names and behavior are derived from the live server. If a connected client shows a tool not listed here, it reflects a newer server version — the API reference is always the authoritative contract.