Catàleg de tools
Les 232 tools del MCP de Factuarea agrupades per domini, amb el scope que requereix cadascuna i la seva categoria de límit de peticions.
El servidor MCP de Factuarea publica 232 tools en 15 dominis. Aquesta pàgina és
la llista canònica; l'esquema d'entrada de cada tool es descobreix en temps
d'execució mitjançant tools/list. Cada tool es correspon amb la mateixa operació a la
Referència de la REST API.
Com llegir aquest catàleg
- Tool — el nom de la tool MCP que invoca el teu agent.
- Scope — el scope granular que ha de tenir la credencial perquè la tool
aparegui a
tools/listi sigui invocable. Consulta Scopes i permisos. - Category — el bucket de límit de peticions al qual pertany la tool:
read,write,destructive,sendogenerate. Consulta Errors i límits de peticions.
Una credencial només veu les tools que cobreixen els seus scopes. Una API key amb el
super-scope * les veu totes 232; una key més restringida o un token OAuth en veu un subconjunt.
¹ Restringides a OAuth (només API key). 14 tools són accessibles únicament amb una
API key, mai a través d'una app OAuth de tercers: les 8 tools verifactu:write,
forget_delivery_note_signature (delivery_notes:gdpr_forget) i les 5 tools de
FacturaE (els scopes facturae:read / facturae:write encara no són al catàleg
de consentiment OAuth). Per tant, les apps OAuth arriben a 218 de les 232
tools. Consulta la política de canals.
Dominis
Factures
Factures de venda: cerca, CRUD, rectificatives, ledger de pagaments parcials, transicions (paid/sent/void/annul), recordatoris, enllaços públics i PDFs. (34 tools)
| Eina | Scope | Categoria |
|---|---|---|
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 |
Clients
CRM de clients: cerca, CRUD, consulta per tax ID o ID extern, verificació censal AEAT, estadístiques i activitat. (11 tools)
| Eina | Scope | Categoria |
|---|---|---|
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 |
Proveïdors
CRM de proveïdors: cerca, CRUD, consulta per tax ID o ID extern, activar/desactivar, estadístiques i activitat. (11 tools)
| Eina | Scope | Categoria |
|---|---|---|
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 |
Productes
Catàleg: cerca, CRUD, stock, consulta per SKU o ID extern, analítica de vendes, informes d'estoc baix i multimèdia (galeria/vídeo). (20 tools)
| Eina | Scope | Categoria |
|---|---|---|
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 |
Pressupostos
Pressupostos: cerca, CRUD, acceptar/rebutjar, enviar, convertir en factura, consulta per ID extern, enllaços públics i PDFs. (17 tools)
| Eina | Scope | Categoria |
|---|---|---|
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 |
Factures proforma
Factures proforma: cerca, CRUD, acceptar/rebutjar, enviar, convertir, consulta per ID extern, enllaços públics i PDFs. (17 tools)
| Eina | Scope | Categoria |
|---|---|---|
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 |
Albarans
Albarans: cerca, CRUD, lliurar/cancel·lar/signar, convertir, enviar, consulta per ID extern, enllaços públics, PDFs i esborrat RGPD de signatures. (19 tools)
| Eina | Scope | Categoria |
|---|---|---|
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 |
Factures de compra
Factures de compra: cerca, CRUD, marcar com a pagades, ledger de pagaments parcials, llistats de pendents/vençudes, consulta per ID extern, fitxers adjunts i rebuts de pagament. (17 tools)
| Eina | Scope | Categoria |
|---|---|---|
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 |
Factures recurrents
Plantilles recurrents: cerca, CRUD, activar/pausar/reprendre/cancel·lar, previsualitzar, consulta per ID extern, logs i activitat. (15 tools)
| Eina | Scope | Categoria |
|---|---|---|
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 |
Sèries
Sèries de numeració (immutables per continuïtat fiscal): cerca, crear, arxivar/desarxivar, fixar per defecte, estadístiques i activitat. (11 tools)
| Eina | Scope | Categoria |
|---|---|---|
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 |
Impostos
Tipus impositius (catàleg global): cerca, CRUD lleuger, valors per defecte, comprovacions d'ús i càlculs d'impostos/totals. (15 tools)
| Eina | Scope | Categoria |
|---|---|---|
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 l'AEAT: registres, esdeveniments, validació de cadena, esmena (subsanación) de registres rebutjats, certificats, ajustos, declaració responsable i log d'accés de l'AEAT. (27 tools)
| Eina | Scope | Categoria |
|---|---|---|
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ó electrònica B2G: descarrega l'XML FacturaE 3.2.2 d'una factura i gestiona els seus enviaments a FACe (enviar, seguir, anul·lar). (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 i esdeveniments
Webhook endpoints, lliuraments, rotació de secrets, ping/replay i el catàleg d'esdeveniments publicat. (12 tools)
| Eina | Scope | Categoria |
|---|---|---|
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 |
Compte
Identitat fiscal del compte: verifica el parell raó social + NIF de l'empresa contra el cens de l'AEAT. (1 tool)
| Tool | Scope | Category |
|---|---|---|
verify_account_census | account:read | write |
Connectar un client
Connecta Claude Code, Claude Desktop, el MCP Inspector o qualsevol client MCP al servidor MCP de Factuarea — amb OAuth 2.1 o una API key, i en mode de prova.
Scopes i permisos
El catàleg de scopes del consentiment OAuth, com es mapeja als scopes detallats que apliquen les tools, el super-scope i el gating per pla/mòdul.