Skip to main content
Glama

Server Details

AI accounting: ask about your live AccountsOS books in plain English. Read-only tools for transactions, cash balances, invoices, bills, VAT, filing deadlines and reports across 32 countries. OAuth sign-in; free 14-day trial at accounts-os.com.

Ownership verified
Status
Healthy
Uptime
100.0% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2025-06-18
URL
ChatGPT
AccountsOS
Claude
–

TDQS

B3.1/5.0

Scored across 86 tools

Disambiguation2/5

Several tool pairs are near-duplicates: get_statement_checks vs get_reconciliation_status, get_expenses vs get_expense_claims, get_projects vs list_opportunities/get_opportunity, and get_financial_snapshot vs month_close_summary vs get_attention all overlap heavily. The tax/knowledge cluster (get_tax_facts, search_tax_facts, list_tax_rules, lookup_tax_rule, get_gov_guidance, read_wiki, read_company_wiki) forces the agent to reason about six similarly purposed lookups. Long descriptions do add routing hints, but with 86 tools an agent will frequently misselect.

Naming Consistency4/5

The overwhelming majority follow a snake_case verb_noun pattern (get_invoices, list_employees, search_documents, calculate_vat_period), with a sensible deel_ namespace for the third-party integration. Deviations are minor: month_close_summary is noun-first, and get_balance/get_attention are verb-only. Readable and predictable overall.

Tool Count2/5

86 tools is far beyond what an agent can select from reliably, even for a broad accounting platform. The domain is genuinely large (bookkeeping, VAT/GST, payroll, tax research, Deel, integrations, wiki), but many of the tools could be consolidated (e.g. one reconciliation tool, one expenses tool, one knowledge-lookup entry point).

Completeness3/5

The read/reporting surface is exceptionally complete, and lifecycle gaps are partly covered (add_document, update_company, link_company, merge_bank_accounts are referenced). However, core write operations are largely absent: there is no create_invoice, create_bill, create_contact, update_invoice, or delete_* for most entities, so an agent cannot complete end-to-end bookkeeping workflows. It also lacks a general delete/void path for documents and transactions.

Publisher details

Operator
Agentic Finance Ltd, trading as AccountsOS (UK company 17515543) · Publisher source
Operator website
https://accounts-os.com
Vendor relationship
First-party
Privacy policy
Not provided
Restrictions
Needs an AccountsOS account, signed in with OAuth. Free 14-day trial, then a paid plan. Each user only sees the companies they have access to.

Available Tools

86 tools
add_documentAdd DocumentAInspect

Add a file the user attached in this chat to their AccountsOS books: a bank statement, a receipt, a supplier bill or a sales invoice. AccountsOS reads it the same way as an emailed document: a bank statement is imported into a bank account (created if it does not exist yet), a receipt or bill is read and matched. Use it whenever the user attaches or mentions a financial document and wants it in their books. The result says what was found and what happened.

Inputs: file (required), company.

calculate_vat_periodCalculate Vat PeriodA
Read-onlyIdempotent
Inspect

Preview the 9-box VAT breakdown for a period WITHOUT locking it. Computes the boxes from the period's transactions using the same logic as the VAT page, so the user can review the figures before locking. Use when the user says "what's my VAT for this quarter", "show me the 9 boxes", or before lock_vat_period so they can check first. Read-only: does not change anything.

Inputs: period_id (required), company.

check_companyCheck A UK CompanyA
Read-onlyIdempotent
Inspect

Check a UK limited company on its public Companies House record and show it as a card: when its accounts, confirmation statement and Corporation Tax are due, whether anything is overdue or was filed late, and a score out of 100 with the reasons. Needs no account. Use it whenever someone asks about a UK company's deadlines or standing, for example "when is my confirmation statement due", "are my accounts overdue", "is this company in good standing" or "check my company". Find the number by name with lookup_company first.

Inputs: company_number (required), company.

check_vat_numberCheck Vat NumberA
Read-onlyIdempotent
Inspect

Check a UK VAT registration number against HMRC's live Check-a-UK-VAT-number register and return the registered trader name and address. GB only. A "not registered" answer is a real answer from HMRC, not an error. Use this when the user asks whether a VAT number is valid, when adding or editing a supplier or customer with a VAT number, and when a VAT number appears on a document and the user wants it confirmed. Report the registered name back to the user, and point out when it does NOT match the contact's name: a mismatch is the actual thing worth flagging.

