Herramientas
El servidor expone 17 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.
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.
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).
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.
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).
Facturas
resolve_invoice
Localiza una factura emitida existente.
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.
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
Emite un borrador (F1 o F2), haciéndolo fiscalmente vinculante. La factura se envía automáticamente a Verifactu.
send_invoice_email
Envía o reenvía una factura emitida por correo electrónico al contacto asociado.
Facturas recibidas
create_received_invoice
Registra una factura recibida de un proveedor. Antes de llamarla, usa resolve_contact y muestra al usuario el proveedor, número, fecha, líneas, totales, estado de pago, clasificación contable y estado del adjunto. Requiere confirmación explícita y un UUID nuevo en idempotency_key.
El servidor calcula los totales autorizados, detecta duplicados y rechaza períodos cerrados. control_totals permite comparar los totales del documento con los calculados por el servidor; la respuesta incluye las discrepancias.
La respuesta devuelve el id persistido, los totales autorizados, las discrepancias, el estado del adjunto y la URL de edición.
create_received_invoice_upload_session
Crea una sesión temporal para adjuntar opcionalmente el PDF o la imagen de la factura. Usa la upload_url devuelta o renderiza el recurso MCP App indicado en ui.resourceUri. Acepta un único documento validado; no envíes bytes, claves de almacenamiento ni credenciales como argumentos. Después, pasa upload_session_id a create_received_invoice.
update_received_invoice
Corrige una factura recibida existente tras mostrar y confirmar el estado completo corregido. Usa received_invoice_id y un UUID nuevo en idempotency_key; si cambia el proveedor, resuélvelo primero con resolve_contact. Los campos escalares omitidos se conservan y lines, si se envía, sustituye todas las líneas. attachment_action puede ser preserve, replace o remove; al reemplazar, upload_session_id es obligatorio. La respuesta incluye changed_fields, totales recalculados y el estado final del adjunto.