Catálogo de tools

El servidor MCP de Factuarea publica 668 tools en los dominios de la API pública. Esta página es la lista canónica; el esquema de entrada de cada tool se descubre en tiempo de ejecución mediante tools/list. Cada tool se corresponde con la misma operación en la Referencia de la REST API. Las diez tools que aprovisionan cuentas gestionadas no forman parte de ese total: están al final, porque una key necesita los scopes privilegiados accounts:* para verlas.

Cómo leer este catálogo

• Tool — el nombre de la tool MCP que invoca tu agente.
• Scope — el scope granular que debe tener la credencial para que la tool aparezca en tools/list y sea invocable. Consulta Scopes y permisos.
• Category — el bucket de límite de peticiones al que pertenece la tool: read, write, destructive, send o generate. Consulta Errores y límites de peticiones.

Una credencial solo ve las tools que cubren sus scopes. Una API key con el super-scope * las ve las 668; una key más restringida o un token OAuth ve un subconjunto.

Dominios

Facturas

Facturas: búsqueda, CRUD, rectificativas, ledger de pagos parciales, transiciones (issue/paid/sent/void/annul), programación, operaciones masivas, recordatorios, enlaces públicos, PDFs, presentaciones, enrutado administrativo y exportación a Excel. (51 tools)

get_invoice devuelve la factura completa por su id público: datos comerciales, ids de línea (UUIDv7), centros efectivos, snapshot, override, versión y revisión administrativas y los snapshots estructurados originales. Conserva null y las listas vacías tal como se guardaron. get_invoice_pdf devuelve el enlace firmado de descarga exacto cuando existe una salida retenida; el modo compatible aún puede devolver el PDF en base64. send_invoice puede adjuntar el fichero FacturaE con attach_facturae=true; con submission_id adjunta esa presentación existente, sin crear ni reintentar ninguna, y exige attach_facturae=true. update_invoice_public_link admite revoke, activate, extend (con extend_days), reset o publish, este último con la referencia exacta y la versión observada.

list_invoice_administrative_revisions lee la versión administrativa, el snapshot, el override y el historial por el id público de la factura. Distingue el null heredado de [] y no consulta los centros actuales del contacto. revise_invoice_administrative_routing añade una revisión administrativa con la lista completa de centros, un motivo y expected_version (un entero positivo); [] borra los centros efectivos y no se modifica la fiscalidad. Si falta la versión responde 428; si está obsoleta, 409 con current_version. Reintentar con la versión antigua no duplica la revisión. Devuelve la revisión creada y su propia administrative_version.

assign_invoice_presentation asigna un template_id (UUIDv7) o un null explícito para heredar, con expected_version. Solo se aplica a borradores de la empresa autenticada y no modifica importes ni numeración. get_invoice_presentation lee el estado visual y la captura retenida de un documento autorizado, y list_invoice_presentations lista las capturas retenidas en orden descendente, con page/per_page y los metadatos capturados; ninguna escribe, consulta artefactos ni genera un PDF. revise_invoice_presentation crea una revisión visual auditada con su padre, una comprobación compare-and-set (CAS) y los tokens auténticos de vista previa presentation_revision; current_legal solo admite una corrección jurídica real de una factura emitida. No reemite ni recalcula. Consulta Presentación de documentos.

Contactos

(28 tools)

Los contactos fiscales canónicos tienen roles acumulables de cliente, proveedor y lead; son la única superficie MCP pública para identidades de terceros. No se publican tools separadas de cliente o proveedor. La plantilla CSV sigue siendo una descarga REST. Consulta Migración de contactos.

Productos

Catálogo: búsqueda, CRUD, opciones/combinaciones configurables, ledger de stock, presentaciones, variantes, ofertas de proveedor, acciones masivas, analítica y media. (40 tools)

create_product, update_product, create_product_variant, update_product_variant, create_product_presentation y update_product_presentation aceptan gross_weight_kg: el peso bruto de transporte en kg (hasta cuatro decimales, mayor que cero) por unidad base en productos y variantes y por unidad comercial en presentaciones fijas. En las tres tools de edición, omitirlo conserva el peso actual y null lo borra. Los servicios, las unidades base de masa (KGM, GRM) y las presentaciones variable_measure lo rechazan con gross_weight_not_allowed.