Inputs: vat_number (required), company, contact_id.

compare_salary_dividendsCompare Salary And DividendsA
Read-onlyIdempotent
Inspect

Work out the most tax-efficient mix of salary and dividends for a UK limited company director from the company's profit, against taking it all as salary. An estimate for the current UK tax year. Needs no account.

Inputs: profit (required), company, other_income, has_employment_allowance.

compare_sole_trader_vs_ltdCompare Sole Trader And Limited CompanyA
Read-onlyIdempotent
Inspect

Compare the tax and take-home of trading in the UK as a sole trader against a limited company, at a given profit. An estimate for the current UK tax year. Needs no account.

Inputs: profit (required), company, extra_running_costs.

deel_calculate_employment_costDeel Calculate Employment CostA
Read-onlyIdempotent
Inspect

Calculate the total cost of hiring someone in a specific country through Deel EOR. Use when the user asks "how much would it cost to hire in [country]?" or about employment costs abroad.

Inputs: salary (required), country (required), currency (required), company.

deel_calculate_take_home_payDeel Calculate Take Home PayA
Read-onlyIdempotent
Inspect

Calculate take-home pay for a given salary in a specific country. Use when the user asks about net pay, take-home salary, or deductions in a country.

Inputs: salary (required), country (required), currency (required), company.

deel_get_invoicesDeel Get InvoicesA
Read-onlyIdempotent
Inspect

Get invoices from the user's Deel account. Shows contractor payment invoices. Use when the user asks about Deel payments, contractor invoices, or payment history.

Inputs: limit, company, statuses.

deel_get_payment_receiptsDeel Get Payment ReceiptsA
Read-onlyIdempotent
Inspect

Get payment receipts from Deel showing payments made to contractors. Use when the user asks about specific Deel payments or needs payment proof.

Inputs: limit, company.

deel_get_peopleDeel Get PeopleA
Read-onlyIdempotent
Inspect

List people (contractors and employees) in the user's Deel organization. Use when the user asks about their Deel team, workforce, or contractor list.

Inputs: limit, company.

deel_list_contractsDeel List ContractsA
Read-onlyIdempotent
Inspect

List contracts from the user's Deel account. Use when the user asks about their Deel contracts, contractors, or team members managed through Deel.

Inputs: limit, company, statuses.

estimate_sole_trader_taxEstimate Sole Trader TaxA
Read-onlyIdempotent
Inspect

Estimate the income tax and National Insurance a UK sole trader should set aside, and any payments on account, from their profit. An estimate for the current UK tax year. Needs no account.

Inputs: profit (required), company.

find_duplicate_bank_accountsFind Duplicate Bank AccountsA
Read-onlyIdempotent
Inspect

Find manual bank accounts that look like the same real-world account as a live bank feed (Revolut Business, Starling, Wise, Mercury, Qonto, Airwallex, Stripe Treasury) already connected — the classic case where a user uploaded statements into a manual account, then later connected the live feed for the same account, leaving duplicate transactions that double-count cash and inflate the P&L. Returns candidate pairs with matched/unmatched transaction counts, date ranges, sample matched pairs, and an AI same-account verdict. Use when the user says their cash or balance looks wrong after connecting a bank, mentions a duplicate account, or asks why a P&L looks inflated. Read-only — use merge_bank_accounts to actually merge a pair.

Inputs: company.

get_accounts_statusGet Accounts StatusA
Read-onlyIdempotent
Inspect

Get the status of annual accounts preparation for the current company. Returns the current accounting period, preparation status, and next steps. Use when the user asks about their annual accounts, Companies House filing, year-end accounts, or corporation tax deadline.

Inputs: company.

get_aged_creditorsGet Aged CreditorsA
Read-onlyIdempotent
Inspect

Aged creditors report: outstanding bills grouped by supplier, bucketed by days past due (current/not-yet-due, 1-30, 31-60, 61-90, 90+). Use when the user asks "who do I owe", "what bills are due", "show aged payables", or is planning supplier payments. Read-only.

Inputs: company, as_of_date, contact_id.

get_aged_debtorsGet Aged DebtorsA
Read-onlyIdempotent
Inspect

Aged debtors report: outstanding invoices grouped by contact, bucketed by days past due (current/not-yet-due, 1-30, 31-60, 61-90, 90+). Use when the user asks "who owes me money", "what's in our debtors book", "show aged receivables", or wants to pick which clients to chase. Read-only.

