Catálogo de tools
Las 232 tools del MCP de Factuarea agrupadas por dominio, con el scope que requiere cada una y su categoría de límite de peticiones.
El servidor MCP de Factuarea publica 232 tools en 15 dominios. 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.
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/listy sea invocable. Consulta Scopes y permisos. - Category — el bucket de límite de peticiones al que pertenece la tool:
read,write,destructive,sendogenerate. 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 232; una key más restringida o un token OAuth ve un subconjunto.
¹ Restringidas a OAuth (solo API key). 14 tools son accesibles únicamente con una
API key, nunca a través de una app OAuth de terceros: las 8 tools verifactu:write,
forget_delivery_note_signature (delivery_notes:gdpr_forget) y las 5 tools de
FacturaE (los scopes facturae:read / facturae:write aún no están en el catálogo
de consentimiento OAuth). Por tanto, las apps OAuth alcanzan 218 de las 232
tools. Consulta la política de canales.
Dominios
Facturas
Facturas de venta: búsqueda, CRUD, rectificativas, ledger de pagos parciales, transiciones (paid/sent/void/annul), recordatorios, enlaces públicos y PDFs. (34 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
can_annul_invoice | invoices:read | read |
check_invoice_simplified_eligibility | invoices:read | read |
find_invoice_by_external_id | invoices:read | read |
find_invoice_by_number | invoices:read | read |
get_available_quarters | invoices:read | read |
get_invoice | invoices:read | read |
get_invoice_activities | invoices:read | read |
get_invoice_correctives | invoices:read | read |
get_invoice_payment_receipt | pdfs:read | read |
get_invoice_pdf | pdfs:read | read |
get_invoice_public_link | invoices:read | read |
get_invoice_stats | invoices:read | read |
get_invoice_statuses | invoices:read | read |
list_invoice_payments | invoices:read | read |
list_payment_methods | invoices:read | read |
preview_invoice_reminder | invoices:read | read |
search_invoices | invoices:read | read |
annul_invoice | invoices:void | write |
assign_invoice_real_number | invoices:write | write |
bulk_delete_invoices | invoices:delete | destructive |
create_corrective_invoice | invoices:write | write |
create_invoice | invoices:write | write |
delete_invoice | invoices:delete | destructive |
duplicate_invoice | invoices:write | write |
mark_invoice_as_paid | invoices:write | write |
mark_invoice_as_sent | invoices:write | write |
register_invoice_payment | invoices:write | write |
quarterly_send_email | invoices:send | send |
send_invoice | invoices:send | send |
send_invoice_reminder | invoices:send | send |
substitute_simplified_invoice | invoices:write | write |
update_invoice | invoices:write | write |
update_invoice_public_link | invoices:write | write |
void_invoice | invoices:void | write |
Clientes
CRM de clientes: búsqueda, CRUD, consulta por tax ID o ID externo, verificación censal AEAT, estadísticas y actividad. (11 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
find_client_by_external_id | clients:read | read |
find_client_by_tax_id | clients:read | read |
get_client | clients:read | read |
get_client_activities | clients:read | read |
get_client_stats | clients:read | read |
search_clients | clients:read | read |
verify_client_census | clients:read | read |
bulk_delete_clients | clients:delete | destructive |
create_client | clients:write | write |
delete_client | clients:delete | destructive |
update_client | clients:write | write |
Proveedores
CRM de proveedores: búsqueda, CRUD, consulta por tax ID o ID externo, activar/desactivar, estadísticas y actividad. (11 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
find_supplier_by_external_id | suppliers:read | read |
find_supplier_by_tax_id | suppliers:read | read |
get_supplier | suppliers:read | read |
get_supplier_activities | suppliers:read | read |
get_supplier_stats | suppliers:read | read |
search_suppliers | suppliers:read | read |
bulk_delete_suppliers | suppliers:delete | destructive |
create_supplier | suppliers:write | write |
delete_supplier | suppliers:delete | destructive |
toggle_supplier_active | suppliers:write | write |
update_supplier | suppliers:write | write |
Productos
Catálogo: búsqueda, CRUD, stock, consulta por SKU o ID externo, analítica de ventas, informes de stock bajo y multimedia (galería/vídeo). (20 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
download_product_gallery_image | products:read | read |
download_product_video | products:read | read |
find_product_by_external_id | products:read | read |
find_product_by_sku | products:read | read |
get_product | products:read | read |
get_product_activities | products:read | read |
get_product_sales_analytics | products:read | read |
get_product_stats | products:read | read |
low_stock_report | products:read | read |
search_products | products:read | read |
bulk_delete_products | products:delete | destructive |
bulk_update_stock | products:write | write |
create_product | products:write | write |
delete_product | products:delete | destructive |
delete_product_gallery_image | products:delete | destructive |
delete_product_video | products:delete | destructive |
toggle_product_active | products:write | write |
update_product | products:write | write |
upload_product_gallery_image | products:write | write |
upload_product_video | products:write | write |
Presupuestos
Presupuestos: búsqueda, CRUD, aceptar/rechazar, enviar, convertir en factura, consulta por ID externo, enlaces públicos y PDFs. (17 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
find_quote_by_external_id | quotes:read | read |
get_quote | quotes:read | read |
get_quote_pdf | pdfs:read | read |
get_quote_public_link | quotes:read | read |
get_quote_stats | quotes:read | read |
get_quote_statuses | quotes:read | read |
search_quotes | quotes:read | read |
accept_quote | quotes:transition | write |
bulk_delete_quotes | quotes:delete | destructive |
convert_quote | quotes:transition | write |
create_quote | quotes:write | write |
delete_quote | quotes:delete | destructive |
duplicate_quote | quotes:write | write |
reject_quote | quotes:transition | write |
send_quote | quotes:send | send |
update_quote | quotes:write | write |
update_quote_public_link | quotes:write | write |
Facturas proforma
Facturas proforma: búsqueda, CRUD, aceptar/rechazar, enviar, convertir, consulta por ID externo, enlaces públicos y PDFs. (17 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
find_proforma_by_external_id | proformas:read | read |
get_proforma | proformas:read | read |
get_proforma_pdf | pdfs:read | read |
get_proforma_public_link | proformas:read | read |
get_proforma_stats | proformas:read | read |
get_proforma_statuses | proformas:read | read |
search_proformas | proformas:read | read |
accept_proforma | proformas:transition | write |
bulk_delete_proformas | proformas:delete | destructive |
convert_proforma | proformas:transition | write |
create_proforma | proformas:write | write |
delete_proforma | proformas:delete | destructive |
duplicate_proforma | proformas:write | write |
reject_proforma | proformas:transition | write |
send_proforma | proformas:send | send |
update_proforma | proformas:write | write |
update_proforma_public_link | proformas:write | write |
Albaranes
Albaranes: búsqueda, CRUD, entregar/cancelar/firmar, convertir, enviar, consulta por ID externo, enlaces públicos, PDFs y borrado RGPD de firmas. (19 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
find_delivery_note_by_external_id | delivery_notes:read | read |
get_delivery_note | delivery_notes:read | read |
get_delivery_note_pdf | pdfs:read | read |
get_delivery_note_public_link | delivery_notes:read | read |
get_delivery_note_stats | delivery_notes:read | read |
get_delivery_note_statuses | delivery_notes:read | read |
search_delivery_notes | delivery_notes:read | read |
bulk_delete_delivery_notes | delivery_notes:delete | destructive |
cancel_delivery_note | delivery_notes:transition | write |
convert_delivery_note | delivery_notes:transition | write |
create_delivery_note | delivery_notes:write | write |
delete_delivery_note | delivery_notes:delete | destructive |
duplicate_delivery_note | delivery_notes:write | write |
forget_delivery_note_signature | delivery_notes:gdpr_forget ¹ | destructive |
mark_delivery_note_delivered | delivery_notes:transition | write |
send_delivery_note | delivery_notes:write | send |
sign_delivery_note | delivery_notes:transition | write |
update_delivery_note | delivery_notes:write | write |
update_delivery_note_public_link | delivery_notes:write | write |
Facturas de compra
Facturas de compra: búsqueda, CRUD, marcar como pagadas, ledger de pagos parciales, listados de pendientes/vencidas, consulta por ID externo, archivos adjuntos y recibos de pago. (17 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
download_purchase_invoice_file | purchase_invoices:read | read |
find_purchase_invoice_by_external_id | purchase_invoices:read | read |
get_purchase_invoice | purchase_invoices:read | read |
get_purchase_invoice_payment_receipt | pdfs:read | read |
get_purchase_invoice_stats | purchase_invoices:read | read |
list_overdue_purchase_invoices | purchase_invoices:read | read |
list_pending_purchase_invoices | purchase_invoices:read | read |
list_purchase_invoice_payments | purchase_invoices:read | read |
search_purchase_invoices | purchase_invoices:read | read |
attach_purchase_invoice_file | purchase_invoices:write | write |
bulk_delete_purchase_invoices | purchase_invoices:delete | destructive |
create_purchase_invoice | purchase_invoices:write | write |
delete_purchase_invoice | purchase_invoices:delete | destructive |
delete_purchase_invoice_file | purchase_invoices:write | write |
mark_purchase_invoice_paid | purchase_invoices:transition | write |
register_purchase_invoice_payment | purchase_invoices:transition | write |
update_purchase_invoice | purchase_invoices:write | write |
Facturas recurrentes
Plantillas recurrentes: búsqueda, CRUD, activar/pausar/reanudar/cancelar, previsualizar, consulta por ID externo, logs y actividad. (15 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
find_recurring_invoice_by_external_id | recurring_invoices:read | read |
get_recurring_invoice | recurring_invoices:read | read |
get_recurring_invoice_stats | recurring_invoices:read | read |
list_recurring_invoice_activities | recurring_invoices:read | read |
list_recurring_invoice_logs | recurring_invoices:read | read |
preview_recurring_invoice | recurring_invoices:read | read |
search_recurring_invoices | recurring_invoices:read | read |
activate_recurring_invoice | recurring_invoices:transition | write |
bulk_delete_recurring_invoices | recurring_invoices:delete | destructive |
cancel_recurring_invoice | recurring_invoices:transition | write |
create_recurring_invoice | recurring_invoices:write | write |
delete_recurring_invoice | recurring_invoices:delete | destructive |
pause_recurring_invoice | recurring_invoices:transition | write |
resume_recurring_invoice | recurring_invoices:transition | write |
update_recurring_invoice | recurring_invoices:write | write |
Series
Series de numeración (inmutables por continuidad fiscal): búsqueda, crear, archivar/desarchivar, fijar por defecto, estadísticas y actividad. (11 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
find_series_by_code | series:read | read |
get_default_series_for_type | series:read | read |
get_series | series:read | read |
get_series_activities | series:read | read |
get_series_stats | series:read | read |
list_active_series | series:read | read |
search_series | series:read | read |
archive_series | series:write | write |
create_series | series:write | write |
mark_series_as_default | series:write | write |
unarchive_series | series:write | write |
Impuestos
Tipos impositivos (catálogo global): búsqueda, CRUD ligero, valores por defecto, comprobaciones de uso y cálculos de impuestos/totales. (15 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
calculate_tax | taxes:read | read |
calculate_totals | taxes:read | read |
check_tax_in_use | taxes:read | read |
get_active_taxes | taxes:read | read |
get_tax | taxes:read | read |
get_tax_defaults_for_document | taxes:read | read |
get_tax_stats | taxes:read | read |
get_taxes_by_type | taxes:read | read |
get_taxes_for_purchases | taxes:read | read |
get_taxes_for_sales | taxes:read | read |
search_taxes | taxes:read | read |
create_tax | taxes:write | write |
set_tax_as_default | taxes:write | write |
set_tax_default_for_document | taxes:write | write |
toggle_tax_active | taxes:write | write |
VeriFactu
SIF de la AEAT: registros, eventos, validación de cadena, subsanación de registros rechazados, certificados, ajustes, declaración responsable y log de acceso de la AEAT. (27 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
find_verifactu_record_by_csv | verifactu:read | read |
find_verifactu_record_by_huella | verifactu:read | read |
find_verifactu_record_by_invoice_number | verifactu:read | read |
get_active_company_certificate | verifactu:read | read |
get_aeat_access_record | verifactu:read | read |
get_declaracion_responsable | verifactu:read | read |
get_declaracion_responsable_history | verifactu:read | read |
get_invoice_verifactu | verifactu:read | read |
get_verifactu_activities | verifactu:read | read |
get_verifactu_config | verifactu:read | read |
get_verifactu_event | verifactu:read | read |
get_verifactu_event_summary | verifactu:read | read |
get_verifactu_record | verifactu:read | read |
get_verifactu_stats | verifactu:read | read |
list_aeat_access_records | verifactu:read | read |
list_company_certificates | verifactu:read | read |
list_verifactu_events | verifactu:read | read |
search_verifactu_records | verifactu:read | read |
validate_verifactu_chain | verifactu:read | read |
activate_company_certificate | verifactu:write ¹ | write |
create_invoice_verifactu | verifactu:write ¹ | write |
retry_verifactu_event | verifactu:write ¹ | write |
retry_verifactu_record | verifactu:write ¹ | write |
revoke_company_certificate | verifactu:write ¹ | write |
subsanar_verifactu_record | verifactu:write ¹ | write |
update_verifactu_settings | verifactu:write ¹ | write |
upload_company_certificate | verifactu:write ¹ | write |
FacturaE (FACe)
Facturación electrónica B2G: descarga el XML FacturaE 3.2.2 de una factura y gestiona sus envíos a FACe (enviar, seguir, anular). (5 tools)
| Tool | Scope | Category |
|---|---|---|
get_face_submission | facturae:read ¹ | read |
list_invoice_face_submissions | facturae:read ¹ | read |
get_invoice_facturae_link | facturae:read ¹ | generate |
cancel_face_submission | facturae:write ¹ | write |
send_invoice_to_face | facturae:write ¹ | write |
Webhooks y eventos
Webhook endpoints, entregas, rotación de secretos, ping/replay y el catálogo de eventos publicado. (12 tools)
| Herramienta | Scope | Categoría |
|---|---|---|
get_event | events:read | read |
get_webhook_delivery | webhooks:read | read |
get_webhook_endpoint | webhooks:read | read |
list_events | events:read | read |
list_webhook_deliveries | webhooks:read | read |
search_webhook_endpoints | webhooks:read | read |
create_webhook_endpoint | webhooks:write | write |
delete_webhook_endpoint | webhooks:delete | write |
ping_webhook_endpoint | webhooks:write | write |
replay_webhook_delivery | webhooks:write | write |
rotate_webhook_secret | webhooks:write | write |
update_webhook_endpoint | webhooks:write | write |
Cuenta
Identidad fiscal de la cuenta: verifica el par razón social + NIF de la empresa contra el censo de la AEAT. (1 tool)
| Tool | Scope | Category |
|---|---|---|
verify_account_census | account:read | write |
Conectar un cliente
Conecta Claude Code, Claude Desktop, el MCP Inspector o cualquier cliente MCP al servidor MCP de Factuarea — con OAuth 2.1 o una API key, y en modo de prueba.
Scopes y permisos
El catálogo de scopes del consentimiento OAuth, cómo se mapea a los scopes detallados que aplican las tools, el super-scope y el gating por plan/módulo.