preview_product_base_unit_replacement y replace_product_base_unit cambian la unidad base de un producto sustituyéndolo por uno nuevo. La vista previa calcula, sin escribir nada, qué ocurre con el stock, el precio, las presentaciones, las variantes, las ofertas de proveedor, las tarifas y los packs, y qué documentos pendientes seguirán apuntando al producto antiguo; es una lectura, pero requiere products:write y devuelve el impact_token que exige la sustitución. La sustitución es irreversible: el producto antiguo queda desactivado con su historial, exige ese impact_token y acepta idempotency_key.

Tarifas

Precios por cliente y documento: gestionar ítems activos/retirados, opciones compactas y resolver selecciones de catálogo configurable. (13 tools)

Presupuestos

Presupuestos: búsqueda, CRUD, aceptar/rechazar, enviar, convertir a factura, operaciones masivas, búsqueda por ID externo, enlaces públicos, PDFs y presentaciones. (24 tools)

get_quote_pdf devuelve el enlace firmado de descarga exacto (download_url) con su caducidad (expires_at) cuando existe una salida retenida, o su estado mientras aún se está generando; el modo compatible devuelve el contenido en base64. update_quote_public_link admite revoke, activate, extend (con extend_days), reset o publish, este último con la referencia exacta y la versión observada.

assign_quote_presentation asigna un template_id (UUIDv7) o un null explícito para heredar, con expected_version. Solo se aplica a borradores de la empresa autenticada y no modifica importes ni numeración. get_quote_presentation lee el estado visual y la captura retenida de un documento autorizado, y list_quote_presentations lista las capturas retenidas en orden descendente, con page/per_page y los metadatos capturados; ninguna escribe, consulta artefactos ni genera un PDF. revise_quote_presentation crea una revisión visual auditada con su padre, una comprobación compare-and-set (CAS) y los tokens auténticos de vista previa presentation_revision. Conserva la fuente capturada y admite el propósito complete en formato A4. No reemite ni recalcula. Consulta Presentación de documentos.

Facturas proforma

Proformas: búsqueda, CRUD, aceptar/rechazar, enviar, convertir, operaciones masivas, búsqueda por ID externo, enlaces públicos, PDFs y presentaciones. (24 tools)

get_proforma_pdf devuelve el enlace firmado de descarga exacto (download_url) con su caducidad (expires_at) cuando existe una salida preparada, o su estado mientras aún se está generando; 404 pdf_artifact_not_found significa que ningún PDF conservado coincide con la presentación, el propósito y el formato actuales del documento; un PDF conservado que falló al renderizarse o no se puede verificar responde el error de PDF no disponible (500), y uno borrado por privacidad responde 410; el modo compatible devuelve el contenido en base64. update_proforma_public_link admite revoke, activate, extend, reset o publish, este último con la referencia exacta y la versión observada.

assign_proforma_presentation asigna un template_id (UUIDv7) o un null explícito para heredar, con expected_version. Solo se aplica a borradores de la empresa autenticada y no modifica importes ni numeración. get_proforma_presentation lee el estado visual y la captura retenida de un documento autorizado, y list_proforma_presentations lista las capturas retenidas en orden descendente, con page/per_page y los metadatos capturados; ninguna escribe, consulta artefactos ni genera un PDF. revise_proforma_presentation crea una revisión visual auditada con su padre, una comprobación compare-and-set (CAS) y los tokens auténticos de vista previa presentation_revision. Solo conserva la fuente capturada y admite el propósito complete en formato A4. No reemite ni recalcula. Consulta Presentación de documentos.

Albaranes

Albaranes: búsqueda, CRUD, entregar/cancelar/firmar, convertir, enviar, operaciones masivas, búsqueda por ID externo, enlaces públicos, PDFs, presentaciones y borrado GDPR de la firma. (26 tools)

