Referència d'eines

Aquestes són les funcions (eines, en terminologia MCP) que el teu assistent descobreix en connectar-se a B2Brouter. No cal que les cridis tu: l'assistent tria quina fer servir segons la teva pregunta. Aquesta llista et serveix per saber què pot consultar, per decidir-ne els permisos als ajustos del teu assistent o, si ets desenvolupador, per fer-les servir des del teu agent.

Totes són només de lectura. Cap eina pot crear, modificar, enviar ni esborrar res, i totes es declaren com a tals al protocol (readOnlyHint: true, destructiveHint: false).

Comptes

Eina	Què fa	Paràmetres principals	Requereix
`list_accounts`	Llista els comptes on el teu usuari és membre, amb nom, identificador i identificadors fiscals. És el primer pas per referir-se a un compte.	`detailed` (opcional)	Accés a un compte de pagament
`account_financial_summary`	Resum financer d'un compte: ingressos i despeses, pendents (al dia i vençuts), evolució mensual, principals clients i proveïdors, i factures per estat.	`account_identifier`, `range` o `date_from` + `date_to`, `currency`, `with_taxes`	Pla Professional o superior; accés a factures, pressupostos, pagaments o comandes

Factures

Eina	Què fa	Paràmetres principals	Requereix
`list_invoices`	Llista les factures emeses o rebudes d'un compte, de la més nova a la més antiga, amb filtres per estat, número, sèrie, dates, client o import.	`account_id`, `invoice_type` (`issued` o `received`), `query`, `limit`, `offset`	Pla Professional o superior; accés a factures emeses o rebudes
`show_invoice`	Retorna una factura completa (parts, imports, impostos, línies, dades de pagament i lliurament) en el mateix format que l'API REST.	`invoice_id`, `include`	Ídem
`validate_invoice`	Valida una factura i retorna si és vàlida i els errors XSD, Schematron i de model.	`invoice_id`	Ídem

Informes fiscals

Eina	Què fa	Paràmetres principals	Requereix
`list_tax_reports`	Llista els informes fiscals d'un compte (Verifactu, TicketBAI, SII, DGFiP, KSeF, ZATCA, MyInvois, SDI), amb estat i error de l'autoritat.	`account_id`, `query`, `limit`, `offset`	Pla Professional o superior; accés a informes fiscals o factures
`get_tax_report`	Detall d'un informe fiscal: estat, imports, desglossament d'impostos, línies, parts, identificadors/QR, error de l'autoritat i l'XML enviat.	`tax_report_id`	Ídem

Directori i documentació

Eina	Què fa	Paràmetres principals	Requereix
`directory_lookup`	Busca una empresa al directori de B2Brouter per identificador fiscal i diu com fer-li arribar documents: canal, tipus de document, codis de routing i camps obligatoris.	`identifier`, `scheme` i/o `country`	Accés a un compte de pagament; 50 cerques per dia i usuari
`knowledge_index`	Indica a l'assistent on és publicada la documentació oficial de B2Brouter (aquest portal) perquè la consulti.	cap	Accés a un compte de pagament
`knowledge_document`	Com `knowledge_index`; es manté perquè els clients que ja la fan servir no rebin un error.	`name` (s'ignora)	Accés a un compte de pagament

Paginació: list_invoices i list_tax_reports retornen 25 files per defecte i fins a 100 per pàgina (limit), amb offset, total_count i has_more.
Filtres: el paràmetre query accepta una expressió amb AND, OR, parèntesis i operadors per camp (per exemple, state = refused, date >= 2026-01-01 AND date <= 2026-03-31, number ~ FAC-2026). La sintaxi completa és a la descripció de cada eina, que el client MCP rep en connectar-se.
Identificadors de compte: account_id i account_identifier accepten l'identificador numèric o el textual que retorna list_accounts.
Errors: un identificador inexistent i un d'un altre compte retornen el mateix error («Not found or not authorized»). Consulta Cap oracle d'existència.
Documentació: knowledge_index i knowledge_document no retornen documents, només l'enllaç al portal. Perquè el teu agent pugui consultar la documentació, ha de poder llegir pàgines web.

Per veure exemples de preguntes que fan servir aquestes eines, consulta Què pots fer.