Mcp Quipu

List contacts (clients and suppliers) from Quipu. Returns id, name, tax_id (NIF/CIF), email, phone and address fields. Results are paginated: use `page` to walk through pages. Quipu returns JSON:API, but this tool flattens each resource so attributes appear at the top level alongside `id`.

Get a single Quipu contact by its id, with all available attributes (name, tax_id, email, phone, address, town, zip_code, country_code).

Create a contact in Quipu. `name` is required. Provide `tax_id` (NIF/CIF) whenever the contact will be invoiced — Spanish invoices require it and Quipu will reject the invoice later without it.

Update an existing Quipu contact. Only the fields you pass are modified; everything else is left untouched.

Delete a Quipu contact permanently. Quipu refuses to delete contacts that already have invoices attached; in that case the API returns an error explaining it.

List issued invoices from Quipu, with number, issue_date, due_date, total, subtotal and payment status. Paginated via `page`. Use `filter_from` and `filter_to` to bound the period — this is the tool to use when asked about revenue or VAT for a quarter, since Quipu has no endpoint that returns tax models directly and the figures must be derived from invoices.

Get a single Quipu invoice by id, with all of its attributes and totals.

Create an issued invoice in Quipu. Requires the contact id it is billed to and at least one line item. The contact must already have a tax_id (NIF/CIF) or Quipu will reject the invoice.

Update an existing Quipu invoice. Note that Spanish invoicing rules restrict what can change once an invoice is issued and numbered; Quipu returns an error when a field is locked.

Delete a Quipu invoice permanently. Spanish invoicing rules generally require issuing a credit note instead of deleting a numbered invoice — prefer that unless the invoice is still a draft.

Get a temporary public URL to download a Quipu invoice as PDF. The link is ephemeral and expires, so fetch it when the user actually needs the document rather than storing it.

List additional incomes and expenses recorded in Quipu — everything that is not an issued invoice: supplier bills, purchases, tickets and other deductible costs. Returns kind, total_amount_without_taxes, vat_amount and retention_amount. Bound the period with `filter_from` / `filter_to`. This is the input-VAT side needed to work out what a quarter actually owes.

Get a single additional income or expense entry from Quipu by its id.

Record an expense or additional income in Quipu. Use it to log supplier bills and deductible costs. Assign an `accounting_category_id` whenever you know it — an uncategorised expense still counts for VAT but is useless for the profit and loss breakdown.

Update an existing additional income or expense in Quipu. Only the fields passed are modified.

Delete an additional income or expense entry from Quipu permanently.

Get a temporary public URL to download an expense document as PDF. The link is ephemeral and expires.

Work out the VAT and IRPF position for a period from the invoices and expenses recorded in Quipu. Give it a year and a quarter (or an explicit date range) and it returns output VAT charged on invoices, input VAT paid on expenses, the resulting balance, and withholdings. Use this instead of listing invoices and adding them up by hand: Quipu has no endpoint that returns tax models (130, 303, 111), so the figures must be derived, and doing the arithmetic in code avoids the mistakes that come from adding long lists token by token. Treat the result as an estimate for orientation, not as a filed return.