get_delivery_note_pdf devuelve el enlace firmado de descarga exacto (download_url) con su caducidad (expires_at) cuando existe una salida preparada, o su estado mientras aún se está generando; 404 pdf_artifact_not_found significa que ningún PDF conservado coincide con la presentación, el propósito y el formato actuales del documento; un PDF conservado que falló al renderizarse o no se puede verificar responde el error de PDF no disponible (500), y uno borrado por privacidad responde 410; el modo compatible devuelve el contenido en base64. update_delivery_note_public_link admite revoke, activate, extend, reset o publish, este último con la referencia exacta y la versión observada. En send_delivery_note, presentation_precondition identifica el PDF exacto que se revisó, y expected_presentation_uuid y expected_publication_id fijan las identidades esperadas. Para aceptar una presentación exacta, sign_delivery_note admite expected_presentation_id, expected_external_version, expected_source_token, expected_artifact_id y una operation_key (UUID v7); expected_publication_id es opcional si no hubo publicación. Estos campos solo tienen efecto cuando la presentación revisionada está activada para la empresa; en caso contrario se ignoran.

assign_delivery_note_presentation asigna un template_id (UUIDv7) o un null explícito para heredar, con expected_version. Solo se aplica a borradores de la empresa autenticada y no modifica importes ni numeración. get_delivery_note_presentation lee el estado visual y la captura retenida de un documento autorizado, y list_delivery_note_presentations lista las capturas retenidas en orden descendente, con page/per_page y los metadatos capturados; ninguna escribe, consulta artefactos ni genera un PDF. revise_delivery_note_presentation crea una revisión visual auditada con su padre, una comprobación compare-and-set (CAS) y los tokens auténticos de vista previa presentation_revision. Solo conserva la fuente capturada y admite el propósito complete en formato A4. No reemite ni recalcula. Consulta Presentación de documentos.

Documentos de control

Documento electrónico de control administrativo (DeCA) del transporte de mercancías por carretera: búsqueda, borradores (también prerrellenados desde albaranes), emisión, modificación durante el servicio, cierre, reapertura, anulación, sustitución, envío de la copia al transportista por email, registro de emisión y PDF de cada versión. (15 tools)

issue_transport_document, modify_transport_document, cancel_transport_document, supersede_transport_document y send_transport_document son irreversibles y aceptan idempotency_key. get_transport_document_pdf devuelve la URL pública permanente y los metadatos de la versión (sha256, tamaño), nunca los bytes del PDF. El código QR y el justificante de emisión son descargas binarias de la REST API sin tool (GET /v1/companies/{company}/transport-documents/{transport_document}/qr y /issuance-proof), y los lugares de carga solo se gestionan en la app. Consulta Documento de control (DeCA).

search_transport_documents admite el mismo q (de 1 a 255 caracteres) y el mismo sort que GET /v1/companies/{company}/transport-documents: transport_date, number, created o updated, con un - delante para el orden descendente y -transport_date por defecto. create_transport_document no admite id, igual que el endpoint REST: lo genera el servidor y un argumento id se ignora. Las tools de alta y de edición pasan los UUID a minúsculas y responden a un shipments[].id que ya está en uso, o que es de otro documento, con el mismo 422 en shipments.N.id que la REST API. Las tools que dejan una entrada en el registro de emisión (emitir, modificar, cerrar, reabrir, anular, sustituir y enviar) la atribuyen a la credencial que las llama (la clave de API, o el cliente OAuth con el usuario que lo autorizó), nunca al usuario que creó la clave; get_transport_document_evidence devuelve ese actor en actor_name e informa los cierres automáticos como auto_closed.

Gastos

Gastos: búsqueda, CRUD, marcar como pagado, ledger de pagos parciales, operaciones masivas, listas de pendientes/vencidos, búsqueda por ID externo, adjuntos de archivo y recibos de pago. (19 tools)

create_purchase_invoice y update_purchase_invoice aceptan el contrato de línea medida (purchase_measurement, discount_percent, price_source, source_line_index); duplicar desde source_purchase_invoice_id exige además purchase_invoices:read. Consulta Líneas de compra medidas.

Escáner de compras

