Tools
El servidor expone 118 tools sobre 22 familias de recurso — una para cada operación de la API REST. Cada tool despacha in-process al endpoint de /v1 que ya implementa la operación, así que filtros, validación, reglas de negocio y aislamiento por organización son exactamente los de la API — la tool es el endpoint.
Cómo leer estas páginas
Cada tool aparece con cuatro datos:
dunning_charges_notify· destructive ·charges.notify·POST /v1/charges/{id}/notify
| Campo | Significado |
|---|---|
| read / write / destructive | La anotación que lee el cliente MCP. Una destructive (elimina, archiva, cancela, llega al deudor o a un tercero — mensaje, buró, notaría, webhook —, decide sobre la deuda o rota un secreto) solo se ejecuta después de que el usuario confirma en el formulario que envía el servidor, en la revisión 2026-07-28; un cliente que no puede confirmar recibe confirmation_required. |
| permiso | El permiso de panel que la persona dueña del token debe tener en la organización. |
MÉTODO /ruta | El endpoint de /v1 al que despacha la tool, para cruzar con la Referencia de la API. |
| Qué hace | La primera frase de la description de la tool, en inglés, tal como la recibe el modelo. |
Argumentos comunes
Aparecen en muchas tools y siempre significan lo mismo.
| Argumento | Tipo | Descripción |
|---|---|---|
page | entero | Página, desde 1. |
per_page | entero | Ítems por página, como máximo 100. |
sort_by | string | Campo de orden, en snake_case (ej.: due_date). Un valor fuera de la lista del endpoint vuelve al predeterminado. |
sort_order | asc | desc | Dirección del orden. |
include | string | Relaciones a incluir en la respuesta, separadas por coma (ej.: person). |
idempotency_key | string | Protección contra reintentos en toda escritura, enviada como X-Idempotency-Key. |
El catálogo
Una tool que no puedes ejecutar no aparece en tools/list. Si falta alguna de esta página, ve Autenticación.