Skip to main content
Trio MCP exposes 17 tools. All of them read data or validate a Pix key; none of them moves money or changes anything in your account. Your AI client picks the tool from your question and the tool’s own description, which tells it when to use that tool and which one to prefer for a similar question. All examples use the sandbox base URL https://api.sandbox.trio.com.br behind the scenes: each tool mirrors an API endpoint, so the arguments and the responses are the ones documented in the API reference.

How the tools behave

  • Start with the entity. list_entities is the first call of a session: it returns the organization’s entities (CNPJs) and the entity_id most other tools need. With one entity the agent uses it automatically; with several it asks which one you mean.
  • Amounts are in cents. 5000000 is R$ 50.000,00. The agent divides by 100 when it shows you a value.
  • Dates and times are ISO 8601. Period filters take from_datetime and to_datetime, for example 2026-10-01T00:00:00-03:00.
  • Listings are paginated. Responses carry metadata.before and metadata.after cursors, and the agent walks every page of a period before it answers.
  • Sensitive data is masked. Card numbers arrive as 5555 •••• •••• 4021 and a CPF as ***982247**. A CNPJ is returned in full.
  • Tools point at each other. Ask about cash flow and the agent uses the statement, not the document listings. Give it an external_id or a Pix end-to-end ID and it searches instead of listing. Give it a CPF or CNPJ and it uses the tax-number listing.

Entities, accounts and statements

Payments (cash-out)

Receivables (cash-in)

Pix keys

Corporate cards

Statuses the tools return

settled and failed are final for payments and transfers. The Document lifecycle guide explains each stage.

What the tools do not do

There is no tool to pay, transfer, refund, issue a card or change a setting. If you ask for one of those, the agent can prepare the numbers, but the action happens in the Trio App, through your organization’s approval rules. Want a tool that is not here? Tell support what your team needs.

Next steps