Recibe documentos mediante la API multipart o el buzón del escáner, consulta la extracción y sus evidencias, corrige campos, resuelve duplicados y crea un borrador de compra. La subida y descarga de originales usan HTTP; MCP gestiona los escaneos persistidos. Consulta la guía del escáner de documentos. (10 tools)

Dos operaciones del escáner de compras se quedan fuera de MCP a propósito y solo existen en REST: subir un escaneo (POST /v1/companies/{company}/purchase-scans) es una subida multipart/binaria que MCP no puede transportar, y descargar el fichero original (GET /v1/companies/{company}/purchase-scans/{id}/source) devuelve el binario cifrado, por lo que MCP expone sus metadatos en su lugar. PublicApiV1McpToolParityTest.php mantiene ambas en su allowlist. Sustituir el fichero original no tiene endpoint en v1 — solo está disponible desde la aplicación web.

Facturas recurrentes

Plantillas recurrentes: búsqueda, CRUD, crear desde una factura, activar/pausar/reanudar/cancelar/saltar, cambio de estado en bloque, previsualización, generar ahora, búsqueda por ID externo, logs y actividad. (19 tools)

generate_recurring_invoice genera una factura ahora desde una recurrencia de la empresa autenticada y, según generation_mode, puede emitirla y enviarla. Es irreversible: requiere confirmación del host o de la UI y una clave de idempotencia, y los reintentos reproducen la misma respuesta. No cambia la configuración ni la fecha del intento. Exige recurring_invoices:transition, como pausar y reanudar, que es lo que concede el scope OAuth recurring.generate_now; la operación REST POST /v1/companies/{company}/recurring-invoices/{recurring_invoice}/generate sigue exigiendo recurring_invoices:write.

Series

Series de numeración (editables bajo las guardas fiscales de la numeración, nunca se eliminan): búsqueda, crear, actualizar, archivar/desarchivar, marcar por defecto, arrancar las cuatro series por defecto de una empresa recién dada de alta, estadísticas, preferencia de plantilla PDF y actividad. (15 tools)

create_series con un pdf_template_id exige la misma autorización que update_series. get_series_pdf_template lee la preferencia de PDF de una serie propia, su versión y su disponibilidad. Conserva la referencia guardada aunque ahora no sea elegible, y no genera documentos ni altera la numeración. assign_series_pdf_template asigna una plantilla compatible de la empresa, o limpia la preferencia con null para heredar. expected_version es la versión del CAS visual leída de la serie, y un replay con la misma clave se resuelve antes de esa comprobación. No renumera ni genera un PDF. unarchive_series siempre funciona: si la plantilla PDF que conservaba la serie ya no es seleccionable, la respuesta añade warnings con inherited_candidate_unavailable y la serie usa la plantilla por defecto aplicable, sin perder la referencia guardada.

Plantillas PDF

Biblioteca de plantillas PDF de la empresa: plantillas, marcas comerciales, activos privados, preferencias por contacto y de la empresa, revisiones e impacto. Requiere el módulo pdf_templates. (25 tools)

Crear, renombrar, archivar, restaurar y publicar una revisión, y guardar preferencias, exigen un administrador. Las tools que cambian una entidad existente llevan expected_version (una comprobación compare-and-set), y un replay con la misma clave se resuelve antes de esa comprobación. create_pdf_template y create_pdf_commercial_identity crean una entidad nueva, así que no llevan expected_version; upload_pdf_template_asset crea un activo privado nuevo y tampoco la lleva. Reutiliza la idempotency_key al reintentarlas para no crear ni subir nada dos veces. duplicate_pdf_template lleva el expected_version de la plantilla origen que has leído y, con idempotency_key, evita crear dos copias. Las tools de lectura son lecturas autorizadas del emisor y no necesitan clave de idempotencia ni precondición de escritura. Consulta la guía de la biblioteca de plantillas PDF.

Artefactos y vistas previas PDF

Artefactos y vistas previas PDF: preparar el PDF de una captura autorizada, ejecutar el plan retenido, leer los metadatos y verificar el original, y previsualizar una plantilla. (5 tools)

