Tools

The server exposes 292 tools over 25 resource families. Each one dispatches in-process to the /v1 endpoint that already implements the operation, so filters, validation, upsert matching and tenant isolation are exactly the REST API's — the tool is the endpoint. The one exception, billing_schemas_get, answers locally and is marked as such.

How to read these pages

Every tool carries four facts, in this order:

billing_invoices_void · destructive · resource invoices · permission invoices.void · POST /v1/invoices/:id/void

Field	Meaning
read / write / destructive	The annotation the MCP client reads. On a destructive one it asks the user to confirm.
resource	The resource family of the tool — what groups the tools in these docs.
permission	The dashboard permission the person who authorized the client must hold in the organization.
METHOD /path	The /v1 endpoint the tool dispatches to, to cross-reference with the API reference.

Common arguments

These appear across many tools and always mean the same thing.

Argument	Type	Description
page	integer	1-based page number. Default 1.
per_page	integer	Page size. Default 20, max 100.
sort_by	string	Sort column, snake_case. billing_schemas_get lists the accepted ones.
sort_order	asc | desc	Direction. A value that is not a direction is an error, not a silent desc.
fields	string[]	Columns to return. Omit for the whole resource; id always comes back.
filters	object	Additional filters, forwarded verbatim to the endpoint.
idempotency_key	string	Replay guard, sent as X-Idempotency-Key.
custom_metadata	object	Free-form JSON owned by you, echoed on every read and webhook.

The catalogue

Family	Tools	read	write	destructive
certificates — Digital certificates	3	2	0	1
companies — Issuing companies	12	4	6	2
coupons — Coupons and discount codes	8	3	4	1
credits — Credits	7	3	3	1
customers — Customers and billing accounts	19	6	9	4
invoices — Invoices	23	8	11	4
nfes — Tax invoices (NF-e)	24	8	13	3
payments — Payments and payment methods	19	4	11	4
plan-changes — Plan changes	11	6	4	1
plans — Plans, prices and groups	20	5	12	3
portal-users — Portal users	9	4	4	1
products — Products and product groups	24	4	17	3
proposals — Proposals	25	7	11	7
roles — Team roles	6	2	3	1
services — Service items	6	2	3	1
settings — Organization and schemas	3	2	1	0
subscription-changes — Subscription changes	5	3	1	1
subscriptions — Subscriptions	16	4	8	4
tax-periods — Tax periods	5	2	2	1
tax-rules — Tax rules	6	2	3	1
templates — Proposal templates	9	2	6	1
transfer-destinations — Bank accounts and Pix keys	11	5	4	2
usage — Metered usage	7	4	3	0
users — Dashboard users	6	2	3	1
withholdings — Withholdings	8	2	5	1

A tool you cannot run is not listed by tools/list at all. If one from this page is missing, see Authentication.