Pagar.Me MCP Server

Stone's payments gateway (api.pagar.me), orders, charges (card, Pix, boleto), customers and cards, p. Exposed over MCP by the pagar.me mcp server, that capability becomes something an assistant can invoke while it works, not something you go and do afterwards.

What it actually does

Gateway de pagamentos da Stone (api.pagar.me), pedidos, cobranças (cartão, Pix, boleto), clientes e cartões, planos e assinaturas, recebedores (split/marketplace), transferências, recebíveis e faturas, via a API oficial V5. Funciona em todas as versões: chave sk_… usa a API V5 (leitura + escrita); contas legadas (chave ak_…) ganham leitura da API V1–V4 (transações, assinaturas, recebíveis, saldo). Autenticação por chave secreta gerada no painel → Configurações → Chaves.

Its toolset

Everything the assistant can do here goes through one of these:

• pagarme_list_accounts — Lista as contas Pagar.me (chaves) conectadas a este install — id, label e versão (V5 ou legado V1–V4)
• pagarme_orders_list — Pedidos (orders) no Pagar.me V5. Ações: - list: lista paginada (page, size, code, status, customer_id, created_since, created_until). - get: detalhe
• pagarme_orders_get — Pedidos (orders) no Pagar.me V5. Ações: - list: lista paginada (page, size, code, status, customer_id, created_since, created_until). - get: detalhe
• pagarme_orders_get_many — Pedidos (orders) no Pagar.me V5. Ações: - list: lista paginada (page, size, code, status, customer_id, created_since, created_until). - get: detalhe
• pagarme_orders_write_create — Criar/atualizar/fechar pedidos no Pagar.me V5 (só contas sk_). Ações: - create: cria pedido. data = JSON do pedido (customer/customer_id, items[]
• pagarme_orders_write_update — Criar/atualizar/fechar pedidos no Pagar.me V5 (só contas sk_). Ações: - create: cria pedido. data = JSON do pedido (customer/customer_id, items[]
• pagarme_orders_write_close — Criar/atualizar/fechar pedidos no Pagar.me V5 (só contas sk_). Ações: - create: cria pedido. data = JSON do pedido (customer/customer_id, items[]
• pagarme_charges_list — Cobranças (charges) no Pagar.me V5. Ações: - list: lista paginada (page, size; filtros via data: status, payment_method, customer_id, order_id
• pagarme_charges_summary — Cobranças (charges) no Pagar.me V5. Ações: - list: lista paginada (page, size; filtros via data: status, payment_method, customer_id, order_id
• pagarme_charges_get — Cobranças (charges) no Pagar.me V5. Ações: - list: lista paginada (page, size; filtros via data: status, payment_method, customer_id, order_id
• pagarme_charges_get_many — Cobranças (charges) no Pagar.me V5. Ações: - list: lista paginada (page, size; filtros via data: status, payment_method, customer_id, order_id
• pagarme_charges_write_capture — Operar cobranças no Pagar.me V5 (só contas sk_; não-destrutivas). Ações (requerem charge_id): - capture: captura (data opcional: amount). - retry

Adding it to your client

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client.

When to reach for it

Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Pagar.Me's toolset — pagarme_list_accounts, pagarme_orders_list, pagarme_orders_get and 11 more — is a fair guide to whether it matches your workflow. It is maintained by mcp-dir; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Pagar.Me's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Caveats

• It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
• With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Pagar.Me.
• MCP clients confirm each tool call by default. Leave that on until you have watched what the pagar.me mcp server does with a few real requests.