prepare_pdf_artifact prepara el PDF de una captura autorizada exacta; nunca crea una captura. render_pdf_artifact ejecuta el plan retenido exacto en modo sync o async, sin fallback en vivo. get_pdf_artifact lee los metadatos seguros del artefacto exacto; el sondeo nunca genera nada. read_pdf_artifact verifica el PDF original y devuelve sus metadatos con un enlace firmado corto, nunca base64. preview_pdf_template prepara una vista previa con la autoridad y los scopes pdfs:read + pdf_templates:read; no captura ni publica. Consulta Vistas previas y artefactos PDF.

Impuestos

Impuestos (catálogo de Factuarea más los propios de tu empresa): búsqueda, alta, edición, borrado, valores por defecto por empresa, comprobaciones de uso, cálculos de impuesto/totales y el catálogo fiscal AEAT de solo lectura (regímenes, causas de exención, tipos de IRPF y los pares legales IVA ↔ recargo de equivalencia). (18 tools)

VeriFactu

SIF de la AEAT: registros, eventos, validación de cadena, reintento (de un registro o de todos los bloqueados), subsanación de registros aceptados o rechazados, representación para la remisión por tercero, certificados, ajustes, declaración responsable y log de acceso a la AEAT. (31 tools)

FacturaE (FACe)

Facturación electrónica B2G: descarga el XML FacturaE 3.2.2 de una factura y gestiona sus presentaciones a FACe (enviar, seguir, cancelar). Requiere el módulo facturae. (5 tools)

cancel_face_submission exige además la capacidad edit sobre el módulo facturae; sin ella la llamada responde 403 facturae_operation_forbidden.

Informes fiscales

Declaraciones ante la AEAT calculadas a partir de tus propios datos de facturación: genera el Modelo 303, el 347 y el 130 como fichero posicional oficial, PDF o libro de revisión; previsualiza el desglose sin persistir nada; y lee el histórico de generaciones, sus estadísticas, su actividad y sus ficheros. (9 tools)

Ante la AEAT solo se presenta el txt_aeat; el PDF y el libro son material de revisión construido con el mismo cálculo. Consulta Informes fiscales.

Webhooks y eventos

Endpoints de webhook de un NIF, entregas, rotación de secreto, ping/replay, eventos de prueba y el catálogo de eventos publicados. La cuenta tiene sus propios endpoints: Webhooks de cuenta. (13 tools)

Automatizaciones

El motor de automatizaciones: reglas con la forma cuando → si → haz, las versiones inmutables de la definición de cada regla, el ensayo que dice qué haría una regla sin llegar a hacerlo, el historial de ejecuciones con sus pasos y sus motivos de descarte tipificados, el relanzamiento de un paso aparcado o de una ejecución entera, el catálogo de disparadores y acciones con los campos que expone cada disparador, y la cuota mensual de ejecuciones. Requiere el módulo automations. (18 tools)

Cuenta

Identidad fiscal y personalización de la cuenta: verifica el par nombre + NIF registrado de la empresa contra el censo de la AEAT, consulta plantillas de personalización y actualiza la personalización de la cuenta. (4 tools)

Administración de la cuenta

Titularidad de la cuenta y traspaso de NIF entre cuentas: emitir, listar, aceptar y revocar un traspaso de NIF, y pasar la titularidad de la cuenta a otro miembro. Son operaciones de la cuenta, no de los datos de un NIF. Al emitir un traspaso se devuelve su secreto una sola vez; la cuenta que lo recibe lo acepta con ese secreto y la cuenta que lo entrega puede revocarlo hasta entonces. accept_nif_transfer, create_nif_transfer, revoke_nif_transfer y transfer_account_ownership son irreversibles: el servidor las publica con destructiveHint: true y una entrada idempotency_key (consulta Protocolo y transporte). Cuando los NIF aceptados necesitan plazas contratadas y no hay ninguna libre, accept_nif_transfer compra las que faltan, así que envía siempre una idempotency_key. (no forman parte de los totales de arriba: * no cubre sus scopes)

Miembros de la cuenta

