{"name":"accountsos","version":"1.0.0","tools":[{"name":"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.","inputSchema":{"type":"object","properties":{"from_date":{"type":"string","description":"Start date (YYYY-MM-DD)"},"to_date":{"type":"string","description":"End date (YYYY-MM-DD)"},"category":{"type":"string","description":"Filter by category"},"direction":{"type":"string","enum":["in","out"],"description":"in = income; out = expense"},"min_amount":{"type":"number","description":"Minimum amount"},"max_amount":{"type":"number","description":"Maximum amount"},"search":{"type":"string","description":"Search in description"},"limit":{"type":"number","description":"Max results (default 50, max 100)"},"offset":{"type":"number","description":"Skip this many rows (default 0) for pagination"},"needs_review":{"type":"boolean","description":"Only the lines Finn could not place with confidence: the same set as the 'transactions need a look' count."},"max_confidence":{"type":"number","description":"Only lines whose categorisation confidence is below this percentage (0 to 100). Lines with no confidence score are included."},"uncategorised":{"type":"boolean","description":"Only lines with no category."}}},"title":"Get Transactions","annotations":{"title":"Get Transactions","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"get_balance","description":"Get current account balance","inputSchema":{"type":"object","properties":{"account_id":{"type":"string","description":"Specific account (optional)"}}},"title":"Get Balance","annotations":{"title":"Get Balance","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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.","inputSchema":{"type":"object","properties":{"include_completed":{"type":"boolean","description":"Include completed deadlines"}}},"title":"Get Deadlines","annotations":{"title":"Get Deadlines","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"get_vat_summary","description":"Get VAT summary for a calendar quarter, or for any VAT period with start_date and end_date","inputSchema":{"type":"object","properties":{"quarter":{"type":"string","description":"Calendar quarter (e.g., \"Q1 2025\")"},"start_date":{"type":"string","description":"First day of the VAT period, YYYY-MM-DD"},"end_date":{"type":"string","description":"Last day of the VAT period, YYYY-MM-DD"}}},"title":"Get Vat Summary","annotations":{"title":"Get Vat Summary","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"categorize_transaction","description":"Suggest a category for a transaction","inputSchema":{"type":"object","properties":{"transaction_id":{"type":"string","description":"Transaction ID"}},"required":["transaction_id"]},"title":"Categorize Transaction","annotations":{"title":"Categorize Transaction","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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).","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Search query (optional when filtering by status or type)"},"type":{"type":"string","description":"Document type (receipt, invoice, statement)"},"status":{"type":"array","items":{"type":"string"},"description":"Filter by status: pending, error, processed, matched"}}},"title":"Search Documents","annotations":{"title":"Search Documents","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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.","inputSchema":{"type":"object","properties":{"page":{"type":"string","description":"Wiki page name (e.g. \"index\", \"corporation-tax\", \"vat\", \"ir35\", \"us-sales-tax-nexus\"). Use \"index\" to see all pages."}},"required":["page"]},"title":"Read Wiki","annotations":{"title":"Read Wiki","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"search_wiki","description":"Search Finn's knowledge base by keyword. Returns matching page names and excerpts. Use when unsure which page covers a topic.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Search keyword (e.g. \"marginal relief\", \"employment allowance\", \"flat rate scheme\")"}},"required":["query"]},"title":"Search Wiki","annotations":{"title":"Search Wiki","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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.","inputSchema":{"type":"object","properties":{"slug":{"type":"string","description":"Page slug (e.g. \"index\", or a specific topic). Defaults to \"index\"."}}},"title":"Read Company Wiki","annotations":{"title":"Read Company Wiki","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"search_company_wiki","description":"Search this company's private memory wiki by keyword. Returns matching page slugs, titles and excerpts.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Search keyword"}},"required":["query"]},"title":"Search Company Wiki","annotations":{"title":"Search Company Wiki","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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.","inputSchema":{"type":"object","properties":{"category":{"type":"string","description":"Tax category (e.g. \"income_tax\", \"dividends\", \"mileage\")"},"item":{"type":"string","description":"Specific item within the category (optional — omit for all items)"},"tax_year":{"type":"string","description":"Tax year (e.g. \"2025-26\"). Defaults to current."}},"required":["category"]},"title":"Get Tax Facts","annotations":{"title":"Get Tax Facts","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Search query (e.g. \"employment allowance\", \"dividend tax\")"},"tax_year":{"type":"string","description":"Tax year. Defaults to current."}},"required":["query"]},"title":"Search Tax Facts","annotations":{"title":"Search Tax Facts","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"upload_document","description":"Upload a document (receipt, invoice, bank statement) for processing. The document will be analyzed by AI to extract data.","inputSchema":{"type":"object","properties":{"file_name":{"type":"string","description":"Original filename (e.g., \"receipt.pdf\")"},"file_data":{"type":"string","description":"Base64-encoded file content. A \"data:<mime>;base64,...\" prefix is also accepted."},"document_type":{"type":"string","description":"Type of document: receipt, invoice, bank_statement, or other","enum":["receipt","invoice","bank_statement","other"]},"background":{"type":"boolean","description":"Reply as soon as the file is stored and read it after the reply (status pending, no extracted_data). For callers with a short timeout, such as Zapier."}},"required":["file_name","file_data"]},"title":"Upload Document","annotations":{"title":"Upload Document","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"create_transaction","description":"Create a new transaction manually","inputSchema":{"type":"object","properties":{"date":{"type":"string","description":"Transaction date (YYYY-MM-DD)"},"description":{"type":"string","description":"Transaction description"},"amount":{"type":"number","description":"Transaction amount (positive number)"},"direction":{"type":"string","enum":["in","out"],"description":"Money direction: in (income) or out (expense)"},"category_id":{"type":"string","description":"Category ID (optional - will auto-categorize if not provided)"},"counterparty":{"type":"string","description":"Name of the other party"},"notes":{"type":"string","description":"Additional notes"},"trading_entity_id":{"type":"string","description":"Trading entity ID to assign transaction to a specific income stream"}},"required":["date","description","amount","direction"]},"title":"Create Transaction","annotations":{"title":"Create Transaction","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"update_transaction","description":"Update a transaction (category, notes, reconciliation status)","inputSchema":{"type":"object","properties":{"transaction_id":{"type":"string","description":"Transaction ID"},"category_id":{"type":"string","description":"New category ID"},"notes":{"type":"string","description":"Notes to add/update"},"reconciled":{"type":"boolean","description":"Mark as reconciled"},"remove_split":{"type":"boolean","description":"Only for a line that is split across accounts: true removes the split and puts the whole line in category_id (required with it). Its separate tax lines go with the split."},"direction":{"type":"string","enum":["in","out"],"description":"Money direction: in (income/money received) or out (expense/money paid). Use to fix a transaction imported with the wrong sign, e.g. income that came in as an expense."},"reverse_charge":{"type":"boolean","description":"UK VAT only. true = a purchase of services from a supplier outside the UK that charged no UK VAT. Sets the line VAT to 0; the VAT return self-accounts it in Box 1 and Box 4 (net nil). false = undo: the line's earlier VAT is restored from the copy saved when it was flagged. A line flagged before that copy was kept has no saved VAT, so false removes the flag but leaves the VAT at 0 and the result says so."},"trading_entity_id":{"type":"string","description":"Trading entity ID to assign transaction to"}},"required":["transaction_id"]},"title":"Update Transaction","annotations":{"title":"Update Transaction","readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"create_deadline","description":"Create a new tax or filing deadline. The type must belong to the company's country and business type; use custom for anything else.","inputSchema":{"type":"object","properties":{"type":{"type":"string","description":"Deadline type (e.g., vat_return, corporation_tax, confirmation_statement)"},"due_date":{"type":"string","description":"Due date (YYYY-MM-DD)"},"description":{"type":"string","description":"Description"},"period_start":{"type":"string","description":"Period start date"},"period_end":{"type":"string","description":"Period end date"}},"required":["type","due_date"]},"title":"Create Deadline","annotations":{"title":"Create Deadline","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"list_categories","description":"List available transaction categories for categorization","inputSchema":{"type":"object","properties":{"type":{"type":"string","description":"Filter by type: income, expense, asset, liability, equity"}}},"title":"List Categories","annotations":{"title":"List Categories","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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.","inputSchema":{"type":"object","properties":{"limit":{"type":"number","description":"Max number of transactions to return (default 10)"}}},"title":"Get Dla Balance","annotations":{"title":"Get Dla Balance","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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.","inputSchema":{"type":"object","properties":{"status":{"type":"string","description":"Filter by status: outstanding (every unpaid invoice), overdue (unpaid and past due), draft, sent, paid, cancelled, all"},"contact_id":{"type":"string","description":"Filter by client/contact ID"},"search":{"type":"string","description":"Search by invoice number"}}},"title":"Get Invoices","annotations":{"title":"Get Invoices","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"create_invoice","description":"Create a draft sales invoice to a client. Pass contact_name (found or created) or contact_id, and either description + amount for one line or line_items for several. Amounts are net of VAT; VAT is added only when the company is VAT registered. due_days sets the payment terms (default 30). The invoice is created as a draft and is not emailed.","inputSchema":{"type":"object","properties":{"contact_name":{"type":"string","description":"Client name (company or person) — used to find or create the contact"},"contact_id":{"type":"string","description":"Contact ID if already known"},"contact_email":{"type":"string","description":"Recipient email when the user gives one (\"invoice £1,000 to jane@acme.com\"). ALWAYS pass it — it is saved on the contact (created with it, or filled in if the existing contact has none) so the invoice can be emailed without another round trip. Dropping an email the user already gave forces them to repeat it later."},"description":{"type":"string","description":"What the invoice is for (e.g. \"Web design services - January 2026\"). Required unless `line_items` is provided — this is the single invoice line-item description."},"amount":{"type":"number","description":"Net amount (excluding VAT) in the invoice currency. Required unless `line_items` is provided. If both `amount` and `line_items` are given and they disagree, the line_items total wins and the discrepancy is reported back."},"line_items":{"type":"array","description":"Use instead of (or alongside, as a cross-check) a single description/amount when the invoice has multiple distinct lines — e.g. a pasted breakdown like \"Design 4,000 + Development 1,400 + Hosting 1,000\". Each item becomes its own invoice line. Totals are computed from these lines, not from `amount`.","items":{"type":"object","properties":{"description":{"type":"string","description":"What this line is for."},"quantity":{"type":"number","description":"Quantity for this line. Defaults to 1."},"unit_price":{"type":"number","description":"Net unit price (excluding VAT) for this line."},"vat_rate":{"type":"number","description":"VAT rate as a percentage for this line (e.g. 20). Defaults to the invoice-level vat_rate, or 20 for VAT-registered companies, 0 otherwise."},"vat_code":{"type":"string","enum":["T0","T1","T2","T9"],"description":"Canada: T1 taxable, T0 zero-rated (basic groceries, exports), T2 exempt (most health and dental services, residential rent). Optional elsewhere."},"line_vat_treatment":{"type":"string","enum":["standard","reduced","zero","exempt","out_of_scope","eu_goods","eu_services","export","domestic_reverse_charge","triangular","oss","small_supplier","eu_goods_acquisition","import_goods","non_eu_services"],"description":"How VAT treats this line, beyond its rate, for a VAT-registered company in a country that has treatments (EU members, the UK, Canada for exports). Pass it only when the customer or the conversation makes it clear: eu_goods or eu_services for a sale to a VAT-registered business in another EU country, export for goods leaving the country, domestic_reverse_charge, exempt, out_of_scope. A treatment that means no VAT is charged sets the line rate to 0. A treatment the company is not offered is ignored. Not sure: omit it and ask the user. Not the same as the invoice-level vat_treatment, which is only the UK construction switch."},"cis_labour":{"type":"boolean","description":"True for labour on a CIS job, so the main contractor deducts CIS from it; materials false."},"unit":{"type":"string","description":"Unit of measure printed on the line (kos, ura, mesec...). Slovenian invoice layout only: refused for any other company."},"discount_percent":{"type":"number","description":"Discount on the line, percent (0 to 100, at most two decimals). unit_price is the price BEFORE discount; the stored line total is already net of it. Slovenian invoice layout only: refused for any other company."}},"required":["description","unit_price"]}},"cis_labour":{"type":"boolean","description":"For the single-line form (description + amount): true when that line is labour on a CIS job, so the main contractor deducts CIS from it. Materials false. Only for a company that is a CIS subcontractor."},"opportunity_id":{"type":"string","description":"Optional pipeline opportunity/deal ID to link this invoice to (use get_opportunity / list_opportunities to find it). When set, the invoice is attached to the deal and logged on its activity timeline."},"service_date":{"type":"string","description":"Date of supply (datum opravljene storitve), YYYY-MM-DD. Slovenian invoice layout only: refused for any other company. Omit it when it is the invoice date."},"unit":{"type":"string","description":"Single-line form (description + amount). Unit of measure printed on the line (kos, ura, mesec...). Slovenian invoice layout only: refused for any other company."},"discount_percent":{"type":"number","description":"Single-line form (description + amount): amount is the price before discount. Discount on the line, percent (0 to 100, at most two decimals). unit_price is the price BEFORE discount; the stored line total is already net of it. Slovenian invoice layout only: refused for any other company."},"currency":{"type":"string","description":"ISO 4217 currency code (e.g. GBP, USD, EUR, HKD, AED, AUD, CAD, SGD, CHF, JPY, BGN, INR). Defaults to the company default currency if omitted."},"vat_rate":{"type":"number","description":"VAT rate as percentage (e.g. 20 for 20%). Only applies when the company is VAT registered — if it is NOT registered, VAT is forced to 0 regardless of this value (a non-registered business cannot charge VAT). Defaults to 20 for VAT-registered companies. Used as the fallback rate for any line_items that omit their own vat_rate."},"vat_code":{"type":"string","enum":["T0","T1","T2","T9"],"description":"Canada: T1 taxable, T0 zero-rated (basic groceries, exports), T2 exempt (most health and dental services, residential rent). Optional elsewhere."},"line_vat_treatment":{"type":"string","enum":["standard","reduced","zero","exempt","out_of_scope","eu_goods","eu_services","export","domestic_reverse_charge","triangular","oss","small_supplier","eu_goods_acquisition","import_goods","non_eu_services"],"description":"Single-line form (description + amount). How VAT treats this line, beyond its rate, for a VAT-registered company in a country that has treatments (EU members, the UK, Canada for exports). Pass it only when the customer or the conversation makes it clear: eu_goods or eu_services for a sale to a VAT-registered business in another EU country, export for goods leaving the country, domestic_reverse_charge, exempt, out_of_scope. A treatment that means no VAT is charged sets the line rate to 0. A treatment the company is not offered is ignored. Not sure: omit it and ask the user. Not the same as the invoice-level vat_treatment, which is only the UK construction switch."},"invoice_date":{"type":"string","description":"Invoice date as YYYY-MM-DD. Defaults to today if omitted. Set this when the user gives a different date (e.g. backdating to when the work was done or payment received) — due_days is calculated from this date."},"due_days":{"type":"number","description":"Payment terms in days from the invoice date. Ask the user — do not assume 30. Common terms are 7, 14, or 30 days."},"invoice_number":{"type":"string","description":"Only set this when recording an invoice the user has ALREADY issued and it carries its own reference (from a PDF/spreadsheet, or migrating historical invoices) — pass that exact original number (e.g. \"50\", \"2026-014\", \"INV-0123\") so it is kept verbatim. Omit for brand-new invoices — they auto-number from the company sequence. If the number is already used on this company, the tool refuses (no silent duplicate); ask the user for the correct one."},"notes":{"type":"string","description":"Additional notes for the invoice"},"vat_treatment":{"type":"string","enum":["standard","domestic_reverse_charge"],"description":"UK construction only. domestic_reverse_charge = the CIS domestic reverse charge: no VAT charged, the customer (a VAT-registered contractor inside CIS, not an end user) pays it to HMRC. Omit to use what is recorded on the customer (contacts.construction_vat), else standard. Ask the user once if the customer is a main contractor or an end user when the company is a construction business and nothing is recorded."}},"required":[]},"title":"Create Invoice","annotations":{"title":"Create Invoice","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"send_invoice","description":"Email an invoice to the client and mark it sent. Generates the PDF and sends it to the contact's billing email (To), with the named person in CC when both exist. The contact needs an email on file: pass contact_email to create_invoice, or the send is refused. message adds an optional note to the email. The result lists every address it went to.","inputSchema":{"type":"object","properties":{"invoice_id":{"type":"string","description":"Invoice ID (use get_invoices to find it if not known)"},"message":{"type":"string","description":"Optional custom note included in the email body (e.g. \"Thanks for the call yesterday — invoice attached\")."},"attach_einvoice":{"type":"boolean","description":"Set true when the user asks for the invoice as UBL, as an e-invoice or as XML: the e-invoice file in the company's country format (UBL NLCIUS in the Netherlands, eSLOG 2.0 in Slovenia) is attached next to the PDF as <invoice number>.xml. Where the country has no e-invoice format, or the invoice is missing something the format needs, nothing is sent and the result says why: tell the user that reason."}},"required":["invoice_id"]},"title":"Send Invoice","annotations":{"title":"Send Invoice","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"get_contacts","description":"List contacts (clients, suppliers, leads). Use when user asks about customers, suppliers, or contacts.","inputSchema":{"type":"object","properties":{"type":{"type":"string","description":"Filter by type: client, supplier, lead, other"},"search":{"type":"string","description":"Search by name or email"},"limit":{"type":"number","description":"Max results (default 50)"},"sort":{"type":"string","enum":["name","newest"],"description":"Order: name (default) or newest first"}}},"title":"Get Contacts","annotations":{"title":"Get Contacts","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"create_contact","description":"Create a new contact (client, supplier, lead).","inputSchema":{"type":"object","properties":{"name":{"type":"string","description":"Contact or company name"},"email":{"type":"string","description":"Email address"},"phone":{"type":"string","description":"Phone number"},"type":{"type":"string","description":"Contact type: client, supplier, lead, other"},"company_name":{"type":"string","description":"Company/organisation name"},"notes":{"type":"string","description":"Notes about this contact"}},"required":["name"]},"title":"Create Contact","annotations":{"title":"Create Contact","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"get_bills","description":"Get supplier bills/invoices owed by the company. Shows what you owe to suppliers.","inputSchema":{"type":"object","properties":{"status":{"type":"string","description":"Filter: outstanding (every unpaid bill), overdue (unpaid and past due), draft, received, paid, all"},"contact_id":{"type":"string","description":"Filter by supplier contact ID"},"limit":{"type":"number","description":"Max results (default 50)"}}},"title":"Get Bills","annotations":{"title":"Get Bills","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"create_bill","description":"Record a supplier bill/invoice that the company owes.","inputSchema":{"type":"object","properties":{"contact_id":{"type":"string","description":"Supplier contact ID"},"bill_number":{"type":"string","description":"Supplier invoice/reference number"},"bill_date":{"type":"string","description":"Bill date (YYYY-MM-DD)"},"due_date":{"type":"string","description":"Payment due date (YYYY-MM-DD)"},"items":{"type":"array","description":"Line items: [{description, quantity, unit_price, vat_rate?}]","items":{"type":"object","properties":{"description":{"type":"string"},"quantity":{"type":"number"},"unit_price":{"type":"number"},"vat_rate":{"type":"number"}},"required":["description","quantity","unit_price"]}},"notes":{"type":"string","description":"Internal notes"}},"required":["contact_id","bill_date","due_date","items"]},"title":"Create Bill","annotations":{"title":"Create Bill","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"pay_bill","description":"Record a payment against a bill.","inputSchema":{"type":"object","properties":{"bill_id":{"type":"string","description":"Bill ID to pay"},"amount":{"type":"number","description":"Payment amount"},"payment_date":{"type":"string","description":"Payment date (YYYY-MM-DD)"},"payment_method":{"type":"string","description":"Payment method (bank_transfer, card, cash, other)"}},"required":["bill_id","amount","payment_date"]},"title":"Pay Bill","annotations":{"title":"Pay Bill","readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"get_estimates","description":"Get estimates/quotes sent to clients.","inputSchema":{"type":"object","properties":{"status":{"type":"string","description":"Filter: draft, sent, accepted, declined, all"},"contact_id":{"type":"string","description":"Filter by client contact ID"},"limit":{"type":"number","description":"Max results (default 50)"}}},"title":"Get Estimates","annotations":{"title":"Get Estimates","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"create_estimate","description":"Create a new estimate/quote for a client.","inputSchema":{"type":"object","properties":{"contact_id":{"type":"string","description":"Client contact ID"},"estimate_date":{"type":"string","description":"Estimate date (YYYY-MM-DD)"},"valid_until":{"type":"string","description":"Expiry date (YYYY-MM-DD)"},"items":{"type":"array","description":"Line items: [{description, quantity, unit_price, vat_rate?}]","items":{"type":"object","properties":{"description":{"type":"string"},"quantity":{"type":"number"},"unit_price":{"type":"number"},"vat_rate":{"type":"number"}},"required":["description","quantity","unit_price"]}},"notes":{"type":"string","description":"Notes to client"}},"required":["contact_id","estimate_date","items"]},"title":"Create Estimate","annotations":{"title":"Create Estimate","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"get_profit_and_loss","description":"Get Profit and Loss (income statement) report for a period.","inputSchema":{"type":"object","properties":{"from_date":{"type":"string","description":"Start date (YYYY-MM-DD)"},"to_date":{"type":"string","description":"End date (YYYY-MM-DD)"}}},"title":"Get Profit And Loss","annotations":{"title":"Get Profit And Loss","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"get_balance_sheet","description":"Get Balance Sheet report as at a given date.","inputSchema":{"type":"object","properties":{"as_at":{"type":"string","description":"Report date (YYYY-MM-DD). Default: today"}}},"title":"Get Balance Sheet","annotations":{"title":"Get Balance Sheet","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"get_trial_balance","description":"Get Trial Balance showing all account balances.","inputSchema":{"type":"object","properties":{"from_date":{"type":"string","description":"Start date (YYYY-MM-DD)"},"to_date":{"type":"string","description":"End date (YYYY-MM-DD)"}}},"title":"Get Trial Balance","annotations":{"title":"Get Trial Balance","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"get_tasks","description":"Get tasks and to-dos for the company.","inputSchema":{"type":"object","properties":{"completed":{"type":"boolean","description":"Filter by completion status"},"priority":{"type":"string","description":"Filter: low, medium, high, urgent"},"limit":{"type":"number","description":"Max results (default 20)"}}},"title":"Get Tasks","annotations":{"title":"Get Tasks","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"create_task","description":"Create a new task or to-do item.","inputSchema":{"type":"object","properties":{"title":{"type":"string","description":"Task title"},"description":{"type":"string","description":"Task description"},"priority":{"type":"string","description":"Priority: low, medium, high, urgent"},"due_date":{"type":"string","description":"Due date (YYYY-MM-DD)"},"type":{"type":"string","description":"Task type: general, chase_invoice, pay_bill, filing_deadline, reconcile, review"}},"required":["title"]},"title":"Create Task","annotations":{"title":"Create Task","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"get_expense_claims","description":"Get expense claims and reimbursement requests.","inputSchema":{"type":"object","properties":{"status":{"type":"string","description":"Filter: draft, submitted, approved, reimbursed, rejected"},"limit":{"type":"number","description":"Max results (default 20)"}}},"title":"Get Expense Claims","annotations":{"title":"Get Expense Claims","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"get_bank_accounts","description":"List bank accounts connected to the company.","inputSchema":{"type":"object","properties":{}},"title":"Get Bank Accounts","annotations":{"title":"Get Bank Accounts","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"get_journal_entries","description":"Get General Ledger journal entries. Double-entry accounting records.","inputSchema":{"type":"object","properties":{"from_date":{"type":"string","description":"Start date (YYYY-MM-DD)"},"to_date":{"type":"string","description":"End date (YYYY-MM-DD)"},"limit":{"type":"number","description":"Max results (default 50)"}}},"title":"Get Journal Entries","annotations":{"title":"Get Journal Entries","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"list_opportunities","description":"List sales pipeline opportunities/deals. Shows prospects, their stage, value, and next actions.","inputSchema":{"type":"object","properties":{"stage":{"type":"string","description":"Filter by pipeline stage name"},"status":{"type":"string","enum":["active","won","lost","all"],"description":"Which deals to return, judged by the pipeline stage: \"active\" = still in play (default), \"won\" = in a closed-won stage, \"lost\" = in a closed-lost stage, \"all\" = every deal. This is NOT the project delivery status."},"limit":{"type":"number","description":"Max results (default 50)"}}},"title":"List Opportunities","annotations":{"title":"List Opportunities","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"get_opportunity","description":"Get detailed information about a specific pipeline opportunity/deal, including notes and activity history.","inputSchema":{"type":"object","properties":{"opportunity_id":{"type":"string","description":"Opportunity/project ID"}},"required":["opportunity_id"]},"title":"Get Opportunity","annotations":{"title":"Get Opportunity","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"create_opportunity","description":"Create a new sales pipeline opportunity/deal.","inputSchema":{"type":"object","properties":{"name":{"type":"string","description":"Deal/opportunity name"},"contact_id":{"type":"string","description":"Contact ID for the prospect"},"value":{"type":"number","description":"Estimated deal value"},"stage_id":{"type":"string","description":"Pipeline stage ID (get from list_opportunities)"},"source":{"type":"string","description":"Lead source (e.g., referral, website, linkedin)"},"next_action":{"type":"string","description":"Next planned action"},"next_action_at":{"type":"string","description":"When the next action is due (YYYY-MM-DD)"},"notes":{"type":"string","description":"Initial notes"}},"required":["name"]},"title":"Create Opportunity","annotations":{"title":"Create Opportunity","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"add_opportunity_note","description":"Add a note or activity log to a pipeline opportunity.","inputSchema":{"type":"object","properties":{"opportunity_id":{"type":"string","description":"Opportunity/project ID"},"content":{"type":"string","description":"Note content"},"type":{"type":"string","description":"Note type: note, call, email, meeting, task"}},"required":["opportunity_id","content"]},"title":"Add Opportunity Note","annotations":{"title":"Add Opportunity Note","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"update_opportunity_stage","description":"Move an opportunity to a different pipeline stage (e.g., from Lead to Proposal).","inputSchema":{"type":"object","properties":{"opportunity_id":{"type":"string","description":"Opportunity/project ID"},"stage_id":{"type":"string","description":"New pipeline stage ID"},"next_action":{"type":"string","description":"Updated next action"},"next_action_at":{"type":"string","description":"Updated next action date (YYYY-MM-DD)"}},"required":["opportunity_id","stage_id"]},"title":"Update Opportunity Stage","annotations":{"title":"Update Opportunity Stage","readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"update_project","description":"Rename a project/deal, or change its notes, contact, or status.","inputSchema":{"type":"object","properties":{"project_id":{"type":"string","description":"Project ID (preferred if known)"},"project_name":{"type":"string","description":"Project name to resolve if id is not known"},"name":{"type":"string","description":"New project name"},"notes":{"type":"string","description":"Replace project notes"},"status":{"type":"string","description":"pipeline, pitched, won, in_progress, completed, or lost"},"contact_id":{"type":"string","description":"Contact to attach, or empty to unlink"}}},"title":"Update Project","annotations":{"title":"Update Project","readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"delete_project","description":"Delete an empty project/deal. Refuses if transactions, invoices, bills or other records are still linked.","inputSchema":{"type":"object","properties":{"project_id":{"type":"string","description":"Project ID (preferred if known)"},"project_name":{"type":"string","description":"Project name to resolve if id is not known"}}},"title":"Delete Project","annotations":{"title":"Delete Project","readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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_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.","inputSchema":{"type":"object","properties":{"from_date":{"type":"string","description":"Start date (YYYY-MM-DD), inclusive"},"to_date":{"type":"string","description":"End date (YYYY-MM-DD), inclusive"},"direction":{"type":"string","enum":["in","out"],"description":"in = income / money in (default); out = spend / money out"}}},"title":"Get Income By Currency","annotations":{"title":"Get Income By Currency","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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_loss for that month. For invoice/bill line-level detail use get_invoices/get_bills; for ageing use get_aged_debtors/get_aged_creditors.","inputSchema":{"type":"object","properties":{}},"title":"Get Financial Snapshot","annotations":{"title":"Get Financial Snapshot","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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). 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).","inputSchema":{"type":"object","properties":{}},"title":"Get Integration Status","annotations":{"title":"Get Integration Status","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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 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.","inputSchema":{"type":"object","properties":{"start":{"type":"string","description":"First day of the reporting period, YYYY-MM-DD. Omit for the last completed period."},"end":{"type":"string","description":"Last day of the reporting period, YYYY-MM-DD. Omit for the last completed period."}}},"title":"Get Gst Hst Return","annotations":{"title":"Get Gst Hst Return","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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.","inputSchema":{"type":"object","properties":{"year_end":{"type":"string","description":"The fiscal year end, YYYY-MM-DD. Omit for the last completed fiscal year."},"as_at":{"type":"string","description":"Year to date instead of a full year: schedule 100 at this date (YYYY-MM-DD), schedule 125 from the fiscal year start to it. Use for \"GIFI at 28 Oct\" or the current year so far."}}},"title":"Get Gifi Status","annotations":{"title":"Get Gifi Status","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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.","inputSchema":{"type":"object","properties":{"status":{"type":"string","description":"Optional filter: open, ready, locked, submitted, overdue, failed."},"year":{"type":"string","description":"Optional 4-digit year filter (e.g. \"2026\")."},"limit":{"type":"number","description":"Max periods to return (default 12)."}}},"title":"Get Vat Periods","annotations":{"title":"Get Vat Periods","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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.","inputSchema":{"type":"object","properties":{"from":{"type":"string","description":"Start date (YYYY-MM-DD). Defaults to 12 months ago. A range longer than about a year is capped to the year ending at the end date, so ask in yearly chunks for anything older."},"to":{"type":"string","description":"End date (YYYY-MM-DD). Defaults to today."}}},"title":"Get Hmrc Vat Obligations","annotations":{"title":"Get Hmrc Vat Obligations","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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.","inputSchema":{"type":"object","properties":{"from":{"type":"string","description":"Start date (YYYY-MM-DD). Defaults to 12 months ago. A range longer than about a year is capped to the year ending at the end date, so ask in yearly chunks for anything older."},"to":{"type":"string","description":"End date (YYYY-MM-DD). Defaults to today."}}},"title":"Get Hmrc Vat Liabilities","annotations":{"title":"Get Hmrc Vat Liabilities","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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.","inputSchema":{"type":"object","properties":{"from":{"type":"string","description":"Start date (YYYY-MM-DD). Defaults to 12 months ago. A range longer than about a year is capped to the year ending at the end date, so ask in yearly chunks for anything older."},"to":{"type":"string","description":"End date (YYYY-MM-DD). Defaults to today."}}},"title":"Get Hmrc Vat Payments","annotations":{"title":"Get Hmrc Vat Payments","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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 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.","inputSchema":{"type":"object","properties":{"vat_number":{"type":"string","description":"UK VAT registration number, 9 digits, with or without the GB prefix."},"contact_id":{"type":"string","description":"Optional. The contact this VAT number belongs to, so the result can be reported against them."}},"required":["vat_number"]},"title":"Check Vat Number","annotations":{"title":"Check Vat Number","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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 the whole inbox: a waiting email with a statement attached is a message.","inputSchema":{"type":"object","properties":{"source":{"type":"string","description":"Filter by channel: email, whatsapp, slack, telegram, gmail. Omit for all."},"unread_only":{"type":"boolean","description":"Only messages not yet opened (default false)"},"include_processed":{"type":"boolean","description":"Also include messages already marked processed (default false: waiting only)"},"limit":{"type":"number","description":"Max messages (default 20, max 50)"}}},"title":"Get Incoming Messages","annotations":{"title":"Get Incoming Messages","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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.","inputSchema":{"type":"object","properties":{"topic":{"type":"string","description":"The topic to search for, e.g. \"VAT returns\", \"corporation tax\", \"dividends\", \"director loans\", \"expenses\""}},"required":["topic"]},"title":"Get Gov Guidance","annotations":{"title":"Get Gov Guidance","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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.","inputSchema":{"type":"object","properties":{"as_of_date":{"type":"string","description":"Ages TODAY's open invoices as at this date (YYYY-MM-DD). It is not a historical snapshot: invoices paid since that date are not included. Defaults to the end of the user's working period, which is today when they are in the current period."},"contact_id":{"type":"string","description":"Optional contact ID to scope the report to a single client"}}},"title":"Get Aged Debtors","annotations":{"title":"Get Aged Debtors","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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.","inputSchema":{"type":"object","properties":{"as_of_date":{"type":"string","description":"Ages TODAY's open bills as at this date (YYYY-MM-DD). It is not a historical snapshot: bills paid since that date are not included. Defaults to the end of the user's working period, which is today when they are in the current period."},"contact_id":{"type":"string","description":"Optional supplier contact ID to scope the report"}}},"title":"Get Aged Creditors","annotations":{"title":"Get Aged Creditors","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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.","inputSchema":{"type":"object","properties":{"status":{"type":"string","description":"Filter by status: active, completed, all (default: active)"},"goal_type":{"type":"string","description":"Filter by type: revenue_target, expense_reduction, savings_target, profit_margin, cash_reserve, debt_reduction, client_acquisition, invoice_collection, custom"}}},"title":"Get Goals","annotations":{"title":"Get Goals","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"list_employees","description":"List active employees for the company. Use when the user asks about their employees, staff, team members, or headcount.","inputSchema":{"type":"object","properties":{"include_inactive":{"type":"boolean","description":"Include terminated/on_leave employees (default false)"}}},"title":"List Employees","annotations":{"title":"List Employees","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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 nothing was paid through payroll, so say that and show what the bank shows.","inputSchema":{"type":"object","properties":{"tax_year":{"type":"string","description":"Tax year (e.g. \"2025-26\"). Defaults to current tax year."}}},"title":"Get Payroll Summary","annotations":{"title":"Get Payroll Summary","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"get_projects","description":"List projects (pipeline, active, completed). Use when the user asks about their projects, deals, or pipeline.","inputSchema":{"type":"object","properties":{"status":{"type":"string","description":"Filter by status: pitched, won, in_progress, completed, lost, all (default: all)"},"search":{"type":"string","description":"Search by project name"}}},"title":"Get Projects","annotations":{"title":"Get Projects","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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.","inputSchema":{"type":"object","properties":{"project_id":{"type":"string","description":"Project ID (preferred if known)"},"project_name":{"type":"string","description":"Project name to resolve if project_id is not known. Case-insensitive; errors with candidate names if ambiguous."}}},"title":"Get Project Pnl","annotations":{"title":"Get Project Pnl","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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 one with create_account_category.","inputSchema":{"type":"object","properties":{"type":{"type":"string","description":"Filter by type: income, expense, asset, liability, equity, cost_of_sales"}}},"title":"Get Chart Of Accounts","annotations":{"title":"Get Chart Of Accounts","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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 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.","inputSchema":{"type":"object","properties":{}},"title":"Get Filed Accounts History","annotations":{"title":"Get Filed Accounts History","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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', planning or forecasting answer when the company has history.","inputSchema":{"type":"object","properties":{}},"title":"Get Year On Year","annotations":{"title":"Get Year On Year","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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 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.","inputSchema":{"type":"object","properties":{"from_month":{"type":"string","description":"First month of the period (YYYY-MM). Defaults to the start of the current financial year."},"to_month":{"type":"string","description":"Last month of the period, inclusive (YYYY-MM). Defaults to the current month."}}},"title":"Get Budget Vs Actual","annotations":{"title":"Get Budget Vs Actual","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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 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.","inputSchema":{"type":"object","properties":{"from":{"type":"string","description":"Currency to convert from, three-letter code, for example EUR."},"to":{"type":"string","description":"Currency to convert to, three-letter code, for example AED."},"date":{"type":"string","description":"A single date (YYYY-MM-DD). Defaults to today when no range is given."},"start_date":{"type":"string","description":"Start of a range (YYYY-MM-DD). Use with end_date."},"end_date":{"type":"string","description":"End of a range (YYYY-MM-DD). Use with start_date."}},"required":["from","to"]},"title":"Get Fx Rates","annotations":{"title":"Get Fx Rates","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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.","inputSchema":{"type":"object","properties":{"status":{"type":"string","enum":["active","disposed","all"],"description":"Filter by asset status. Defaults to active."}}},"title":"Get Fixed Assets","annotations":{"title":"Get Fixed Assets","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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.","inputSchema":{"type":"object","properties":{"asset_id":{"type":"string","description":"Fixed asset ID from get_fixed_assets"}},"required":["asset_id"]},"title":"Get Capital Allowance Hint","annotations":{"title":"Get Capital Allowance Hint","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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, 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.","inputSchema":{"type":"object","properties":{"bank_account_id":{"type":"string","description":"Limit to one bank account (optional)."}}},"title":"Get Reconciliation Status","annotations":{"title":"Get Reconciliation Status","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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 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.","inputSchema":{"type":"object","properties":{}},"title":"Get Cash Flow Forecast","annotations":{"title":"Get Cash Flow Forecast","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"get_dividends","description":"List dividend records. Use when user asks about dividends paid, dividend history, or shareholder payments.","inputSchema":{"type":"object","properties":{"tax_year":{"type":"string","description":"Filter by tax year (e.g. \"2025/26\")"},"limit":{"type":"number","description":"Max results (default 20)"}}},"title":"Get Dividends","annotations":{"title":"Get Dividends","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"get_recurring_invoices","description":"List recurring invoice templates. Use when user asks about recurring invoices, scheduled invoices, or subscription billing.","inputSchema":{"type":"object","properties":{"status":{"type":"string","enum":["active","paused","completed"],"description":"Filter by status (default: active)"}}},"title":"Get Recurring Invoices","annotations":{"title":"Get Recurring Invoices","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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.","inputSchema":{"type":"object","properties":{"limit":{"type":"number","description":"Max results (default 20)"},"statuses":{"type":"string","description":"Comma-separated statuses: active, completed, cancelled"}}},"title":"Deel List Contracts","annotations":{"title":"Deel List Contracts","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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.","inputSchema":{"type":"object","properties":{"limit":{"type":"number","description":"Max results (default 20)"},"statuses":{"type":"string","description":"Filter by status: paid, pending, overdue"}}},"title":"Deel Get Invoices","annotations":{"title":"Deel Get Invoices","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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.","inputSchema":{"type":"object","properties":{"limit":{"type":"number","description":"Max results (default 20)"}}},"title":"Deel Get Payment Receipts","annotations":{"title":"Deel Get Payment Receipts","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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.","inputSchema":{"type":"object","properties":{"country":{"type":"string","description":"Full country name (e.g., \"Portugal\", \"Germany\", \"Ireland\"). Must be the full name, not a code."},"salary":{"type":"number","description":"Annual gross salary in the country's currency"},"currency":{"type":"string","description":"Currency code (e.g., \"EUR\", \"USD\")"}},"required":["country","salary","currency"]},"title":"Deel Calculate Employment Cost","annotations":{"title":"Deel Calculate Employment Cost","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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.","inputSchema":{"type":"object","properties":{"country":{"type":"string","description":"Two-letter ISO country code (e.g., \"IE\" for Ireland, \"PT\" for Portugal)"},"salary":{"type":"number","description":"Annual gross salary"},"currency":{"type":"string","description":"Currency code"}},"required":["country","salary","currency"]},"title":"Deel Calculate Take Home Pay","annotations":{"title":"Deel Calculate Take Home Pay","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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.","inputSchema":{"type":"object","properties":{"limit":{"type":"number","description":"Max results (default 20)"}}},"title":"Deel Get People","annotations":{"title":"Deel Get People","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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 once per id. Use when user asks \"what documents are attached to this invoice?\" or \"show me what's linked to that receipt\".","inputSchema":{"type":"object","properties":{"document_id":{"type":"string","description":"Document ID to get links for"},"entity_type":{"type":"string","description":"Entity type: transaction, invoice, bill, estimate, contact, project, expense_claim"},"entity_id":{"type":"string","description":"Entity ID to get linked documents for"}}},"title":"Get Document Links","annotations":{"title":"Get Document Links","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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\".","inputSchema":{"type":"object","properties":{"entity_type":{"type":"string","description":"Entity type: transaction, invoice, bill, estimate, contact, project, expense_claim"},"entity_id":{"type":"string","description":"Entity ID to find related documents for"}},"required":["entity_type","entity_id"]},"title":"Find Related Documents","annotations":{"title":"Find Related Documents","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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.","inputSchema":{"type":"object","properties":{}},"title":"Get Accounts Status","annotations":{"title":"Get Accounts Status","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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 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.","inputSchema":{"type":"object","properties":{}},"title":"Get Attention","annotations":{"title":"Get Attention","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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 flag has entity_type, entity_id, label, severity, title and detail.","inputSchema":{"type":"object","properties":{}},"title":"Get Risk Flags","annotations":{"title":"Get Risk Flags","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"lookup_company","description":"Look up a company on its official register: search by name to find candidates, or fetch a single company by its number to get the full public record. UK companies come from Companies House (registered name, number, status, incorporation date, registered office address, SIC codes, directors/officers, and filing deadlines). Irish companies come from the CRO (registered name, CRO number, status, company type, incorporation date, registered address and the annual return date); a CRO number is digits only. Use this during onboarding to find and confirm the user's company (\"is this your company?\"). Read-only: it does NOT save anything; use link_company to save the confirmed company. If the result says the lookup is not available, tell the user plainly and take their company details directly with update_company. French companies come from the Annuaire des Entreprises (registered name, SIREN, status, legal form, incorporation date, registered address, activity code and officers); search by name or by SIREN (9 digits). Dutch businesses come from the KVK Handelsregister (registered name, KVK number, status, legal form, visiting address, main activity and trade names; no start date); search by name or by KVK number (8 digits). Australian businesses come from the Australian Business Register (ABN Lookup): search by name (name, ABN, state and postcode of each candidate), or look one up by ABN (11 digits) or ACN (9 digits) for its entity name, entity type, status, GST registration and business names. The register gives no street address. Other countries have no register lookup; ask the user for their company details directly. No register here returns an EU VAT number, and a Dutch VAT number cannot be worked out from a KVK number. When lookup_business_register is among your tools, a VAT number the user gives is checked on VIES with it; never say VIES cannot be consulted.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Company name to search for (returns up to ~10 candidates with number, status, and address). Use when you have a name but not a number."},"company_number":{"type":"string","description":"Exact company number to fetch the full record + directors + deadlines. Use once you know the number (e.g. after the user confirms a search candidate)."}}},"title":"Lookup Company","annotations":{"title":"Lookup Company","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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 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.","inputSchema":{"type":"object","properties":{}},"title":"Find Duplicate Bank Accounts","annotations":{"title":"Find Duplicate Bank Accounts","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"lookup_tax_rule","description":"Look up a verified tax or accounting rule by its key. The system automatically routes to the active company's own country library: every live country has one (e.g. India: gst-rate-slabs, personal-income-tax-slabs-new-regime), so never tell a user you only know UK rules. 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. Apply the rule to the user's facts: when the answer turns on a fact only the user knows (when goods were delivered, when work was finished, when money arrived), ask for that fact, never for the conclusion (ask \"when did you deliver it?\", not \"does it belong in Q3 or October?\"). Once the user gives the fact, that is the fact: state the result the rule gives for it, with the source, and do not add that you cannot check it or that their accountant should confirm it. Point to an accountant only when the rule itself leaves the question open. For a question about a PAST period, or a FUTURE one (next year's rates where a budget has already set them), pass as_of so you get the rule for that date rather than the current one. If you do not know the exact key, call list_tax_rules first.","inputSchema":{"type":"object","properties":{"key":{"type":"string","description":"The rule key. Use list_tax_rules to see all available keys for the active company's country."},"as_of":{"type":"string","description":"Optional ISO date (YYYY-MM-DD) the answer must be true for. Pass this whenever the question is about a PAST period - a prior-year return, an old invoice, a historic filing - or a FUTURE one such as next year's rates, because rates change and the current rule may not be the one that applies then. The system walks the rule history and returns the version in force on that date, plus the period it applies to. Omit for questions about today: the answer is then the version in force today. A next-year rule may not be law yet; its answer says so."}},"required":["key"]},"title":"Lookup Tax Rule","annotations":{"title":"Lookup Tax Rule","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"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 when the user asks about QFZP status, whether they still qualify, their de minimis headroom, or whether they'll owe 9% CT.","inputSchema":{"type":"object","properties":{}},"title":"Get Qfzp Status","annotations":{"title":"Get Qfzp Status","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"list_tax_rules","description":"List all available verified tax/accounting rule keys for the active company's country (every live country has a library), optionally filtered by category. Use this when you need to find the right key for lookup_tax_rule.","inputSchema":{"type":"object","properties":{"category":{"type":"string","description":"Optional category filter. UK categories: vat, corporation_tax, self_assessment, paye, mtd, companies_house, dividends, directors, expenses, capital_gains, capital_allowances, pensions, income_tax, national_insurance, rd_relief. UAE categories: corporate_tax, vat, excise_tax, free_zones, esr, ubo, payroll, compliance. Omit to list all."}}},"title":"List Tax Rules","annotations":{"title":"List Tax Rules","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"recall_conversations","description":"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.)","inputSchema":{"type":"object","properties":{"limit":{"type":"number","description":"How many recent conversations to recall (default 5, max 15)."},"query":{"type":"string","description":"Optional keyword to filter to conversations about a topic (e.g. \"VAT\", \"payroll\", \"the Acme invoice\")."},"from":{"type":"string","description":"Optional first day to recall from, YYYY-MM-DD. Use with \"to\" when the user names a period: \"what did we do last month\", \"back in September\", \"during the year end\"."},"to":{"type":"string","description":"Optional last day to recall, YYYY-MM-DD, inclusive."}},"required":[]},"title":"Recall Conversations","annotations":{"title":"Recall Conversations","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"get_month_close","description":"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.","inputSchema":{"type":"object","properties":{"period_start":{"type":"string","description":"First day of the month to check, YYYY-MM-01. Omit for the last complete month."}},"required":[]},"title":"Get Month Close","annotations":{"title":"Get Month Close","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"reopen_month_close","description":"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.","inputSchema":{"type":"object","properties":{"period_start":{"type":"string","description":"First day of the closed month the user named, YYYY-MM-01. Required: the month is never assumed."}},"required":["period_start"]},"title":"Reopen Month Close","annotations":{"title":"Reopen Month Close","readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"calculate_vat_period","description":"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.","inputSchema":{"type":"object","properties":{"period_id":{"type":"string","description":"VAT period ID (UUID). Use get_vat_periods to find it."}},"required":["period_id"]},"title":"Calculate Vat Period","annotations":{"title":"Calculate Vat Period","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"get_expenses","description":"List expense claims. Use when the user asks about expenses, expense claims, reimbursements, or receipts they have submitted.","inputSchema":{"type":"object","properties":{"status":{"type":"string","description":"Filter by status: pending, approved, rejected, reimbursed, all (default: all)"},"limit":{"type":"number","description":"Max results (default 50)"}}},"title":"Get Expenses","annotations":{"title":"Get Expenses","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"get_statement_checks","description":"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.","inputSchema":{"type":"object","properties":{"bank_account_id":{"type":"string","description":"Limit to one bank account (optional)."}}},"title":"Get Statement Checks","annotations":{"title":"Get Statement Checks","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]},{"name":"month_close_summary","description":"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.","inputSchema":{"type":"object","properties":{"period_start":{"type":"string","description":"YYYY-MM-DD start of the period (e.g. 2026-05-01). Defaults to the first day of the previous calendar month."},"period_end":{"type":"string","description":"YYYY-MM-DD end of the period (e.g. 2026-05-31). Defaults to the last day of the previous calendar month."}}},"title":"Month Close Summary","annotations":{"title":"Month Close Summary","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"securitySchemes":[{"type":"oauth2","scopes":["email","profile"]}]}],"resources":[{"uri":"accountsos://company","name":"Company","description":"Company details and settings","mimeType":"application/json"},{"uri":"accountsos://transactions","name":"Transactions","description":"Recent transactions","mimeType":"application/json"},{"uri":"accountsos://documents","name":"Documents","description":"Uploaded documents","mimeType":"application/json"},{"uri":"accountsos://deadlines","name":"Deadlines","description":"Tax and filing deadlines","mimeType":"application/json"},{"uri":"accountsos://accounts-md","name":"ACCOUNTS.md","description":"The company's ACCOUNTS.md: who it is, how to do business with it, its figures with provenance, and how it works. Owner tier.","mimeType":"text/markdown"}]}