Inputs: company, as_of_date, contact_id.

get_attentionGet AttentionA
Read-onlyIdempotent
Inspect

Return the proactive, ranked list of everything that currently needs the user's attention across their whole account: missing bank statements, unreconciled transactions, upcoming tax/filing deadlines, a month-end ready to close, annual accounts ready to file, overdue invoices to chase, and open tasks. Use whenever the user asks what they need to do, what's outstanding, what's missing, whether anything needs them, for a status check or 'what should I focus on'. Each item includes a plain-English reason and where to fix it. Proactively offer to help with the most important ones.

Inputs: company.

get_balanceGet BalanceC
Read-onlyIdempotent
Inspect

Get current account balance

Inputs: company, account_id.

get_balance_sheetGet Balance SheetC
Read-onlyIdempotent
Inspect

Get Balance Sheet report as at a given date.

Inputs: as_at, company.

get_bank_accountsGet Bank AccountsB
Read-onlyIdempotent
Inspect

List bank accounts connected to the company.

Inputs: company.

get_billsGet BillsB
Read-onlyIdempotent
Inspect

Get supplier bills/invoices owed by the company. Shows what you owe to suppliers.

Inputs: limit, status, company, contact_id.

get_budget_vs_actualGet Budget Vs ActualA
Read-onlyIdempotent
Inspect

Budget vs actual: how the company is doing against its budget. Use when the user asks about budget, against budget, over budget, under budget, budget vs actual, budget variance, are we on track, or how a month, quarter or the year compares with the plan. Returns, for each income, cost of sales and expense account, the budget, the actual from the ledger, the variance (actual minus budget) and the variance percent, plus totals and net profit. Income above budget is good, costs below budget are good. hasBudget false means the company has not set a budget: say so and point them to /reports/budget, never present zeros as a result. Budgets are set on the Reports page, Budget vs actual tab. Quote figures from the result only.

Inputs: company, to_month, from_month.

get_capital_allowance_hintGet Capital Allowance HintA
Read-onlyIdempotent
Inspect

Get a tax capital allowance hint for a fixed asset (book depreciation vs tax relief). GB companies get AIA/WDA guidance from official rates; other countries get a jurisdiction note. Use when the user asks about capital allowances, AIA, or tax relief on a specific asset — not a filing computation.

Inputs: asset_id (required), company.

get_cash_flow_forecastGet Cash Flow ForecastA
Read-onlyIdempotent
Inspect

