Tool catalog
All 232 Factuarea MCP tools grouped by domain, with the scope each one requires and its rate-limit category.
The Factuarea MCP server publishes 232 tools across 15 domains. This page is
the canonical list; each tool's input schema is discoverable at runtime via
tools/list. Every tool maps to the same operation in the
REST API Reference.
How to read this catalog
- Tool — the MCP tool name your agent calls.
- Scope — the fine-grained scope the credential must hold for the tool to
appear in
tools/listand to be invocable. See Scopes & permissions. - Category — the rate-limit bucket the tool falls into:
read,write,destructive,sendorgenerate. See Errors & rate limits.
A credential only sees the tools its scopes cover. An API key with the
super-scope * sees all 232; a narrower key or an OAuth token sees a subset.
¹ OAuth-restricted (API key only). 14 tools are reachable only with an
API key, never through a third-party OAuth app: the 8 verifactu:write tools,
forget_delivery_note_signature (delivery_notes:gdpr_forget) and the 5
FacturaE tools (the facturae:read / facturae:write scopes are not in the
OAuth consent catalog yet). OAuth apps therefore reach 218 of the 232
tools. See the channel policy.
Domains
Invoices
Sales invoices: search, CRUD, correctives, partial-payment ledger, transitions (paid/sent/void/annul), reminders, public links and PDFs. (34 tools)
| Tool | Scope | Category |
|---|---|---|
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
Customer CRM: search, CRUD, lookup by tax ID or external ID, AEAT census verification, stats and activity. (11 tools)
| Tool | Scope | Category |
|---|---|---|
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 |
Suppliers
Vendor CRM: search, CRUD, lookup by tax ID or external ID, activate/deactivate, stats and activity. (11 tools)
| Tool | Scope | Category |
|---|---|---|
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 |
Products
Catalog: search, CRUD, stock, SKU or external-ID lookup, sales analytics, low-stock reports and media (gallery/video). (20 tools)
| Tool | Scope | Category |
|---|---|---|
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 |
Quotes
Quotes: search, CRUD, accept/reject, send, convert to invoice, lookup by external ID, public links and PDFs. (17 tools)
| Tool | Scope | Category |
|---|---|---|
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 |
Pro-forma invoices
Pro-formas: search, CRUD, accept/reject, send, convert, lookup by external ID, public links and PDFs. (17 tools)
| Tool | Scope | Category |
|---|---|---|
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 |
Delivery notes
Delivery notes: search, CRUD, deliver/cancel/sign, convert, send, lookup by external ID, public links, PDFs and GDPR signature erasure. (19 tools)
| Tool | Scope | Category |
|---|---|---|
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 |
Purchase invoices
Vendor bills: search, CRUD, mark paid, partial-payment ledger, pending/overdue lists, lookup by external ID, file attachments and payment receipts. (17 tools)
| Tool | Scope | Category |
|---|---|---|
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 |
Recurring invoices
Recurring templates: search, CRUD, activate/pause/resume/cancel, preview, lookup by external ID, logs and activity. (15 tools)
| Tool | Scope | Category |
|---|---|---|
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
Numbering series (immutable for fiscal continuity): search, create, archive/unarchive, set default, stats and activity. (11 tools)
| Tool | Scope | Category |
|---|---|---|
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 |
Taxes
Tax rates (global catalog): search, CRUD-lite, defaults, in-use checks, and tax/total calculations. (15 tools)
| Tool | Scope | Category |
|---|---|---|
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
AEAT SIF: records, events, chain validation, subsanación of rejected records, certificates, settings, responsible declaration and AEAT access log. (27 tools)
| Tool | Scope | Category |
|---|---|---|
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)
B2G electronic invoicing: download the FacturaE 3.2.2 XML of an invoice and manage its FACe submissions (submit, track, cancel). (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 & events
Webhook endpoints, deliveries, secret rotation, ping/replay, and the published event catalog. (12 tools)
| Tool | Scope | Category |
|---|---|---|
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 |
Account
Account fiscal identity: verify the company's registered name + NIF pair against the AEAT census. (1 tool)
| Tool | Scope | Category |
|---|---|---|
verify_account_census | account:read | write |
Connecting a client
Connect Claude Code, Claude Desktop, the MCP Inspector or any MCP client to the Factuarea MCP server — with OAuth 2.1 or an API key, and in test mode.
Scopes & permissions
The OAuth consent scope catalog, how it maps to the fine-grained scopes tools enforce, the super-scope, and plan/module gating.