Las personas de la cuenta: listar y consultar los miembros con su rol de cuenta (owner, admin o member) y su marca de asesor externo, añadir un miembro, cambiar su rol o su marca de asesor externo y retirarlo, consultar, fijar y retirar el grant de un miembro sobre un NIF, consultar y fijar su acceso por módulo, y gestionar las invitaciones que los crean. delete_account_member es irreversible: el servidor la publica con destructiveHint: true y una entrada idempotency_key. (no forman parte de los totales de arriba: * no cubre sus scopes)

NIF de la cuenta

La cartera de NIF de la cuenta: listar, buscar por identificador fiscal, consultar, dar de alta, actualizar, activar (uno o varios), desactivar y archivar NIF, seguir y reconciliar el alta de uno, las estadísticas de facturación por NIF, si un NIF ya puede emitir y una vista previa del cargo de añadir o activar NIF adicionales, además del uso de la cuenta en el periodo vigente (peticiones y documentos, con desglose por NIF). Los NIF adicionales se cobran por plaza contratada: get_additional_nif_seats consulta las plazas contratadas, ocupadas y libres de la cuenta, preview_additional_nif_seat_change previsualiza, sin cobrar, fijarlas en una cantidad y update_additional_nif_seats la fija (cantidad absoluta, idempotente con idempotency_key). Comprar plazas cobra al momento la diferencia prorrateada; reducirlas tiene efecto en la renovación. Por debajo de las plazas ocupadas, deactivate lista los UUID de los NIF que se desactivarán en la renovación, exactamente tantos como sobran; si la reducción hace terminar un paquete de oferta aplicado, accept_offer_package_loss (booleano) confirma la pérdida. create_company, activate_company y activate_companies compran las plazas que faltan cuando no hay ninguna libre y la cuenta paga, así que envía una idempotency_key. Dar de alta o reactivar un NIF adicional puede cobrarse: consulta NIF adicionales. (18 tools)

Webhooks de cuenta

Los endpoints de webhook de la cuenta, distintos de los endpoints de un NIF: crear, consultar, listar, actualizar y eliminar un endpoint, rotar su secreto de firma, enviar una entrega de prueba, consultar sus entregas y reintentar una fallida. Un endpoint de cuenta recibe los eventos de la cuenta y, según account_relationship (own, managed o all), los de sus NIF. Consulta Webhooks de cuenta. (10 tools)

Estas tools usan los mismos scopes webhooks:* que Webhooks y eventos, pero funcionan solo con API key: un token OAuth nunca las lista y, si llama a una, recibe 403 forbidden_action. Una clave de pruebas lee los endpoints de prueba; crear, actualizar, eliminar, rotar, probar y reintentar exigen una clave de producción. La persona que emitió la clave debe ser hoy titular o administradora de la cuenta, y la clave debe cubrir todos los NIF de la cuenta. delete_account_webhook y rotate_account_webhook_secret son irreversibles: el servidor las publica con destructiveHint: true y una entrada idempotency_key.

API keys

API keys self-service de tu cuenta: listar, crear, consultar, ver su uso diario, rotar el secreto, revocar y sustituir el ámbito de NIF de una key. El ámbito nuevo nunca puede superar el de la credencial que lo cambia. El secreto se devuelve una sola vez, al crear y al rotar. revoke_api_key y rotate_api_key_secret son irreversibles: el servidor las publica con destructiveHint: true y una entrada idempotency_key. Consulta las claves acotadas. (7 tools)

Control horario de la cartera

Panel consolidado de cumplimiento horario de la cartera de NIF: una fila por NIF activo dentro del ámbito de la credencial, sin la empresa titular de la cuenta, con el estado de su último cierre mensual y los totales del último cierre (saldo, horas extra y número de empleados). Una sola llamada agrega toda la cartera, mientras que el resto de tools de control horario opera sobre un NIF. (1 tools)

Pagos y pasarelas

Integraciones de pagos y tiendas: facturación automática de Stripe, cuentas conectadas, liquidaciones, bandeja de eventos, gestión y diagnóstico de tiendas WooCommerce y Shopify. Estas herramientas solo admiten API key. La disponibilidad también depende de los módulos de la empresa y de la configuración del proveedor. (26 tools)

