Herramientas

El servidor expone 14 herramientas agrupadas por área funcional.

Organización

`get_user_organization_info`

Devuelve el contexto de la organización activa (NIF, régimen fiscal y valores por defecto) para que el agente pueda operar con el contexto fiscal correcto cuando necesite contexto de empresa o valores fiscales.

`get_mcp_workflows_guidance`

Devuelve una guía resumida de workflows MCP (nombre del flujo, descripción y pasos de arranque) para ayudar al agente a planificar o ejecutar flujos de varios pasos.

Contactos

`list_contacts`

Busca contactos de la organización con filtros opcionales.

Parámetro	Tipo	Requerido	Descripción
`query`	string	No	Búsqueda por nombre (insensible a mayúsculas).
`document_number`	string	No	Filtro por número de documento (NIF/CIF).
`email`	string	No	Filtro por email.
`page`	integer	No	Número de página.

`resolve_contact`

Resuelve de forma determinista un único contacto. Devuelve status (unique / ambiguous / none) y hasta 5 candidatos. Úsalo antes de cualquier operación de escritura que necesite un contact_id.

Parámetro	Tipo	Requerido	Descripción
`query`	string	No	Búsqueda libre por nombre (insensible a mayúsculas).
`document_number`	string	No	Coincidencia exacta con NIF/CIF.
`email`	string	No	Coincidencia exacta con email.
`id`	integer	No	Id exacto del contacto. Ignora el resto de filtros.

Al menos uno de los cuatro campos es obligatorio.

`create_contact`

Crea un nuevo contacto en la organización. Idempotente por document_number: si ya existe un contacto con ese NIF/CIF, devuelve el existente en lugar de crear un duplicado.

`update_contact`

Actualiza los campos de un contacto existente. Solo se modifican los campos que se pasen (semántica PATCH).

Parámetro	Tipo	Requerido	Descripción
`id`	integer	Sí	Id del contacto a actualizar.

Productos

`resolve_product`

Resuelve de forma determinista un único producto. Devuelve status (unique / ambiguous / none) y candidatos. Úsalo antes de crear un borrador de factura.

Parámetro	Tipo	Requerido	Descripción
`query`	string	No	Búsqueda libre por concepto.
`id`	integer	No	Id exacto del producto.

Al menos uno de los dos campos es obligatorio.

`create_product`

Añade un nuevo producto al catálogo de la organización.

`update_product`

Actualiza los campos de un producto existente. Solo se modifican los campos que se pasen (semántica PATCH).

Parámetro	Tipo	Requerido	Descripción
`id`	integer	Sí	Id del producto a actualizar.

Facturas

`resolve_invoice`

Localiza una factura emitida existente.

Parámetro	Tipo	Requerido	Descripción
`id`	integer	No	Id exacto de la factura.
`full_number`	string	No	Número completo de la factura (p. ej. `A-2025-0042`).
`latest_for_contact_id`	integer	No	Devuelve la factura más reciente del contacto indicado.

`create_invoice_draft`

Crea un borrador de factura ordinaria (F1). El borrador no se emite; usa issue_invoice_draft para hacerlo fiscalmente vinculante. Devuelve el draft_id, un confirmation_token y una vista previa para mostrar al usuario antes de emitir.

Parámetro	Tipo	Requerido	Descripción
`contact_id`	integer	Sí	Id del contacto. Usa `resolve_contact` para obtenerlo.
`lines`	array	Sí	Al menos una línea. Cada línea debe tener `product_id` o (`concept` + `unit_price`).
`lines[].product_id`	integer	No	Id del producto. Precarga concepto, precio y tipo de IVA.
`lines[].concept`	string	No*	Requerido si no hay `product_id`. Sobreescribe el valor del producto si se indica.
`lines[].unit_price`	number	No*	Requerido si no hay `product_id`. Sobreescribe el valor del producto si se indica.
`lines[].quantity`	number	No	Por defecto `1`.
`lines[].tax_rate`	number	No	Sobreescribe el IVA del producto o el de la organización.
`lines[].discount_percent`	number	No	Descuento en porcentaje.
`operation_date`	string	No	Fecha ISO-8601.
`operation_description`	string	No	Descripción de la operación.
`payment_method`	string	No	Método de pago.
`payment_method_info`	string	No	Información adicional del método de pago.

`create_simplified_invoice_draft`

Crea un borrador de factura simplificada (F2), sin contacto asociado. Útil para tickets o ventas al público en general. Devuelve draft_id, confirmation_token y vista previa.

`issue_invoice_draft`

Operación destructiva e irreversible. Una vez emitida, la factura queda encadenada con hash y no puede modificarse ni eliminarse.

Ten en cuenta que las facturas no se enviarán a Verifactu hasta que no envies la solicitud desde la plataforma.

Emite un borrador (F1 o F2), haciéndolo fiscalmente vinculante. La factura se envía automáticamente a Verifactu.

Parámetro	Tipo	Requerido	Descripción
`draft_id`	integer	Sí	Id del borrador a emitir.
`confirmation_token`	string	No	Token devuelto por el paso de creación del borrador. Debe coincidir si fue generado.
`send_email`	boolean	No	Si es `true`, envía la factura emitida por correo al contacto. Por defecto `false`.

`send_invoice_email`

Envía o reenvía una factura emitida por correo electrónico al contacto asociado.

Parámetro	Tipo	Requerido	Descripción
`issued_invoice_id`	integer	Sí	Id de la factura emitida.

Prompt

`create_invoice`

Flujo guiado completo para emitir una factura. El agente resuelve el contacto y los productos, crea el borrador, presenta la vista previa y solicita confirmación explícita antes de emitir.

👋 Introducción

🔌 API REST

🤖 MCP

Herramientas

Herramientas

Organización

`get_user_organization_info`

`get_mcp_workflows_guidance`

Contactos

`list_contacts`

`resolve_contact`

`create_contact`

`update_contact`

Productos

`resolve_product`

`create_product`

`update_product`

Facturas

`resolve_invoice`

`create_invoice_draft`

`create_simplified_invoice_draft`

`issue_invoice_draft`

`send_invoice_email`

Prompt

`create_invoice`

​Herramientas

​Organización

​get_user_organization_info

​get_mcp_workflows_guidance

​Contactos

​list_contacts

​resolve_contact

​create_contact

​update_contact

​Productos

​resolve_product

​create_product

​update_product

​Facturas

​resolve_invoice

​create_invoice_draft

​create_simplified_invoice_draft

​issue_invoice_draft

​send_invoice_email

​Prompt

​create_invoice

Herramientas

Organización

`get_user_organization_info`

`get_mcp_workflows_guidance`

Contactos

`list_contacts`

`resolve_contact`

`create_contact`

`update_contact`

Productos

`resolve_product`

`create_product`

`update_product`

Facturas

`resolve_invoice`

`create_invoice_draft`

`create_simplified_invoice_draft`

`issue_invoice_draft`

`send_invoice_email`

Prompt

`create_invoice`