Tools

El servidor expone 95 tools sobre 20 familias de recurso. Cada una despacha in-process al endpoint de /v1 que ya implementa la operación, así que filtros, validación, reglas de liquidación y aislamiento por workspace son exactamente los de la API REST — la tool es el endpoint. Las excepciones, finance_schemas_get (el contrato publicado) y finance_workspaces_list (los espacios que alcanza la persona), responden localmente. Toda otra tool acepta workspace_id.

Cómo leer estas páginas

Cada tool aparece con cuatro datos:

finance_payables_send_to_bank · destructive · permiso payables.dispatch · POST /v1/payables/{id}/send-to-bank

Campo	Significado
read / write / destructive	La anotación que lee el cliente MCP. Una destructive solo se ejecuta después de que el servidor pide confirmación a la persona — un cliente que no puede preguntar recibe confirmation_required. Vea Confirmación de tools destructivas.
permiso	El permiso que la persona del token debe tener en la organización — el mismo que la acción exige en el panel.
MÉTODO /ruta	El endpoint de /v1 al que despacha la tool, para cruzar con la Referencia de la API. El token necesita el scope que ese endpoint exige.

Argumentos comunes

Aparecen en muchas tools y siempre significan lo mismo.

Argumento	Tipo	Descripción
limit	entero	Tamaño de página. Predeterminado 25, máximo 100 (10000 en las tools *_ids).
cursor	string	El meta.next_cursor de la página anterior. null ahí significa la última página.
filters	object	Los filtros que acepta el listado: un escalar es igualdad, un array es in, un objeto elige operadores ({ "gte": …, "lt": … }).
sort_by	enum	Columna de orden, entre las que acepta el listado.
sort_order	asc | desc	Dirección. Predeterminado asc.
fields	string[]	Columnas a devolver. Omitido, vuelve el registro entero; id siempre vuelve.
idempotency_key	string	Protección contra repeticiones, enviada como X-Idempotency-Key. Obligatoria en las acciones que mueven dinero.
custom_metadata	object	JSON libre tuyo, devuelto en cada lectura.

El catálogo

Familia	Tools	read	write	destructive
payables — Cuentas por pagar	9	4	2	3
receivables — Cuentas por cobrar	9	4	2	3
financial_transactions — Movimientos	7	4	2	1
transfers — Transferencias	2	1	0	1
reconciliations — Conciliaciones	3	1	0	2
receipts — Comprobantes	2	2	0	0
financial_accounts — Cuentas financieras y saldos	10	4	3	3
banks — Bancos	1	1	0	0
cash_flow — Flujo de caja	1	1	0	0
companies — Empresas	5	2	2	1
people — Personas	6	3	2	1
categories — Categorías	5	2	2	1
classification_centers — Centros de clasificación	5	2	2	1
custom_classifiers — Clasificadores personalizados	8	2	4	2
taxes — Impuestos	5	2	2	1
automatic_rules — Reglas automáticas	6	2	3	1
attachments — Adjuntos	7	3	2	2
fiscal_documents — Notas fiscales recibidas	2	2	0	0
schemas — Catálogo de campos	1	1	0	0
workspaces — Espacios	1	1	0	0

Una tool que no puedes ejecutar no aparece en tools/list. Si falta alguna de esta página, ve Autenticación.