13-week cash-flow forecast. Returns current bank balance, projected weekly inflows/outflows/running balance for the next 13 weeks, projected low point, recurring patterns detected from history, outstanding invoices expected to clear, recurring invoice projections, and tax deadlines that could draw cash. Also returns tax_set_aside: the tax to keep aside (sales tax owed, the running company tax balance on this year's profit less tax already paid, the recommended set-aside rate and amount when one is saved, and for a company with tax instalments the next instalment, the schedule paid so far against due so far, the balance-due date and the basis). Use when the user asks about cashflow, runway, "can I afford X", "when will I run out", how much to set aside for tax, or their next tax instalment, or wants to plan ahead. Quote the figures it returns; never work out an instalment yourself.

Inputs: company.

get_chart_of_accountsGet Chart Of AccountsA
Read-onlyIdempotent
Inspect

List account categories (chart of accounts). Use when the user asks about their chart of accounts, account codes, or available categories for categorizing transactions. On a national chart an account marked takes_postings: false is a heading with analytic accounts under it: never post, categorise or journal to it, use one of its analytic accounts (the longer codes that start with its code) or add one with create_account_category.

Inputs: type, company.

get_contactsGet ContactsA
Read-onlyIdempotent
Inspect

List contacts (clients, suppliers, leads). Use when user asks about customers, suppliers, or contacts.

Inputs: sort, type, limit, search, +1 more.

get_deadlinesGet DeadlinesA
Read-onlyIdempotent
Inspect

Get upcoming tax and filing deadlines. Each carries support (files, prepares, workpaper, reminder_only, or null for a payment) and support_note: what AccountsOS does for it. reminder_only means AccountsOS does not produce the form.

Inputs: company, include_completed.

get_dividendsGet DividendsA
Read-onlyIdempotent
Inspect

List dividend records. Use when user asks about dividends paid, dividend history, or shareholder payments.

Inputs: limit, company, tax_year.

get_dla_balanceGet Dla BalanceA
Read-onlyIdempotent
Inspect

Get the Director's Loan Account (DLA) balance and recent transactions. Shows if director owes company or vice versa, with section 455 tax warnings.

Inputs: limit, company.

get_estimatesGet EstimatesC
Read-onlyIdempotent
Inspect

Get estimates/quotes sent to clients.

Inputs: limit, status, company, contact_id.

get_expense_claimsGet Expense ClaimsC
Read-onlyIdempotent
Inspect

Get expense claims and reimbursement requests.

Inputs: limit, status, company.

get_expensesGet ExpensesA
Read-onlyIdempotent
Inspect

List expense claims. Use when the user asks about expenses, expense claims, reimbursements, or receipts they have submitted.

Inputs: limit, status, company.

get_filed_accounts_historyGet Filed Accounts HistoryA
Read-onlyIdempotent
Inspect

The year-by-year figures from the accounts this company has filed at Companies House, newest first: balance sheet lines (fixed assets, current assets, creditors, net assets, capital and reserves), average employees, turnover and profit after tax where the filing includes a profit and loss, and the movement in reserves against the previous year (profit after tax less dividends). Use when the user asks how last year or an earlier year went, how the business has grown, what was filed, or wants past figures beside the current books. These are the registry's snapshots, not the ledger: say "as filed" and never blend them with live ledger figures. A micro-entity filing has no turnover or profit; say so rather than treating a null as zero.

Inputs: company.

get_financial_snapshotGet Financial SnapshotA
Read-onlyIdempotent
Inspect

Get the headline money figures in one call: cash, what the company is owed (open invoices), what it owes (open bills), and net profit this month, the EXACT numbers on the user's Home dashboard. Use for "how am I doing", "how much am I owed", "what do I owe", "what's my position", a quick business health check, or any quick headline-figure question. For how a past month went, use get_profit_and_loss for that month. For invoice/bill line-level detail use get_invoices/get_bills; for ageing use get_aged_debtors/get_aged_creditors.

Inputs: company.

get_fixed_assetsGet Fixed AssetsA
Read-onlyIdempotent
Inspect

List fixed assets on the register with cost, net book value, monthly depreciation and status. Returns total_cost, total_accumulated_depreciation and total_nbv for the active assets: quote those, never add the register up yourself. Use when the user asks about their asset register, depreciation schedules, NBV, or capital items tracked per asset. Filter by active, disposed, or all.

Inputs: status, company.

get_fx_ratesGet Fx RatesA
Read-onlyIdempotent
Inspect

Exchange rates: the closing rate for a currency pair on a date, or a series over a range. Use when the user asks for an exchange rate, FX, a currency conversion, what the euro to dirham or pound to dollar rate is, what a currency move cost us, or whether it is cheaper to buy in one currency or another. With one date it returns that day's closing rate. With a range of 62 days or less it returns the daily closing series and the percentage change. Over 62 days it returns monthly averages (up to 36 months). Read-only, needs no company data. Quote rates from the result only.

Inputs: to (required), from (required), date, company, +2 more.

get_gifi_statusGet Gifi StatusA
Read-onlyIdempotent
Inspect

Canada: is my GIFI ready for the T2, which accounts are not mapped or need review, and do the balance checks pass. 'is my GIFI ready', 'GIFI mapping', 'T2 schedule 100 / 125'. Maps any new accounts first. AccountsOS prepares the GIFI trial balance for the accountant's T2 software, it does not prepare or file the T2.

Inputs: as_at, company, year_end.

get_goalsGet GoalsA
Read-onlyIdempotent
Inspect

Get active business/financial goals and their progress. Use when user asks about their goals, targets, or how they are tracking against objectives.

Inputs: status, company, goal_type.

get_gov_guidanceGet Gov GuidanceA
Read-onlyIdempotent
Inspect

Search official GOV.UK tax and business guidance. Use when the user asks "what does HMRC say about X?", asks about tax rules, filing requirements, or wants to know the official guidance on a topic like VAT, corporation tax, dividends, or director responsibilities.

Inputs: topic (required), company.

get_gst_hst_returnGet Gst Hst ReturnA
Read-onlyIdempotent
Inspect

Canada: prepare the GST/HST return (GST34) for a period: 'GST return', 'HST return', 'GST report', 'what do I owe CRA', 'my Q3 GST'. Returns every line (101 to 113C), the balance owing or refund, the due date and any warnings. Defaults to the last completed reporting period. Always use this tool for a Canadian GST/HST figure; never add up a return yourself. AccountsOS prepares the return, it does not file it with CRA. For the return as a PDF, call send_file with kind tax_return_pdf and id start..end: never create_artifact.

Inputs: end, start, company.

get_hmrc_vat_liabilitiesGet Hmrc Vat LiabilitiesA
Read-onlyIdempotent
Inspect

Read the company's VAT liabilities (amounts HMRC says are owed and when they are due) directly from HMRC MTD. Use when the user asks "how much VAT do I owe HMRC", "what's outstanding on my VAT account". Requires HMRC MTD connected.

Inputs: to, from, company.

get_hmrc_vat_obligationsGet Hmrc Vat ObligationsA
Read-onlyIdempotent
Inspect

Read the company's VAT obligations (the returns HMRC expects, with their period keys, start/end dates, due dates, and whether they are Open or Fulfilled) directly from HMRC MTD. Use when the user asks "what does HMRC say I owe a return for", "when is my next VAT return due according to HMRC", or to reconcile our periods against HMRC's record. Requires HMRC MTD connected.

Inputs: to, from, company.

get_hmrc_vat_paymentsGet Hmrc Vat PaymentsA
Read-onlyIdempotent
Inspect

Read the VAT payments HMRC has received on the company's account directly from HMRC MTD. Use when the user asks "has HMRC received my VAT payment", "what VAT have I paid". Requires HMRC MTD connected.

Inputs: to, from, company.

get_income_by_currencyGet Income By CurrencyA
Read-onlyIdempotent
Inspect

Currency-split income (or expense) totals in ONE compact call: face totals grouped by each transaction currency (e.g. EUR face vs GBP face) PLUS the company functional-currency total for the same set. Use when the user asks "total income in EUR and in GBP", "how much came in in euros vs pounds", "income by currency", or wants face vs converted figures before an FX check. Do NOT page get_transactions to sum — this returns aggregates only (no transaction dump). Defaults to money-in (income); pass direction "out" for spend. Covers bank lines only: invoices and ledger revenue are NOT included, and a company with no bank account returns nothing here, which is not "no income". For income as the books record it, use get_profit_and_loss.

Inputs: company, to_date, direction, from_date.

get_incoming_messagesGet Incoming MessagesA
Read-onlyIdempotent
Inspect

Read the company's Incoming inbox: messages that arrived by email, WhatsApp, Slack or Telegram (sender, subject, preview, attachments and their processing status), plus a count of documents still processing or failed. Use whenever the user asks what is waiting in Incoming, whether anything came in, about an email or message someone sent, or before saying Incoming is clear. Documents alone are not the whole inbox: a waiting email with a statement attached is a message.

Inputs: limit, source, company, unread_only, +1 more.

get_integration_statusGet Integration StatusA
Read-onlyIdempotent
Inspect

See every integration for this company and user in one call: what's connected (banks, HMRC MTD, Stripe, Deel, Gmail, WhatsApp, Telegram, Slack, Xero and the rest), what's available but not connected, what is coming soon and cannot be connected yet (coming_soon), and whether data is actually FLOWING through each connected feed (flowing / quiet / error, last event, 7-day event count, error message). Use when the user asks about connections or channels, asks whether or when AccountsOS connects to a named app or service, when something they need for the task at hand is not connected, or when their data looks stale or missing — a dead feed is often the real cause. To OFFER to set one up, end your message with [[connect: provider_id]] on its own line (use the provider id from this tool's result, e.g. [[connect: slack]] or [[connect: mercury]]): it renders a card. OAuth providers start sign-in; API-key providers (Mercury, Stripe, Wise, Qonto, Airwallex, Starling) collect the key on a masked in-thread field. Offer at most one connection per message. Only a provider in not_connected can be offered. One in coming_soon is planned and not live: say it is coming soon, with no date, never offer to connect it, never call it available and never say it is not planned (follow coming_soon_note). When the result carries supplier_bills_address, that is the address the company can give its suppliers so bills arrive straight in its incoming documents (it is made from the company's VAT or tax number); say it when the user asks where suppliers should send invoices. Never ask the user to paste an API key into the chat box — the card collects it, and the key is never returned to you (you only see connected true/false).

Inputs: company.

get_invoicesGet InvoicesA
Read-onlyIdempotent
Inspect

Get invoices the user has raised, with summary stats on outstanding and overdue amounts. Use when user asks about invoices, outstanding payments, or money owed to them.

Inputs: search, status, company, contact_id.

get_journal_entriesGet Journal EntriesB
Read-onlyIdempotent
Inspect

Get General Ledger journal entries. Double-entry accounting records.

Inputs: limit, company, to_date, from_date.

get_month_closeGet Month CloseA
Read-onlyIdempotent
Inspect

Check how 'closed' a month's books are. Returns a close-confidence percentage (share of the month's transactions that are categorised AND reconciled) plus exactly what still needs the founder — uncategorised transactions, categorisations you're unsure about, unreconciled lines, payments missing a receipt, and open VAT. Use when the user asks "is my month done?", "close my books", "what's left for May?", "month-end", or any close/period-end question. Defaults to the last complete month. Surface the returned message; offer to help clear each exception.

