{"id":"io.github.paulgosnell/accountsos-mcp","slug":"io-github-paulgosnell-accountsos-mcp","title":"AccountsOS","description":"Query your live AccountsOS books: balances, transactions, VAT, deadlines, invoices.","version":"0.3.2","publisher":{"kind":"github","id":"paulgosnell","label":"@paulgosnell on GitHub","url":"https://github.com/paulgosnell"},"website":"https://accounts-os.com","repository":"https://github.com/thriveventurelabs/accountsos-mcp-server","remotes":[{"type":"streamable-http","url":"https://accounts-os.com/api/mcp/plugin"}],"packages":[{"registryType":"npm","identifier":"@thriveventurelabs/accountsos-mcp","version":"0.3.1","transport":{"type":"stdio"},"environmentVariables":[{"description":"Your AccountsOS API key (from https://accounts-os.com/settings)","isRequired":true,"format":"string","isSecret":true,"name":"ACCOUNTSOS_API_KEY"},{"description":"Override API base URL (default https://accounts-os.com)","format":"string","name":"ACCOUNTSOS_BASE_URL"}]}],"published":"2026-10-28","updated":"2026-10-28","status":"online","auth":"","latency_ms":1166,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"list_companies","title":"List Companies","description":"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.","read_only":true},{"name":"update_company","title":"Set Up Company","description":"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.","read_only":false},{"name":"link_company","title":"Link Company From Register","description":"Save a UK (Companies House) or Irish (CRO) company from its official register onto the user's AccountsOS company: registered name, number, status, address, directors, year-end and filing deadlines. Call it only after lookup_company found the company and the user confirmed it is theirs. Returns the year-end and the deadlines it set up: tell the user what they are.","read_only":false},{"name":"add_document","title":"Add Document","description":"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 th","read_only":false},{"name":"check_company","title":"Check A UK Company","description":"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 ac","read_only":true},{"name":"compare_salary_dividends","title":"Compare Salary And Dividends","description":"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.","read_only":true},{"name":"compare_sole_trader_vs_ltd","title":"Compare Sole Trader And Limited Company","description":"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.","read_only":true},{"name":"estimate_sole_trader_tax","title":"Estimate Sole Trader Tax","description":"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.","read_only":true},{"name":"get_transactions","title":"Get Transactions","description":"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.","read_only":true},{"name":"get_balance","title":"Get Balance","description":"Get current account balance","read_only":true},{"name":"get_deadlines","title":"Get Deadlines","description":"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.","read_only":true},{"name":"get_vat_summary","title":"Get Vat Summary","description":"Get VAT summary for a calendar quarter, or for any VAT period with start_date and end_date","read_only":true},{"name":"search_documents","title":"Search Documents","description":"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).","read_only":true},{"name":"read_wiki","title":"Read Wiki","description":"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.","read_only":true},{"name":"search_wiki","title":"Search Wiki","description":"Search Finn's knowledge base by keyword. Returns matching page names and excerpts. Use when unsure which page covers a topic.","read_only":true},{"name":"read_company_wiki","title":"Read Company Wiki","description":"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.","read_only":true},{"name":"search_company_wiki","title":"Search Company Wiki","description":"Search this company's private memory wiki by keyword. Returns matching page slugs, titles and excerpts.","read_only":true},{"name":"get_tax_facts","title":"Get Tax Facts","description":"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.","read_only":true},{"name":"search_tax_facts","title":"Search Tax Facts","description":"Search UK tax knowledge by keyword when unsure which category/item to look up. Returns matching tax facts across all categories.","read_only":true},{"name":"list_categories","title":"List Categories","description":"List available transaction categories for categorization","read_only":true},{"name":"get_dla_balance","title":"Get Dla Balance","description":"Get the Director's Loan Account (DLA) balance and recent transactions. Shows if director owes company or vice versa, with section 455 tax warnings.","read_only":true},{"name":"get_invoices","title":"Get Invoices","description":"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.","read_only":true},{"name":"get_contacts","title":"Get Contacts","description":"List contacts (clients, suppliers, leads). Use when user asks about customers, suppliers, or contacts.","read_only":true},{"name":"get_bills","title":"Get Bills","description":"Get supplier bills/invoices owed by the company. Shows what you owe to suppliers.","read_only":true},{"name":"get_estimates","title":"Get Estimates","description":"Get estimates/quotes sent to clients.","read_only":true},{"name":"get_profit_and_loss","title":"Get Profit And Loss","description":"Get Profit and Loss (income statement) report for a period.","read_only":true},{"name":"get_balance_sheet","title":"Get Balance Sheet","description":"Get Balance Sheet report as at a given date.","read_only":true},{"name":"get_trial_balance","title":"Get Trial Balance","description":"Get Trial Balance showing all account balances.","read_only":true},{"name":"get_tasks","title":"Get Tasks","description":"Get tasks and to-dos for the company.","read_only":true},{"name":"get_expense_claims","title":"Get Expense Claims","description":"Get expense claims and reimbursement requests.","read_only":true},{"name":"get_bank_accounts","title":"Get Bank Accounts","description":"List bank accounts connected to the company.","read_only":true},{"name":"get_journal_entries","title":"Get Journal Entries","description":"Get General Ledger journal entries. Double-entry accounting records.","read_only":true},{"name":"list_opportunities","title":"List Opportunities","description":"List sales pipeline opportunities/deals. Shows prospects, their stage, value, and next actions.","read_only":true},{"name":"get_opportunity","title":"Get Opportunity","description":"Get detailed information about a specific pipeline opportunity/deal, including notes and activity history.","read_only":true},{"name":"get_income_by_currency","title":"Get Income By Currency","description":"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_transactio","read_only":true},{"name":"get_financial_snapshot","title":"Get Financial Snapshot","description":"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_los","read_only":true},{"name":"get_integration_status","title":"Get Integration Status","description":"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","read_only":true},{"name":"get_gst_hst_return","title":"Get Gst Hst Return","description":"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 ","read_only":true},{"name":"get_gifi_status","title":"Get Gifi Status","description":"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.","read_only":true},{"name":"get_vat_periods","title":"Get Vat Periods","description":"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.","read_only":true},{"name":"get_hmrc_vat_obligations","title":"Get Hmrc Vat Obligations","description":"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.","read_only":true},{"name":"get_hmrc_vat_liabilities","title":"Get Hmrc Vat Liabilities","description":"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.","read_only":true},{"name":"get_hmrc_vat_payments","title":"Get Hmrc Vat Payments","description":"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.","read_only":true},{"name":"check_vat_number","title":"Check Vat Number","description":"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","read_only":true},{"name":"get_incoming_messages","title":"Get Incoming Messages","description":"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 ","read_only":true},{"name":"get_gov_guidance","title":"Get Gov Guidance","description":"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.","read_only":true},{"name":"get_aged_debtors","title":"Get Aged Debtors","description":"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.","read_only":true},{"name":"get_aged_creditors","title":"Get Aged Creditors","description":"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.","read_only":true},{"name":"get_goals","title":"Get Goals","description":"Get active business/financial goals and their progress. Use when user asks about their goals, targets, or how they are tracking against objectives.","read_only":true},{"name":"list_employees","title":"List Employees","description":"List active employees for the company. Use when the user asks about their employees, staff, team members, or headcount.","read_only":true},{"name":"get_payroll_summary","title":"Get Payroll Summary","description":"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 ","read_only":true},{"name":"get_projects","title":"Get Projects","description":"List projects (pipeline, active, completed). Use when the user asks about their projects, deals, or pipeline.","read_only":true},{"name":"get_project_pnl","title":"Get Project Pnl","description":"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.","read_only":true},{"name":"get_chart_of_accounts","title":"Get Chart Of Accounts","description":"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 ","read_only":true},{"name":"get_filed_accounts_history","title":"Get Filed Accounts History","description":"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 a","read_only":true},{"name":"get_year_on_year","title":"Get Year On Year","description":"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', pl","read_only":true},{"name":"get_budget_vs_actual","title":"Get Budget Vs Actual","description":"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 v","read_only":true},{"name":"get_fx_rates","title":"Get Fx Rates","description":"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","read_only":true},{"name":"get_fixed_assets","title":"Get Fixed Assets","description":"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.","read_only":true},{"name":"get_capital_allowance_hint","title":"Get Capital Allowance Hint","description":"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.","read_only":true},{"name":"get_reconciliation_status","title":"Get Reconciliation Status","description":"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,","read_only":true},{"name":"get_cash_flow_forecast","title":"Get Cash Flow Forecast","description":"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 bala","read_only":true},{"name":"get_dividends","title":"Get Dividends","description":"List dividend records. Use when user asks about dividends paid, dividend history, or shareholder payments.","read_only":true},{"name":"get_recurring_invoices","title":"Get Recurring Invoices","description":"List recurring invoice templates. Use when user asks about recurring invoices, scheduled invoices, or subscription billing.","read_only":true},{"name":"deel_list_contracts","title":"Deel List Contracts","description":"List contracts from the user's Deel account. Use when the user asks about their Deel contracts, contractors, or team members managed through Deel.","read_only":true},{"name":"deel_get_invoices","title":"Deel Get Invoices","description":"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.","read_only":true},{"name":"deel_get_payment_receipts","title":"Deel Get Payment Receipts","description":"Get payment receipts from Deel showing payments made to contractors. Use when the user asks about specific Deel payments or needs payment proof.","read_only":true},{"name":"deel_calculate_employment_cost","title":"Deel Calculate Employment Cost","description":"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.","read_only":true},{"name":"deel_calculate_take_home_pay","title":"Deel Calculate Take Home Pay","description":"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.","read_only":true},{"name":"deel_get_people","title":"Deel Get People","description":"List people (contractors and employees) in the user's Deel organization. Use when the user asks about their Deel team, workforce, or contractor list.","read_only":true},{"name":"get_document_links","title":"Get Document Links","description":"Get the documents linked to ONE entity (transaction, invoice, bill, estimate, contact, project, expense claim), or the entities linked to ONE document. Every call needs either document_id, or entity_type together with entity_id: there is no \"list all links\" call, and a call with neither returns nothing but an error. Look the id up first (get_transactions, get_invoices, search_documents), then call","read_only":true},{"name":"find_related_documents","title":"Find Related Documents","description":"Find documents that might be related to an entity based on amount, vendor, date, and reference matching. Shows both already-linked documents and AI-suggested matches. Use when user asks \"are there any receipts for this transaction?\" or \"find documents related to this invoice\".","read_only":true},{"name":"get_accounts_status","title":"Get Accounts Status","description":"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.","read_only":true},{"name":"get_attention","title":"Get Attention","description":"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 anyt","read_only":true},{"name":"get_risk_flags","title":"Get Risk Flags","description":"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 fl","read_only":true},{"name":"lookup_company","title":"Lookup Company","description":"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.","read_only":true},{"name":"find_duplicate_bank_accounts","title":"Find Duplicate Bank Accounts","description":"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","read_only":true},{"name":"lookup_tax_rule","title":"Lookup Tax Rule","description":"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.","read_only":true},{"name":"get_qfzp_status","title":"Get Qfzp Status","description":"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","read_only":true},{"name":"list_tax_rules","title":"List Tax Rules","description":"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.","read_only":true}],"server_info":{"name":"AccountsOS","title":"AccountsOS","version":"1.0.0"},"category":"finance","tags":["productivity","web-search","data"],"kind":"remote","source":"registry","submitted":{},"first_party":false,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-09-17","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/io-github-paulgosnell-accountsos-mcp/"}