Correos enviados

Registro de correos enviados: lista los correos que Factuarea ha enviado en nombre de la empresa (facturas, presupuestos, albaranes, recordatorios de pago), consulta uno por su id y resume de una sola vez cómo acabó el envío de un lote de hasta 100 documentos. Úsalo para responder «¿se envió el correo de esta factura?» y para investigar envíos fallidos. (3 tools)

Registro de peticiones a la API

El tráfico de tu integración contra la API pública v1 en los últimos 30 días: lista las llamadas con su método, ruta, código de estado, duración, prefijo de API key y entorno, con filtros por solo errores o por cualquiera de esos campos, y consulta una concreta por su request_id, el identificador opaco que la API devuelve en la cabecera de cada respuesta. list_developers_request_logs y get_developers_request_logs muestran las peticiones de un NIF; list_account_request_logs y get_account_request_log muestran las de todas las claves de la cuenta, en el entorno de la clave que llama. Las tools de cuenta funcionan solo con API key, emitida por un titular o administrador de la cuenta y que cubra todos los NIF de la cuenta: consulta los registros de peticiones de la cuenta. Úsalas para depurar una integración: qué llamó, cuándo, con qué código de estado y cuánto tardó. Las cabeceras, el cuerpo y la query string no se almacenan y nunca se devuelven. (4 tools)

Empleados

Plantilla de personal: búsqueda, alta/edición/baja/reactivación, estadísticas y el ciclo de invitaciones (enviar/reenviar/cancelar y listar invitaciones de empleado). Requiere el módulo control_horario. (18 tools)

create_employee y reactivate_employee compran las plazas contratadas que faltan cuando no hay ninguna libre y la cuenta paga: envía una idempotency_key para que un reintento no cobre dos veces. Consulta Plazas de empleado.

Plazas de empleado

Facturación de las plazas de empleado por plaza contratada: previsualizar y consultar el cargo y la facturación, suscribir, fijar las plazas contratadas, cambiar la cantidad y cancelar el add-on, además de los canjes de ofertas de plazas. update_employee_seats fija las plazas contratadas (cantidad absoluta, idempotente con idempotency_key): comprar cobra al momento la diferencia prorrateada y reducir tiene efecto en la renovación, sin abono. preview_employee_seat_charge previsualiza el cargo, sin cobrar, de dar de alta empleados o, con contracted_seats, de fijar las plazas; contracted_seats no se combina con count ni con employee_ids. Cuando la nueva cantidad queda por debajo de las plazas ocupadas, update_employee_seats, update_additional_nif_seats y cancel_employee_seat_addon aceptan deactivate, la lista de UUID de lo que se desactiva en la renovación, y accept_offer_package_loss, un booleano que confirma la pérdida de un paquete de oferta aplicado si la reducción lo rompe. Requiere el módulo control_horario. (12 tools)

Ofertas de plazas de empresas gestionadas

Las ofertas privadas de plazas de empresas gestionadas usan la empresa matriz pagadora y el scope vigente companies:*. Preparar o actualizar una cotización no activa empresas ni cobra. prepare_employee_seat_offer_redemption y prepare_gestoria_seat_offer_redemption aceptan kind: apply_to_existing, que aplica el código a las plazas que la cuenta ya tiene y no crea, activa ni reactiva nada; no lleva ninguna otra clave. Durante la prueba, un canje de plazas responde 422 customer_offer_not_eligible con details.reason = trial_active, y un código de paquete de oferta, que MCP no canjea, responde reason = product (consulta Ofertas). (6 tools)

Horarios de trabajo

Horarios de trabajo semanales y sus asignaciones: búsqueda, CRUD, archivar/desarchivar, asignar/desasignar a empleados y consultar el horario efectivo de un empleado. Requiere el módulo control_horario. (11 tools)

Control horario

Registro de jornada (RD-ley 8/2019): fichar entrada/salida con pausas, entradas manuales, el flujo de correcciones de fichaje, saldos y hojas de horas mensuales, el cierre mensual inalterable del registro (cerrar/reabrir/sellar, firma, validación de cadena) y sus exportaciones, además de las exportaciones de nómina. Requiere el módulo control_horario. (29 tools)