Inputs: company, period_start.

get_opportunityGet OpportunityB
Read-onlyIdempotent
Inspect

Get detailed information about a specific pipeline opportunity/deal, including notes and activity history.

Inputs: opportunity_id (required), company.

get_payroll_summaryGet Payroll SummaryA
Read-onlyIdempotent
Inspect

Get year-to-date payroll figures, last run date, and next payment due. Use when user asks about payroll costs, total salary spend, or when the next payroll run is. For a salary, drawings or "what have I paid myself" question read list_employees (the configured salary), this (whether payroll has run) and get_transactions (what left the bank) together: a configured salary with no payroll runs means nothing was paid through payroll, so say that and show what the bank shows.

Inputs: company, tax_year.

get_profit_and_lossGet Profit And LossC
Read-onlyIdempotent
Inspect

Get Profit and Loss (income statement) report for a period.

Inputs: company, to_date, from_date.

get_project_pnlGet Project PnlA
Read-onlyIdempotent
Inspect

Get a deal/project's mini P&L: income, costs by category, and net margin, computed from bank transactions linked to it, plus invoice/bill/expense-claim commitment summaries. Use for "how is project X doing", "project profit", "mini P&L for a project", and for the final report when a project completes. Pass project_id if known, or project_name to resolve it by name.

