MCP & API Reference

Accounting tools for agents

The structured product surface behind BetterThanNothing: MCP-native tools and corresponding API operations for invoices, purchase bills, bank import, reconciliation, and operator-controlled UK VAT paths.

Auth

Authentication

Send an API token with each request using a bearer token header.

Header: Authorization: Bearer <token>
Base URL: NEXT_PUBLIC_API_URL such as http://localhost:8787

GET

/organisations/:organisationId/invoices

Lists sales invoices or purchase bills for an organisation.

Query	Type	Description
`direction`	string	`SALES` for invoices or `PURCHASE` for bills.
`limit`	number	Optional maximum number of rows to return.

POST

/organisations/:organisationId/invoices

Creates a draft sales invoice or purchase bill with document lines and tax treatment.

GET

/organisations/:organisationId/invoices/:invoiceId/pdf

Exports an invoice or bill as a generated PDF attachment.

POST

/organisations/:organisationId/bank-statement-lines/import-csv

Imports CSV rows into immutable bank statement lines with import-batch tracking and dedupe.

GET

/organisations/:organisationId/reconciliation/suggestions

Suggests unreconciled payments and bank transactions for a bank statement line.

POST

/organisations/:organisationId/reconciliation

Confirms a match and writes a bank reconciliation audit link.

POST

/organisations/:organisationId/hmrc-vat-returns

Submits an MTD VAT return when HMRC OAuth credentials are configured by the operator.