Referencia de herramientas

Estas son las funciones (herramientas, en terminología MCP) que tu asistente descubre al conectarse a B2Brouter. No hace falta que las invoques tú: el asistente elige cuál usar según tu pregunta. Esta lista te sirve para saber qué puede consultar, para decidir sus permisos en los ajustes de tu asistente o, si eres desarrollador, para usarlas desde tu agente.

Todas son de solo lectura. Ninguna herramienta puede crear, modificar, enviar ni borrar nada, y todas se declaran como tales en el protocolo (readOnlyHint: true, destructiveHint: false).

Cuentas

Herramienta	Qué hace	Parámetros principales	Requiere
`list_accounts`	Lista las cuentas donde tu usuario es miembro, con nombre, identificador e identificadores fiscales. Es el primer paso para referirse a una cuenta.	`detailed` (opcional)	Acceso a una cuenta de pago
`account_financial_summary`	Resumen financiero de una cuenta: ingresos y gastos, pendientes (al día y vencidos), evolución mensual, principales clientes y proveedores, y facturas por estado.	`account_identifier`, `range` o `date_from` + `date_to`, `currency`, `with_taxes`	Plan Professional o superior; acceso a facturas, presupuestos, pagos o pedidos

Facturas

Herramienta	Qué hace	Parámetros principales	Requiere
`list_invoices`	Lista las facturas emitidas o recibidas de una cuenta, de la más reciente a la más antigua, con filtros por estado, número, serie, fechas, cliente o importe.	`account_id`, `invoice_type` (`issued` o `received`), `query`, `limit`, `offset`	Plan Professional o superior; acceso a facturas emitidas o recibidas
`show_invoice`	Devuelve una factura completa (partes, importes, impuestos, líneas, datos de pago y entrega) en el mismo formato que la API REST.	`invoice_id`, `include`	Ídem
`validate_invoice`	Valida una factura y devuelve si es válida y los errores XSD, Schematron y de modelo.	`invoice_id`	Ídem

Informes fiscales

Herramienta	Qué hace	Parámetros principales	Requiere
`list_tax_reports`	Lista los informes fiscales de una cuenta (Verifactu, TicketBAI, SII, DGFiP, KSeF, ZATCA, MyInvois, SDI), con estado y error de la autoridad.	`account_id`, `query`, `limit`, `offset`	Plan Professional o superior; acceso a informes fiscales o facturas
`get_tax_report`	Detalle de un informe fiscal: estado, importes, desglose de impuestos, líneas, partes, identificadores/QR, error de la autoridad y el XML enviado.	`tax_report_id`	Ídem

Directorio y documentación

Herramienta	Qué hace	Parámetros principales	Requiere
`directory_lookup`	Busca una empresa en el directorio de B2Brouter por identificador fiscal y te dice cómo hacerle llegar documentos: canal, tipo de documento, códigos de routing y campos obligatorios.	`identifier`, `scheme` y/o `country`	Acceso a una cuenta de pago; 50 búsquedas al día por usuario
`knowledge_index`	Indica al asistente dónde está publicada la documentación oficial de B2Brouter (este portal) para que la consulte.	ninguno	Acceso a una cuenta de pago
`knowledge_document`	Igual que `knowledge_index`; se mantiene para que los clientes que ya la usan no reciban un error.	`name` (se ignora)	Acceso a una cuenta de pago

Paginación: list_invoices y list_tax_reports devuelven 25 filas por defecto y hasta 100 por página (limit), con offset, total_count y has_more.
Filtros: el parámetro query acepta una expresión con AND, OR, paréntesis y operadores por campo (por ejemplo, state = refused, date >= 2026-01-01 AND date <= 2026-03-31, number ~ FAC-2026). La sintaxis completa está en la descripción de cada herramienta, que el cliente MCP recibe al conectarse.
Identificadores de cuenta: account_id y account_identifier aceptan el identificador numérico o el textual que devuelve list_accounts.
Errores: un identificador inexistente y uno de otra cuenta devuelven el mismo error («Not found or not authorized»). Consulta Ningún oráculo de existencia.
Documentación: knowledge_index y knowledge_document no devuelven documentos, solo el enlace al portal. Para que tu agente pueda consultar la documentación, tiene que poder leer páginas web.

Para ver ejemplos de preguntas que usan estas herramientas, consulta Qué puedes hacer.