Inputs: company, project_id, project_name.

get_projectsGet ProjectsA
Read-onlyIdempotent
Inspect

List projects (pipeline, active, completed). Use when the user asks about their projects, deals, or pipeline.

Inputs: search, status, company.

get_qfzp_statusGet Qfzp StatusA
Read-onlyIdempotent
Inspect

Get the active company's QFZP (Qualifying Free Zone Person) status for UAE Corporate Tax. Returns the qualifying/non-qualifying income split, de minimis status (ok / warning / breach), free zone name, substance declaration state, and per-zone smart hints (e.g. audited accounts requirement, designated zone VAT, trade license expiry). Returns applicable: false for UK or UAE mainland companies. Use when the user asks about QFZP status, whether they still qualify, their de minimis headroom, or whether they'll owe 9% CT.

Inputs: company.

get_reconciliation_statusGet Reconciliation StatusA
Read-onlyIdempotent
Inspect

Reconciliation per bank account: every uploaded statement with its own opening and closing balance as printed, the books' balance at its end date, the difference and whether they agree (month by month), plus the unreconciled transaction count and the newest unreconciled lines. Use it for "does the bank agree?", "what was the closing balance in March?", before quoting any reconciliation difference, when the user asks to check the books against the bank statements, or about reconciliation progress. This tool only reads: to actually reconcile ("reconcile what you can", "match the receipts", "reconcile my bank") call auto_match_receipts, which does the matching. Never say everything is reconciled without a result from this tool, get_attention or auto_match_receipts. Never say you cannot read balances off statements. Each statement row carries period_start, period_end, opening_balance, closing_balance, book_balance_at_end, difference, agrees and document_id. Pass bank_account_id to look at one account. It also lists who changed matched marks in the last 7 days, as the audit log records it (the user on the app pages, another person, Finn, a connected AI app, or not recorded), with times and counts: read that before explaining why a count moved, and never put a change down to something unknown when it is listed. Where a change is listed as not recorded, say the log does not record who made it: never call it automatic and never guess. It also gives the link to download the reconciliation report (PDF or Excel), the report to give an accountant who asks for one.

Inputs: company, bank_account_id.

get_recurring_invoicesGet Recurring InvoicesA
Read-onlyIdempotent
Inspect

List recurring invoice templates. Use when user asks about recurring invoices, scheduled invoices, or subscription billing.

Inputs: status, company.

