Tools

The server exposes 14 tools grouped by functional area.

Organization

`get_user_organization_info`

Returns the active organization context (tax ID, fiscal regime, and defaults) so the agent can operate with the correct fiscal context when company or tax defaults are needed.

`get_mcp_workflows_guidance`

Returns summarized MCP workflow guidance (workflow name, description, and kickoff steps) to help the agent plan or execute multistep flows.

Contacts

`list_contacts`

Search contacts in the organization with optional filters.

Parameter	Type	Required	Description
`query`	string	No	Name search (case-insensitive).
`document_number`	string	No	Filter by document number (NIF/CIF).
`email`	string	No	Filter by email.
`page`	integer	No	Page number.

`resolve_contact`

Deterministically resolve a single contact. Returns status (unique / ambiguous / none) and up to 5 candidates. Use this before any write operation that requires a contact_id.

Parameter	Type	Required	Description
`query`	string	No	Free-text name search (case-insensitive).
`document_number`	string	No	Exact match on NIF/CIF.
`email`	string	No	Exact match on email.
`id`	integer	No	Exact contact id. Short-circuits all other filters.

At least one of the four fields is required.

`create_contact`

Create a new contact in the organization. Idempotent on document_number: if a contact with that NIF/CIF already exists, returns the existing one instead of creating a duplicate.

`update_contact`

Update the fields of an existing contact. Only the fields passed are modified (PATCH semantics).

Parameter	Type	Required	Description
`id`	integer	Yes	Id of the contact to update.

Products

`resolve_product`

Deterministically resolve a single product. Returns status (unique / ambiguous / none) and candidates. Use this before creating an invoice draft.

Parameter	Type	Required	Description
`query`	string	No	Free-text concept search.
`id`	integer	No	Exact product id.

At least one of the two fields is required.

`create_product`

Add a new product to the organization’s catalogue.

`update_product`

Update the fields of an existing product. Only the fields passed are modified (PATCH semantics).

Parameter	Type	Required	Description
`id`	integer	Yes	Id of the product to update.

Invoices

`resolve_invoice`

Locate an existing issued invoice.

Parameter	Type	Required	Description
`id`	integer	No	Exact invoice id.
`full_number`	string	No	Full invoice number (e.g. `A-2025-0042`).
`latest_for_contact_id`	integer	No	Returns the most recent invoice for the given contact.

`create_invoice_draft`

Create an ordinary (F1) invoice draft. The draft is not issued; use issue_invoice_draft to make it fiscally binding. Returns the draft_id, a confirmation_token, and a preview to show the user before issuing.

Parameter	Type	Required	Description
`contact_id`	integer	Yes	Contact id. Use `resolve_contact` to obtain it.
`lines`	array	Yes	At least one line. Each line must have `product_id` or (`concept` + `unit_price`).
`lines[].product_id`	integer	No	Product id. Pre-fills concept, price, and tax rate.
`lines[].concept`	string	No*	Required if no `product_id`. Overrides the product value when present.
`lines[].unit_price`	number	No*	Required if no `product_id`. Overrides the product value when present.
`lines[].quantity`	number	No	Defaults to `1`.
`lines[].tax_rate`	number	No	Overrides the product’s or organization’s default tax rate.
`lines[].discount_percent`	number	No	Discount percentage.
`operation_date`	string	No	ISO-8601 date.
`operation_description`	string	No	Description of the operation.
`payment_method`	string	No	Payment method.
`payment_method_info`	string	No	Additional payment method information.

`create_simplified_invoice_draft`

Create a simplified (F2) invoice draft, without an associated contact. Useful for tickets or general public sales. Returns draft_id, confirmation_token, and a preview.

`issue_invoice_draft`

Destructive and irreversible operation. Once issued, the invoice is hash-chained and cannot be modified or deleted.

Keep in mind that invoices will not be sent to Verifactu until you submit the request from the platform.

Issue a draft (F1 or F2), making it fiscally binding. The invoice is automatically submitted to VeriFactu.

Parameter	Type	Required	Description
`draft_id`	integer	Yes	Id of the draft to issue.
`confirmation_token`	string	No	Token returned by the draft creation step. Must match if one was generated.
`send_email`	boolean	No	If `true`, sends the issued invoice by email to the contact. Defaults to `false`.

`send_invoice_email`

Send or resend an issued invoice by email to its associated contact.

Parameter	Type	Required	Description
`issued_invoice_id`	integer	Yes	Id of the issued invoice.

Prompt

`create_invoice`

Full guided flow for issuing an invoice. The agent resolves the contact and products, creates the draft, presents the preview, and requests explicit confirmation before issuing.

👋 Introduction

🔌 API REST

🤖 MCP

Tools

Tools

Organization

`get_user_organization_info`

`get_mcp_workflows_guidance`

Contacts

`list_contacts`

`resolve_contact`

`create_contact`

`update_contact`

Products

`resolve_product`

`create_product`

`update_product`

Invoices

`resolve_invoice`

`create_invoice_draft`

`create_simplified_invoice_draft`

`issue_invoice_draft`

`send_invoice_email`

Prompt

`create_invoice`

​Tools

​Organization

​get_user_organization_info

​get_mcp_workflows_guidance

​Contacts

​list_contacts

​resolve_contact

​create_contact

​update_contact

​Products

​resolve_product

​create_product

​update_product

​Invoices

​resolve_invoice

​create_invoice_draft

​create_simplified_invoice_draft

​issue_invoice_draft

​send_invoice_email

​Prompt

​create_invoice

Tools

Organization

`get_user_organization_info`

`get_mcp_workflows_guidance`

Contacts

`list_contacts`

`resolve_contact`

`create_contact`

`update_contact`

Products

`resolve_product`

`create_product`

`update_product`

Invoices

`resolve_invoice`

`create_invoice_draft`

`create_simplified_invoice_draft`

`issue_invoice_draft`

`send_invoice_email`

Prompt

`create_invoice`