Tools

El servidor expone 292 tools sobre 25 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 upsert y aislamiento por organización son exactamente los de la API REST — la tool es el endpoint. La única excepción, billing_schemas_get, responde localmente y está marcada como tal.

Cómo leer estas páginas

Cada tool aparece con cuatro datos, en este orden:

billing_invoices_void · destructive · recurso invoices · permiso invoices.void · POST /v1/invoices/:id/void

Campo	Significado
read / write / destructive	La anotación que lee el cliente MCP. En una destructive pide confirmación al usuario.
recurso	La familia de recurso de la tool — lo que agrupa las tools en esta documentación.
permiso	El permiso de panel que la persona que autorizó el cliente 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.

Argumentos comunes

Aparecen en muchas tools y siempre significan lo mismo.

Argumento	Tipo	Descripción
page	entero	Página, desde 1. Predeterminado 1.
per_page	entero	Ítems por página. Predeterminado 20, máximo 100.
sort_by	string	Columna de orden, en snake_case. Los aceptados están en billing_schemas_get.
sort_order	asc | desc	Dirección. Un valor que no es dirección es un error, no un desc silencioso.
fields	string[]	Columnas a devolver. Omitido, vuelve el recurso entero; id siempre vuelve.
filters	object	Filtros adicionales, reenviados verbatim al endpoint.
idempotency_key	string	Protección contra reintentos, enviada como X-Idempotency-Key.
custom_metadata	object	JSON libre tuyo, devuelto en cada lectura y en cada webhook.

El catálogo

Familia	Tools	read	write	destructive
certificates — Certificados digitales	3	2	0	1
companies — Empresas emisoras	12	4	6	2
coupons — Cupones y códigos de descuento	8	3	4	1
credits — Créditos	7	3	3	1
customers — Clientes y cuentas de cobro	19	6	9	4
invoices — Facturas	23	8	11	4
nfes — Notas fiscales (NF-e)	24	8	13	3
payments — Pagos y métodos de pago	19	4	11	4
plan-changes — Cambios de plan	11	6	4	1
plans — Planes, precios y grupos	20	5	12	3
portal-users — Usuarios del portal	9	4	4	1
products — Productos y grupos de productos	24	4	17	3
proposals — Propuestas	25	7	11	7
roles — Roles del equipo	6	2	3	1
services — Ítems de servicio	6	2	3	1
settings — Organización y esquemas	3	2	1	0
subscription-changes — Cambios de suscripción	5	3	1	1
subscriptions — Suscripciones	16	4	8	4
tax-periods — Períodos de cálculo	5	2	2	1
tax-rules — Reglas fiscales	6	2	3	1
templates — Plantillas de propuesta	9	2	6	1
transfer-destinations — Cuentas bancarias y claves Pix	11	5	4	2
usage — Consumo medido	7	4	3	0
users — Usuarios del panel	6	2	3	1
withholdings — Retenciones	8	2	5	1

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