get_risk_flagsGet Risk FlagsA
Read-onlyIdempotent
Inspect

List the entries Finn flagged for a second look before they reach a VAT return: suspect or duplicate receipts and invoices, VAT added to a zero-rated purchase, VAT that does not fit the total, personal-looking purchases and amounts out of line with a supplier. Use when the user asks about flagged, suspect, duplicate or odd entries, or when get_attention shows entries needing a second look. Each flag has entity_type, entity_id, label, severity, title and detail.

Inputs: company.

get_statement_checksGet Statement ChecksA
Read-onlyIdempotent
Inspect

Each imported bank statement against the books: the statement's period, its opening and closing balance as printed, the book balance on the statement's end date, the difference and whether they agree. Use this to answer 'does the bank agree?', 'what was the closing balance in March?', or before quoting any reconciliation difference. Optional bank_account_id.

Inputs: company, bank_account_id.

get_tasksGet TasksC
Read-onlyIdempotent
Inspect

Get tasks and to-dos for the company.

Inputs: limit, company, priority, completed.

get_tax_factsGet Tax FactsA
Read-onlyIdempotent
Inspect

Look up current UK tax rates, thresholds and allowances (income_tax, national_insurance, corporation_tax, dividends, capital_allowances, vat, pensions, mileage, self_assessment, home_office, mtd). Returns the figure plus its source.

Inputs: category (required), item, company, tax_year.

get_transactionsGet TransactionsA
Read-onlyIdempotent
Inspect

Get transactions for the company with optional filters. Returns currency, amount_gbp and exchange_rate. A row with expected_income: true is an uploaded sales invoice still waiting to be paid, NOT money received: leave it out of any cash, income received or bank balance figure. For currency-split income totals prefer get_income_by_currency.

Inputs: limit, offset, search, company, +9 more.

get_trial_balanceGet Trial BalanceB
Read-onlyIdempotent
Inspect

Get Trial Balance showing all account balances.

Inputs: company, to_date, from_date.

get_vat_periodsGet Vat PeriodsA
Read-onlyIdempotent
Inspect

List the company's VAT return periods and their status (open, locked, submitted, failed, overdue), with the net VAT due, due date, and HMRC receipt for any submitted ones. Use this FIRST when the user asks about VAT returns, "which quarters are outstanding", "have I filed Q1", or before calculating/locking/submitting — it gives you the period_id you need for the other VAT tools.

Inputs: year, limit, status, company.

get_vat_summaryGet Vat SummaryA
Read-onlyIdempotent
Inspect

Get VAT summary for a calendar quarter, or for any VAT period with start_date and end_date

Inputs: company, quarter, end_date, start_date.

get_year_on_yearGet Year On YearA
Read-onlyIdempotent
Inspect

How this year compares with last year and the years before: are we up or down on last year, revenue and profit trend, margin, cash at year end, year on year, same time last year, how did last year go. Returns the completed years (from the ledger or the filed accounts), the current year to date against the same months last year, and Finn's read of the trend. Use it before any 'how are we doing', planning or forecasting answer when the company has history.

Inputs: company.

list_categoriesList CategoriesB
Read-onlyIdempotent
Inspect

List available transaction categories for categorization

Inputs: type, company.

list_companiesList CompaniesA
Read-onlyIdempotent
Inspect

List the companies this AccountsOS account can see (for an accountancy practice, its clients), with the default one marked. Call this first when the user has more than one company, then pass company to the other tools.

Inputs: no named parameters.

list_employeesList EmployeesA
Read-onlyIdempotent
Inspect

List active employees for the company. Use when the user asks about their employees, staff, team members, or headcount.

Inputs: company, include_inactive.

list_opportunitiesList OpportunitiesB
Read-onlyIdempotent
Inspect

List sales pipeline opportunities/deals. Shows prospects, their stage, value, and next actions.

Inputs: limit, stage, status, company.

list_tax_rulesList Tax RulesA
Read-onlyIdempotent
Inspect

List the verified tax and accounting rules AccountsOS holds for a country, with their keys and summaries: VAT or GST, company tax, income tax, payroll and deadlines. Needs no account: pass country. Use it for any tax question about a named country.

Inputs: company, country, category.

lookup_companyLookup CompanyA
Read-onlyIdempotent
Inspect

Look up a UK company on Companies House: search by name to find candidates, or fetch one by its number for the public record, its directors and its filing dates. Needs no account. Without an account it is UK only.

