AccountsOS MCP Server
OfficialQuery and act on a live AccountsOS ledger from any MCP client — read financials, manage records, file VAT, and pull verified tax guidance.
Transactions & balances: query/filter/create/update transactions, get balances, categorize, list chart of accounts and categories
Financial reports: P&L, balance sheet, trial balance, journal entries, cash-flow forecast, month-close summaries, financial snapshot
Invoices & receivables: list invoices, recurring invoices, aged debtors, estimates
Bills & payables: list/create/pay supplier bills, aged creditors
Contacts, projects & pipeline: manage contacts, projects and their mini P&L, opportunities/deals, notes and stages
Operations: tasks, goals, expense claims, employees, payroll summary, fixed assets and capital allowances, dividends, filed accounts history
Banking: list bank accounts, reconciliation status, duplicate-account detection
VAT & HMRC MTD: VAT periods and 9-box previews, HMRC obligations/liabilities/payments, VAT number checks
Tax knowledge: read/search tax facts, wiki and company wiki, lookup/list verified tax rules, GOV.UK guidance, QFZP status
Documents: upload, search, and link receipts/invoices to entities
Integrations: view connection and data-flow status; Deel contracts, invoices, payments, and employment/take-home cost calculators
Memory & admin: recall past conversations, company lookup on Companies House, get attention items, reopen month close
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@AccountsOS MCP Server What's my VAT summary for the last quarter?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
AccountsOS MCP Server
Query your live AccountsOS ledger from any MCP client (Claude Desktop, Claude Code, Cursor) via the Model Context Protocol.
AccountsOS runs jurisdiction playbooks for 26 countries. The UK is the proof jurisdiction, with live HMRC MTD VAT filing.
npm: https://www.npmjs.com/package/@thriveventurelabs/accountsos-mcp
Installation
Option 1: Global Install (Recommended)
npm install -g @thriveventurelabs/accountsos-mcpThen add to Claude Desktop config:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"accountsos": {
"command": "accountsos-mcp",
"args": [],
"env": {
"ACCOUNTSOS_API_KEY": "your-api-key-here"
}
}
}
}Option 2: Using npx
{
"mcpServers": {
"accountsos": {
"command": "npx",
"args": ["--yes", "@thriveventurelabs/accountsos-mcp@latest"],
"env": {
"ACCOUNTSOS_API_KEY": "your-api-key-here"
}
}
}
}Get your API key from AccountsOS Settings.
Related MCP server: odoo-bookkeeping-mcp
Available Tools
Read Operations
Tool | Description |
| Query transactions with filters (date, category, amount, search) |
| Get current account balance(s) |
| View upcoming tax and filing deadlines |
| Get VAT summary for any quarter |
| Search uploaded receipts and invoices |
| List available UK GAAP transaction categories |
Write Operations
Tool | Description |
| Create a new transaction (with auto-categorization) |
| Update category, notes, or reconciliation status |
| Get AI-suggested category for a transaction |
| Create a new tax/filing deadline reminder |
Available Resources
Resource | Description |
| Company details and settings |
| Most recent 50 transactions |
| Uploaded documents |
| Upcoming deadlines |
Example Prompts
Once connected, try asking Claude:
"What's my account balance?"
"Show me transactions from last month"
"When is my next VAT deadline?"
"How much have I spent on software subscriptions?"
"Create a transaction for lunch with a client, £45"
"What's my VAT summary for Q4 2024?"
Development
# Install dependencies
npm install
# Build
npm run build
# Run locally (for testing)
ACCOUNTSOS_API_KEY=sk_live_xxx npm startEnvironment Variables
Variable | Required | Description |
| Yes | Your AccountsOS API key |
| No | Override API base URL (default: https://accounts-os.com) |
Troubleshooting
Server disconnected
Check logs at ~/Library/Logs/Claude/mcp-server-accountsos.log
npx issues
If npx has caching issues, use global install instead:
npm install -g @thriveventurelabs/accountsos-mcpDisclaimer
This software provides general guidance about UK tax and accounting rules. It is not a substitute for professional advice from a qualified accountant or tax adviser. Always verify with HMRC source documents and consult a professional for advice specific to your circumstances.
License
MIT
Available Tools
86 toolsadd_opportunity_noteAdd Opportunity NoteBInspect
Add a note or activity log to a pipeline opportunity.
Inputs: content (required), opportunity_id (required), type.
calculate_vat_periodCalculate Vat PeriodARead-onlyIdempotentInspect
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).
categorize_transactionCategorize TransactionBIdempotentInspect
Suggest a category for a transaction
Inputs: transaction_id (required).
check_vat_numberCheck Vat NumberARead-onlyIdempotentInspect
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), contact_id.
create_billCreate BillBInspect
Record a supplier bill/invoice that the company owes.
Inputs: items (required), due_date (required), bill_date (required), contact_id (required), +2 more.
create_contactCreate ContactAInspect
Create a new contact (client, supplier, lead).
Inputs: name (required), type, email, notes, +2 more.
create_deadlineCreate DeadlineBInspect
Create a new tax or filing deadline
Inputs: type (required), due_date (required), period_end, description, +1 more.
create_estimateCreate EstimateBInspect
Create a new estimate/quote for a client.
Inputs: items (required), contact_id (required), estimate_date (required), notes, +1 more.
create_opportunityCreate OpportunityAInspect
Create a new sales pipeline opportunity/deal.
Inputs: name (required), notes, value, source, +4 more.
create_taskCreate TaskBInspect
Create a new task or to-do item.
Inputs: title (required), type, due_date, priority, +1 more.
create_transactionCreate TransactionCInspect
Create a new transaction manually
Inputs: date (required), amount (required), direction (required), description (required), +4 more.
deel_calculate_employment_costDeel Calculate Employment CostARead-onlyIdempotentInspect
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).
deel_calculate_take_home_payDeel Calculate Take Home PayARead-onlyIdempotentInspect
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).
deel_get_invoicesDeel Get InvoicesARead-onlyIdempotentInspect
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, statuses.
deel_get_payment_receiptsDeel Get Payment ReceiptsARead-onlyIdempotentInspect
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.
deel_get_peopleDeel Get PeopleARead-onlyIdempotentInspect
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.
deel_list_contractsDeel List ContractsARead-onlyIdempotentInspect
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, statuses.
delete_projectDelete ProjectADestructiveIdempotentInspect
Delete an empty project/deal. Refuses if transactions, invoices, bills or other records are still linked.
Inputs: project_id, project_name.
find_duplicate_bank_accountsFind Duplicate Bank AccountsARead-onlyIdempotentInspect
Find manual bank accounts that look like the same real-world account as a live bank feed (Revolut Business, Starling, Wise, Mercury, Qonto, 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: no named parameters.
get_accounts_statusGet Accounts StatusARead-onlyIdempotentInspect
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: no named parameters.
get_aged_creditorsGet Aged CreditorsARead-onlyIdempotentInspect
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: as_of_date, contact_id.
get_aged_debtorsGet Aged DebtorsARead-onlyIdempotentInspect
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: as_of_date, contact_id.
get_attentionGet AttentionARead-onlyIdempotentInspect
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: no named parameters.
get_balanceGet BalanceBRead-onlyIdempotentInspect
Get current account balance
Inputs: account_id.
get_balance_sheetGet Balance SheetBRead-onlyIdempotentInspect
Get Balance Sheet report as at a given date.
Inputs: as_at.
get_bank_accountsGet Bank AccountsARead-onlyIdempotentInspect
List bank accounts connected to the company.
Inputs: no named parameters.
get_billsGet BillsARead-onlyIdempotentInspect
Get supplier bills/invoices owed by the company. Shows what you owe to suppliers.
Inputs: limit, status, contact_id.
get_capital_allowance_hintGet Capital Allowance HintARead-onlyIdempotentInspect
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).
get_cash_flow_forecastGet Cash Flow ForecastARead-onlyIdempotentInspect
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. Use when the user asks about cashflow, runway, "can I afford X", "when will I run out", or wants to plan ahead.
Inputs: no named parameters.
get_chart_of_accountsGet Chart Of AccountsARead-onlyIdempotentInspect
List account categories (chart of accounts). Use when the user asks about their chart of accounts, account codes, or available categories for categorizing transactions.
Inputs: type.
get_contactsGet ContactsARead-onlyIdempotentInspect
List contacts (clients, suppliers, leads). Use when user asks about customers, suppliers, or contacts.
Inputs: type, limit, search.
get_deadlinesGet DeadlinesBRead-onlyIdempotentInspect
Get upcoming tax and filing deadlines
Inputs: include_completed.
get_dividendsGet DividendsARead-onlyIdempotentInspect
List dividend records. Use when user asks about dividends paid, dividend history, or shareholder payments.
Inputs: limit, tax_year.
get_dla_balanceGet Dla BalanceARead-onlyIdempotentInspect
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.
get_document_linksGet Document LinksARead-onlyIdempotentInspect
Get all documents linked to an entity (transaction, invoice, bill, estimate, contact, project, expense claim), or all entities linked to a document. Use when user asks "what documents are attached to this invoice?" or "show me what's linked to that receipt".
Inputs: entity_id, document_id, entity_type.
get_estimatesGet EstimatesBRead-onlyIdempotentInspect
Get estimates/quotes sent to clients.
Inputs: limit, status, contact_id.
get_expense_claimsGet Expense ClaimsBRead-onlyIdempotentInspect
Get expense claims and reimbursement requests.
Inputs: limit, status.
get_expensesGet ExpensesARead-onlyIdempotentInspect
List expense claims. Use when the user asks about expenses, expense claims, reimbursements, or receipts they have submitted.
Inputs: limit, status.
get_filed_accounts_historyGet Filed Accounts HistoryARead-onlyIdempotentInspect
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: no named parameters.
get_financial_snapshotGet Financial SnapshotARead-onlyIdempotentInspect
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", or any quick headline-figure question. For invoice/bill line-level detail use get_invoices/get_bills; for ageing use get_aged_debtors/get_aged_creditors.
Inputs: no named parameters.
get_fixed_assetsGet Fixed AssetsARead-onlyIdempotentInspect
List fixed assets on the register with cost, net book value, monthly depreciation and status. 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.
get_goalsGet GoalsARead-onlyIdempotentInspect
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, goal_type.
get_gov_guidanceGet Gov GuidanceARead-onlyIdempotentInspect
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).
get_hmrc_vat_liabilitiesGet Hmrc Vat LiabilitiesARead-onlyIdempotentInspect
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.
get_hmrc_vat_obligationsGet Hmrc Vat ObligationsARead-onlyIdempotentInspect
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.
get_hmrc_vat_paymentsGet Hmrc Vat PaymentsARead-onlyIdempotentInspect
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.
get_income_by_currencyGet Income By CurrencyARead-onlyIdempotentInspect
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.
Inputs: to_date, direction, from_date.
get_integration_statusGet Integration StatusARead-onlyIdempotentInspect
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, 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, 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, Starling) collect the key on a masked in-thread field. Offer at most one connection per message. 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: no named parameters.
get_invoicesGet InvoicesARead-onlyIdempotentInspect
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, contact_id.
get_journal_entriesGet Journal EntriesCRead-onlyIdempotentInspect
Get General Ledger journal entries. Double-entry accounting records.
Inputs: limit, to_date, from_date.
get_month_closeGet Month CloseARead-onlyIdempotentInspect
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: period_start.
get_opportunityGet OpportunityARead-onlyIdempotentInspect
Get detailed information about a specific pipeline opportunity/deal, including notes and activity history.
Inputs: opportunity_id (required).
get_payroll_summaryGet Payroll SummaryARead-onlyIdempotentInspect
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.
Inputs: tax_year.
get_profit_and_lossGet Profit And LossBRead-onlyIdempotentInspect
Get Profit and Loss (income statement) report for a period.
Inputs: to_date, from_date.
get_project_pnlGet Project PnlARead-onlyIdempotentInspect
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: project_id, project_name.
get_projectsGet ProjectsARead-onlyIdempotentInspect
List projects (pipeline, active, completed). Use when the user asks about their projects, deals, or pipeline.
Inputs: search, status.
get_qfzp_statusGet Qfzp StatusARead-onlyIdempotentInspect
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: no named parameters.
get_reconciliation_statusGet Reconciliation StatusARead-onlyIdempotentInspect
Show unreconciled transaction count per bank account. Use when the user asks about reconciliation progress, unreconciled transactions, or bank account status.
Inputs: no named parameters.
get_recurring_invoicesGet Recurring InvoicesARead-onlyIdempotentInspect
List recurring invoice templates. Use when user asks about recurring invoices, scheduled invoices, or subscription billing.
Inputs: status.
get_tasksGet TasksCRead-onlyIdempotentInspect
Get tasks and to-dos for the company.
Inputs: limit, priority, completed.
get_tax_factsGet Tax FactsARead-onlyIdempotentInspect
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, tax_year.
get_transactionsGet TransactionsARead-onlyIdempotentInspect
Get transactions for the company with optional filters. Returns currency, amount_gbp and exchange_rate. For currency-split income totals prefer get_income_by_currency.
Inputs: limit, offset, search, to_date, +5 more.
get_trial_balanceGet Trial BalanceBRead-onlyIdempotentInspect
Get Trial Balance showing all account balances.
Inputs: to_date, from_date.
get_vat_periodsGet Vat PeriodsARead-onlyIdempotentInspect
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.
get_vat_summaryGet Vat SummaryBRead-onlyIdempotentInspect
Get VAT summary for a quarter
Inputs: quarter.
list_categoriesList CategoriesBRead-onlyIdempotentInspect
List available transaction categories for categorization
Inputs: type.
list_employeesList EmployeesARead-onlyIdempotentInspect
List active employees for the company. Use when the user asks about their employees, staff, team members, or headcount.
Inputs: include_inactive.
list_opportunitiesList OpportunitiesBRead-onlyIdempotentInspect
List sales pipeline opportunities/deals. Shows prospects, their stage, value, and next actions.
Inputs: limit, stage, status.
list_tax_rulesList Tax RulesARead-onlyIdempotentInspect
List all available verified tax/accounting rule keys for the active company's country (UK or UAE), optionally filtered by category. Use this when you need to find the right key for lookup_tax_rule.
Inputs: category.
lookup_companyLookup CompanyARead-onlyIdempotentInspect
Look up a UK company on Companies House — search by name to find candidates, or fetch a single company by its number to get the full public record (registered name, number, status, incorporation date, registered office address, SIC codes, directors/officers, and filing deadlines). Use this during onboarding to find and confirm the user's company ("is this your company?") and to see who the directors are. Read-only — it does NOT save anything; use link_company to save the confirmed company. UK only (Companies House); for non-UK companies, ask the user for their details directly.
Inputs: query, company_number.
lookup_tax_ruleLookup Tax RuleARead-onlyIdempotentInspect
Look up a verified tax or accounting rule by its key. The system automatically routes to the correct country library (UK or UAE) based on the active company. Use this for ANY question about specific deadlines, thresholds, notice periods, regulatory dates, or rules where being wrong would mislead the user. UK examples: vat-registration-threshold, ct-filing-deadline, mtd-itsa-mandatory-50k, dividend-allowance-2026-27, mileage-rates-2026-27. UAE examples: ct-rates, ct-filing-deadline, vat-rate, free-zone-qfzp, no-personal-income-tax. Returns the exact answer + an official source URL you MUST cite in your reply, and where the rule has a validity period, the dates it applies between. ALWAYS prefer this over stating a rule from memory. For a question about a PAST period, pass as_of so you get the rule that applied then rather than the current one. If you do not know the exact key, call list_tax_rules first.
Inputs: key (required), as_of.
month_close_summaryMonth Close SummaryARead-onlyIdempotentInspect
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 — saves several round-trips compared to calling each report tool separately.
Inputs: period_end, period_start.
pay_billPay BillBDestructiveInspect
Record a payment against a bill.
Inputs: amount (required), bill_id (required), payment_date (required), payment_method.
read_company_wikiRead Company WikiARead-onlyIdempotentInspect
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.
read_wikiRead WikiARead-onlyIdempotentInspect
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).
recall_conversationsRecall ConversationsARead-onlyIdempotentInspect
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: limit, query.
reopen_month_closeReopen Month CloseADestructiveIdempotentInspect
Undo a month-end close so the founder can make further changes. Use when the user asks to "reopen", "unlock" or "undo the close" for a month that's already closed. Closing a month doesn't post anything to the ledger, so reopening is a pure status change — no reversal needed. Refuses if a VAT return already submitted to HMRC covers the same period (editing filed data isn't safe; that needs a VAT adjustment instead). Confirmation-gated.
Inputs: period_start.
search_company_wikiSearch Company WikiARead-onlyIdempotentInspect
Search this company's private memory wiki by keyword. Returns matching page slugs, titles and excerpts.
Inputs: query (required).
search_documentsSearch DocumentsARead-onlyIdempotentInspect
Search uploaded documents (receipts, invoices). Can also list documents by status without a query — status ["pending", "error"] is the Incoming queue.
Inputs: type, query, status.
search_tax_factsSearch Tax FactsARead-onlyIdempotentInspect
Search UK tax knowledge by keyword when unsure which category/item to look up. Returns matching tax facts across all categories.
Inputs: query (required), tax_year.
search_wikiSearch WikiARead-onlyIdempotentInspect
Search Finn's knowledge base by keyword. Returns matching page names and excerpts. Use when unsure which page covers a topic.
Inputs: query (required).
update_opportunity_stageUpdate Opportunity StageBDestructiveIdempotentInspect
Move an opportunity to a different pipeline stage (e.g., from Lead to Proposal).
Inputs: stage_id (required), opportunity_id (required), next_action, next_action_at.
update_projectUpdate ProjectADestructiveIdempotentInspect
Rename a project/deal, or change its notes, contact, or status.
Inputs: name, notes, status, contact_id, +2 more.
update_transactionUpdate TransactionBDestructiveIdempotentInspect
Update a transaction (category, notes, reconciliation status)
Inputs: transaction_id (required), notes, direction, reconciled, +2 more.
upload_documentUpload DocumentBInspect
Upload a document (receipt, invoice, bank statement) for processing. The document will be analyzed by AI to extract data.
Inputs: file_data (required), file_name (required), document_type.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 86 tools
The tool set is large and includes several pairs that overlap in purpose, such as get_expenses vs get_expense_claims, get_projects vs list_opportunities/get_opportunity, and get_document_links vs find_related_documents. However, the detailed descriptions with explicit 'use when' guidance help disambiguate most cases, so an agent can usually select correctly.
The vast majority of tools follow a consistent verb_noun snake_case convention (get_, create_, update_, search_, read_, etc.), with a predictable prefixed group (deel_*). Minor deviations like month_close_summary (a noun-first compound) and the mixed use of list_ vs get_ for similar resources keep it from being perfect, but the pattern is still highly readable.
86 tools is an extreme count by any standard, far exceeding the typical well-scoped MCP server. While the accounting domain is broad, this number will overwhelm agents and increase selection latency and error rates; the scope could be consolidated into fewer, more composite tools without losing capability.
The tool surface covers an impressively wide domain: VAT, payroll, invoicing, expenses, projects, bank feeds, HMRC integrations, document management, tax rules, and annual accounts. There are minor gaps such as no update/delete for invoices or bills and no ability to create a recurring invoice, but these are generally workable around given the read-heavy nature of the use cases.
Maintenance
Related MCP Connectors
Headless API-first double-entry accounting & bookkeeping engine. 84 MCP tools over HTTP.
Query your real net worth, spending, transactions, budgets and portfolio from any MCP client.
Read-only MCP server for Point (Tetra M Labs): demo ledger, trial balance, partners.
Review accounting data and available financial records within your authorized workspace. This listing retains the complete 18-tool Accounting service and its existing full endpoint. For new tasks, start with Samuelz® Accounting · Evidence checks. Choose from Evidence checks, Individual reminder, Cost allocation, Existing reminder run at https://platform.samuelz.com/integrations?lang=en#accounting. Each task view is a subset, not a replacement for the full service. Existing URLs and conversations keep working. Changing views grants no additional rights and does not migrate a running conversation. Prepared operations keep their identity and approval requirements; read their status before any recovery. Setup: In a remote MCP client that supports Streamable HTTP and OAuth, add https://platform.samuelz.com/api/v1/mcp/operator?toolset=accounting. Sign in to Samuelz and select your authorized workspace. Active workspace membership and the relevant module permissions are required. Review requested permissions before authorizing. Existing human approvals and separate cost permissions continue to apply.
Related MCP Servers
- FlicenseAqualityDmaintenanceProvides double-entry accounting ledger creation, transaction recording, and financial reporting capabilities via MCP.7-
- AlicenseBqualityDmaintenanceMCP server that provides full read/write access to Odoo accounting data including invoices, vendor bills, journal entries, payments, reconciliation, and financial reports, as well as BOQ/Project Budget data when available.34MIT
- FlicenseNot gradedqualityCmaintenanceEnables MCP clients to search and inspect an invoice ledger, generate VAT summaries, run OCR on local documents, and use reusable prompts for chasing overdue invoices and reconciling entries.2-

epago MCP Serverofficial
AlicenseNot gradedqualityCmaintenanceEnables MCP-capable clients to read and write directly in epago accounting, including chart of accounts, transactions, invoices, payments, receipts, and tax reports.MIT