Tools reference

These are the functions (tools, in MCP terminology) that your assistant discovers when it connects to B2Brouter. You don't need to call them yourself: the assistant picks which one to use based on your question. This list helps you know what it can query, decide on their permissions in your assistant's settings or, if you're a developer, use them from your agent.

They are all read-only. No tool can create, modify, send or delete anything, and they are all declared as such in the protocol (readOnlyHint: true, destructiveHint: false).

Accounts

Tool	What it does	Main parameters	Requires
list_accounts	Lists the accounts where your user is a member, with name, identifier and tax IDs. It's the first step to refer to an account.	detailed (optional)	Access to a paid account
account_financial_summary	Financial summary of an account: revenue and expenses, pending amounts (on time and overdue), monthly evolution, top customers and suppliers, and invoices by status.	account_identifier, range or date_from + date_to, currency, with_taxes	Professional plan or higher; access to invoices, quotes, payments or orders

Invoices

Tool	What it does	Main parameters	Requires
list_invoices	Lists an account's issued or received invoices, newest first, with filters by status, number, series, dates, customer or amount.	account_id, invoice_type (issued or received), query, limit, offset	Professional plan or higher; access to issued or received invoices
show_invoice	Returns a complete invoice (parties, amounts, taxes, lines, payment and delivery details) in the same format as the REST API.	invoice_id, include	Same as above
validate_invoice	Validates an invoice and returns whether it's valid, along with any XSD, Schematron and model errors.	invoice_id	Same as above

Tax reports

Tool	What it does	Main parameters	Requires
list_tax_reports	Lists an account's tax reports (Verifactu, TicketBAI, SII, DGFiP, KSeF, ZATCA, MyInvois, SDI), with status and the authority's error.	account_id, query, limit, offset	Professional plan or higher; access to tax reports or invoices
get_tax_report	Tax report detail: status, amounts, tax breakdown, lines, parties, identifiers/QR, the authority's error and the XML sent.	tax_report_id	Same as above

Directory and documentation

Tool	What it does	Main parameters	Requires
directory_lookup	Looks up a company in the B2Brouter directory by tax ID and tells you how to reach it with documents: channel, document types, routing codes and mandatory fields.	identifier, scheme and/or country	Access to a paid account; 50 searches per day and user
knowledge_index	Tells the assistant where B2Brouter's official documentation (this portal) is published so it can consult it.	none	Access to a paid account
knowledge_document	Same as knowledge_index; kept so that clients already using it don't get an error.	name (ignored)	Access to a paid account

For technical profiles.

• Pagination: list_invoices and list_tax_reports return 25 rows by default and up to 100 per page (limit), with offset, total_count and has_more.
• Filters: the query parameter accepts an expression with AND, OR, parentheses and per-field operators (for example, state = refused, date >= 2026-01-01 AND date <= 2026-03-31, number ~ FAC-2026). The full syntax is in each tool's description, which the MCP client receives when it connects.
• Account identifiers: account_id and account_identifier accept either the numeric identifier or the text identifier returned by list_accounts.
• Errors: a non-existent identifier and one from another account return the same error ("Not found or not authorized"). See No existence oracle.
• Documentation: knowledge_index and knowledge_document don't return documents, only the link to the portal. For your agent to consult the documentation, it must be able to read web pages.

For example questions that use these tools, see What you can do.