Ausencias

Ausencias: tipos, políticas (con configuración de carryover y asignaciones), solicitudes (crear/aprobar/rechazar/cancelar), saldos y el calendario de ausencias del equipo. Requiere el módulo control_horario. (25 tools)

Presencia

Presencia: el panel de presencia en vivo y el estado de presencia por empleado y diario. Requiere el módulo control_horario. (3 tools)

Festivos

Festivos: consultar el calendario de festivos de la empresa y resolver los festivos aplicables a la región (CCAA) de un empleado. Requiere el módulo control_horario. (3 tools)

Proyectos

Proyectos de tareas y sus tableros: crear, editar, archivar y borrar proyectos, resolver uno por su clave (DEV), gestionar las columnas de su tablero y sus campos personalizados de tarea, exportar e importar sus tareas en JSON, consultar el tiempo imputado y convertir el tiempo facturable en un borrador de factura (invoice_project_time exige invoices:write, porque crea una factura). Requiere el módulo tasks. delete_project, delete_project_column y delete_project_custom_field son irreversibles, igual que las tools de borrado de Tareas. (22 tools)

Tareas

Tareas del tablero: buscar, crear, editar, duplicar, mover, recolocar y borrar tareas —una a una o en bloque—, resolver una por su clave (DEV-12), cambiar su estado, asignarla, etiquetarla, comentarla, relacionarla con otras tareas, vincularla a documentos y contactos, adjuntar ficheros o crear un enlace de subida de un solo uso, imputar tiempo con temporizador y leer su actividad. El tiempo imputado aquí es tiempo de tarea, no el fichaje de jornada del control horario. Requiere el módulo tasks. (52 tools)

Usuarios

Los miembros de la empresa —las personas a las que se puede asignar una tarea— y el usuario de la credencial. No depende de ningún módulo del plan. (2 tools)

Notificaciones

Los avisos de la bandeja de la persona titular de la credencial: listarlos y marcar uno o todos como leídos. No depende de ningún módulo del plan. (3 tools)

Agenda de la empresa

La agenda combinada de una ventana de hasta 93 días: tareas con vencimiento y, en cada capa que la credencial también puede leer, vencimientos de facturas y gastos, caducidades de presupuestos y proformas, ejecuciones de facturas recurrentes, plazos fiscales, ausencias y festivos. Requiere el módulo tasks. (1 tools)

Tools de cuentas gestionadas

Las diez tools que aprovisionan y administran cuentas gestionadas no forman parte de las 668 de arriba ni cuentan en los 41 dominios. Sus scopes, accounts:read y accounts:write, son privilegiados: el super-scope * no los cubre, así que una key que solo tenga * no ve estas tools en tools/list. Indica el scope de forma explícita. Además, cada llamada comprueba que tu cuenta tenga el privilegio de proveedor de cuentas gestionadas que concedemos nosotros, y responde 403 privileged_scope_required si no lo tiene. Nunca llegan por OAuth: usa una API key. Cuentas gestionadas explica la operación que refleja cada tool.

provision_managed_account, change_managed_account_plan, reissue_managed_account_claim y end_account_management son irreversibles: el servidor las publica con destructiveHint: true y una entrada idempotency_key.

Tres cosas no tienen tool, por diseño:

• La importación masiva. Lee ficheros CSV subidos, que el servidor MCP no transporta, y también es privilegiada. Usa la REST API: Importación masiva.
• El lado del cliente de una cuenta gestionada. Lo que hace el cliente con su cuenta —reclamarla, subir o bajar el nivel que conserva el proveedor, terminar la gestión y asumir el pago— se hace en la app, y tampoco tiene operación /v1.
• La gestión del acceso cedido. Ceder, reenviar, aceptar, rechazar, revocar, cambiar el nivel o el alcance de un acceso entre cuentas, o renunciar a él, se hace en la app, nunca por la API ni por MCP. Acceso cedido lo explica.