Inputs: query, company, company_number.

lookup_tax_ruleLookup Tax RuleA
Read-onlyIdempotent
Inspect

Look up a verified tax or accounting rule by its key, for any of the 32 countries AccountsOS covers. Needs no account: pass country. Call list_tax_rules first to find the keys. If the country is not covered it says so, and you must not quote another country's rules instead.

Inputs: key (required), as_of, company, country.

month_close_summaryMonth Close SummaryA
Read-onlyIdempotent
Inspect

Composite read returning everything needed to close a month in one call: P&L for the period, balance-sheet snapshot at period end, VAT summary if registered, unreconciled transaction count, outstanding invoices, and overdue deadlines. Use when the user asks about month-end, "how did we do in [month]", a period close, or wants a one-shot business health view. It saves several round-trips compared to calling each report tool separately.

Inputs: company, period_end, period_start.

read_company_wikiRead Company WikiA
Read-onlyIdempotent
Inspect

Read a page from this company's private memory wiki — Finn's long-term per-company notes (preferences, decisions, people, recurring Q&A). Call with slug="index" first to list available pages.

Inputs: slug, company.

read_wikiRead WikiA
Read-onlyIdempotent
Inspect

Read a page from Finn's knowledge base — compiled UK (and US) tax and accounting guidance: rules, cross-references, edge cases, plain-English advice for company directors. Call with page="index" first to list all available pages.

Inputs: page (required), company.

recall_conversationsRecall ConversationsA
Read-onlyIdempotent
Inspect

Recall what you and the user discussed in PAST conversations (across earlier sessions, including voice and video calls). Call this whenever the user asks "what were we talking about last time?", "remind me what we discussed", "where did we leave off?", "what did we cover yesterday?", or refers back to an earlier chat. Returns recent conversation summaries newest-first — each with a short summary, the key topics, any decisions made, and open action items, plus when it happened. ALWAYS call this before saying you don't remember — you DO have access to past conversations through this tool. (Distinct from read_company_wiki, which is curated durable facts, not the back-and-forth of past chats.)

Inputs: to, from, limit, query, +1 more.

search_company_wikiSearch Company WikiA
Read-onlyIdempotent
Inspect

Search this company's private memory wiki by keyword. Returns matching page slugs, titles and excerpts.

Inputs: query (required), company.

search_documentsSearch DocumentsA
Read-onlyIdempotent
Inspect

Search uploaded documents (receipts, invoices). Can also list documents by status without a query — status ["pending", "error"] is the Incoming queue. Called with no arguments it lists the newest uploads (up to 25).

Inputs: type, query, status, company.

search_tax_factsSearch Tax FactsA
Read-onlyIdempotent
Inspect

Search UK tax knowledge by keyword when unsure which category/item to look up. Returns matching tax facts across all categories.

Inputs: query (required), company, tax_year.

search_wikiSearch WikiA
Read-onlyIdempotent
Inspect

Search Finn's knowledge base by keyword. Returns matching page names and excerpts. Use when unsure which page covers a topic.

Inputs: query (required), company.

update_companySet Up CompanyA
DestructiveIdempotent
Inspect

Save the user's answers about their own business to their AccountsOS company: what kind of business it is (entity_type, for example sole_trader or ltd), the country it is registered in (ISO code such as GB, IE, US), the company or registration number, the name, what it does, the currency, the year-end month and VAT registration. Use it during setup, and when the user corrects one of these details. For a UK or Irish limited company with a registration number, call lookup_company and then link_company instead, which fills everything from the official register. Only pass what the user told you; never guess.

Inputs: name, company, country, vat_number, +8 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      Enables AI assistants to query and manage self-hosted accounting data—invoices, balances, and books—through natural language, with read-only tools by default and optional scoped write operations.
      30
      27 PyPI
      1
      AGPL 3.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables an AI client to query and do bookkeeping across all of a user's Xero organisations, Zoho Books organisations and FreeAgent companies through one connector, from invoices, bills, bank transactions and reports to creating and updating records. Read-only and write tools plus ready-made prompts cover cash balances, month-end checks and who owes whom, all across companies at once.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to query a connected accounting platform for organisations, invoices, contacts, chart of accounts, and profit-and-loss reports, supporting bookkeeping, AR/AP, and financial reporting workflows.
      83 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables natural-language interaction with Xero accounting data, including invoices and intents, with role-based access control and audit trail.
      176 npm
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.

    Resources