# Pagar.me — how to use (mcp.ai)

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.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_pagarme?ms=1781685780000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `pagarme_cards_delete`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/pagarme`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/pagarme/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/pagarme/cards/delete` — Remove um cartão salvo do cliente no Pagar.me V5 (requer customer_id + card_id). Irreversível.
  - body: { customer_id: string, card_id: string, account?: string, customer_ids?: string[], card_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/cards/get` — Cartões salvos de um cliente no Pagar.me V5.
  - body: { customer_id: string, card_id?: string, account?: string, customer_ids?: string[], card_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/cards/list` — Cartões salvos de um cliente no Pagar.me V5.
  - body: { customer_id: string, card_id?: string, account?: string, customer_ids?: string[], card_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/cards/write/create` — Criar/renovar cartões de um cliente no Pagar.me V5 (só sk_; requer customer_id).
  - body: { customer_id: string, card_id?: string, data?: string, account?: string, customer_ids?: string[], card_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/cards/write/renew` — Criar/renovar cartões de um cliente no Pagar.me V5 (só sk_; requer customer_id).
  - body: { customer_id: string, card_id?: string, data?: string, account?: string, customer_ids?: string[], card_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/charges/cancel` — Cancela/estorna uma cobrança no Pagar.me V5 (requer charge_id; data opcional com amount p/ estorno parcial). Irreversível.
  - body: { charge_id: string, data?: string, account?: string, charge_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/charges/get` — Cobranças (charges) no Pagar.me V5.
  - body: { charge_id?: string, charge_ids?: string[], page?: number, size?: number, data?: string, account?: string }
- `POST https://api.mcp.ai/api/pagarme/charges/get/many` — Cobranças (charges) no Pagar.me V5.
  - body: { charge_id?: string, charge_ids?: string[], page?: number, size?: number, data?: string, account?: string }
- `POST https://api.mcp.ai/api/pagarme/charges/list` — Cobranças (charges) no Pagar.me V5.
  - body: { charge_id?: string, charge_ids?: string[], page?: number, size?: number, data?: string, account?: string }
- `POST https://api.mcp.ai/api/pagarme/charges/summary` — Cobranças (charges) no Pagar.me V5.
  - body: { charge_id?: string, charge_ids?: string[], page?: number, size?: number, data?: string, account?: string }
- `POST https://api.mcp.ai/api/pagarme/charges/write/capture` — Operar cobranças no Pagar.me V5 (só contas sk_; não-destrutivas).
  - body: { charge_id: string, data?: string, account?: string, charge_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/charges/write/confirm` — Operar cobranças no Pagar.me V5 (só contas sk_; não-destrutivas).
  - body: { charge_id: string, data?: string, account?: string, charge_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/charges/write/retry` — Operar cobranças no Pagar.me V5 (só contas sk_; não-destrutivas).
  - body: { charge_id: string, data?: string, account?: string, charge_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/charges/write/update/card` — Operar cobranças no Pagar.me V5 (só contas sk_; não-destrutivas).
  - body: { charge_id: string, data?: string, account?: string, charge_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/charges/write/update/due/date` — Operar cobranças no Pagar.me V5 (só contas sk_; não-destrutivas).
  - body: { charge_id: string, data?: string, account?: string, charge_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/charges/write/update/payment/method` — Operar cobranças no Pagar.me V5 (só contas sk_; não-destrutivas).
  - body: { charge_id: string, data?: string, account?: string, charge_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/customers/get` — Clientes e endereços no Pagar.me V5.
  - body: { customer_id?: string, address_id?: string, page?: number, size?: number, data?: string, account?: string, customer_ids?: string[], address_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/customers/get/address` — Clientes e endereços no Pagar.me V5.
  - body: { customer_id?: string, address_id?: string, page?: number, size?: number, data?: string, account?: string, customer_ids?: string[], address_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/customers/list` — Clientes e endereços no Pagar.me V5.
  - body: { customer_id?: string, address_id?: string, page?: number, size?: number, data?: string, account?: string, customer_ids?: string[], address_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/customers/list/addresses` — Clientes e endereços no Pagar.me V5.
  - body: { customer_id?: string, address_id?: string, page?: number, size?: number, data?: string, account?: string, customer_ids?: string[], address_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/customers/write/create` — Criar/atualizar clientes e endereços no Pagar.me V5 (só sk_).
  - body: { customer_id?: string, address_id?: string, data?: string, account?: string, customer_ids?: string[], address_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/customers/write/create/address` — Criar/atualizar clientes e endereços no Pagar.me V5 (só sk_).
  - body: { customer_id?: string, address_id?: string, data?: string, account?: string, customer_ids?: string[], address_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/customers/write/delete/address` — Criar/atualizar clientes e endereços no Pagar.me V5 (só sk_).
  - body: { customer_id?: string, address_id?: string, data?: string, account?: string, customer_ids?: string[], address_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/customers/write/update` — Criar/atualizar clientes e endereços no Pagar.me V5 (só sk_).
  - body: { customer_id?: string, address_id?: string, data?: string, account?: string, customer_ids?: string[], address_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/customers/write/update/address` — Criar/atualizar clientes e endereços no Pagar.me V5 (só sk_).
  - body: { customer_id?: string, address_id?: string, data?: string, account?: string, customer_ids?: string[], address_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/invoices/cancel` — Cancela uma fatura no Pagar.me V5 (requer invoice_id). Irreversível.
  - body: { invoice_id: string, account?: string, invoice_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/invoices/get` — Faturas (invoices) de assinatura no Pagar.me V5.
  - body: { invoice_id?: string, page?: number, size?: number, data?: string, account?: string, invoice_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/invoices/list` — Faturas (invoices) de assinatura no Pagar.me V5.
  - body: { invoice_id?: string, page?: number, size?: number, data?: string, account?: string, invoice_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/invoices/write` — Altera o status de uma fatura no Pagar.me V5 (requer invoice_id + status, ex.: 'paid', 'canceled').
  - body: { invoice_id: string, status: string, account?: string, invoice_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/legacy/balance` — Leitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa
  - body: { transaction_id?: string, data?: string, account?: string, transaction_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/legacy/get/transaction` — Leitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa
  - body: { transaction_id?: string, data?: string, account?: string, transaction_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/legacy/list/customers` — Leitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa
  - body: { transaction_id?: string, data?: string, account?: string, transaction_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/legacy/list/payables` — Leitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa
  - body: { transaction_id?: string, data?: string, account?: string, transaction_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/legacy/list/plans` — Leitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa
  - body: { transaction_id?: string, data?: string, account?: string, transaction_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/legacy/list/recipients` — Leitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa
  - body: { transaction_id?: string, data?: string, account?: string, transaction_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/legacy/list/subscriptions` — Leitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa
  - body: { transaction_id?: string, data?: string, account?: string, transaction_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/legacy/list/transactions` — Leitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa
  - body: { transaction_id?: string, data?: string, account?: string, transaction_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/legacy/list/transfers` — Leitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa
  - body: { transaction_id?: string, data?: string, account?: string, transaction_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/list/accounts` — Lista as contas Pagar.me (chaves) conectadas a este install — id, label e versão (V5 ou legado V1–V4).
  - body: { account?: string }
- `POST https://api.mcp.ai/api/pagarme/orders/get` — Pedidos (orders) no Pagar.me V5.
  - body: { order_id?: string, order_ids?: string[], page?: number, size?: number, data?: string, account?: string }
- `POST https://api.mcp.ai/api/pagarme/orders/get/many` — Pedidos (orders) no Pagar.me V5.
  - body: { order_id?: string, order_ids?: string[], page?: number, size?: number, data?: string, account?: string }
- `POST https://api.mcp.ai/api/pagarme/orders/list` — Pedidos (orders) no Pagar.me V5.
  - body: { order_id?: string, order_ids?: string[], page?: number, size?: number, data?: string, account?: string }
- `POST https://api.mcp.ai/api/pagarme/orders/write/close` — Criar/atualizar/fechar pedidos no Pagar.me V5 (só contas sk_).
  - body: { order_id?: string, closed?: boolean, data?: string, account?: string, order_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/orders/write/create` — Criar/atualizar/fechar pedidos no Pagar.me V5 (só contas sk_).
  - body: { order_id?: string, closed?: boolean, data?: string, account?: string, order_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/orders/write/update` — Criar/atualizar/fechar pedidos no Pagar.me V5 (só contas sk_).
  - body: { order_id?: string, closed?: boolean, data?: string, account?: string, order_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/payables/get` — Recebíveis (payables) no Pagar.me V5.
  - body: { payable_id?: string, page?: number, size?: number, data?: string, account?: string, payable_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/payables/list` — Recebíveis (payables) no Pagar.me V5.
  - body: { payable_id?: string, page?: number, size?: number, data?: string, account?: string, payable_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/plans/delete` — Remove um plano no Pagar.me V5 (requer plan_id). Irreversível.
  - body: { plan_id: string, account?: string, plan_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/plans/get` — Planos de assinatura no Pagar.me V5.
  - body: { plan_id?: string, page?: number, size?: number, data?: string, account?: string, plan_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/plans/list` — Planos de assinatura no Pagar.me V5.
  - body: { plan_id?: string, page?: number, size?: number, data?: string, account?: string, plan_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/plans/write/create` — Criar/atualizar planos no Pagar.me V5 (só sk_).
  - body: { plan_id?: string, data?: string, account?: string, plan_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/plans/write/update` — Criar/atualizar planos no Pagar.me V5 (só sk_).
  - body: { plan_id?: string, data?: string, account?: string, plan_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/recipients/anticipation/limits` — Recebedores (split/marketplace) no Pagar.me V5.
  - body: { recipient_id?: string, page?: number, size?: number, data?: string, account?: string, recipient_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/recipients/anticipations` — Recebedores (split/marketplace) no Pagar.me V5.
  - body: { recipient_id?: string, page?: number, size?: number, data?: string, account?: string, recipient_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/recipients/balance` — Recebedores (split/marketplace) no Pagar.me V5.
  - body: { recipient_id?: string, page?: number, size?: number, data?: string, account?: string, recipient_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/recipients/default` — Recebedores (split/marketplace) no Pagar.me V5.
  - body: { recipient_id?: string, page?: number, size?: number, data?: string, account?: string, recipient_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/recipients/get` — Recebedores (split/marketplace) no Pagar.me V5.
  - body: { recipient_id?: string, page?: number, size?: number, data?: string, account?: string, recipient_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/recipients/list` — Recebedores (split/marketplace) no Pagar.me V5.
  - body: { recipient_id?: string, page?: number, size?: number, data?: string, account?: string, recipient_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/recipients/transfers` — Recebedores (split/marketplace) no Pagar.me V5.
  - body: { recipient_id?: string, page?: number, size?: number, data?: string, account?: string, recipient_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/recipients/withdrawals` — Recebedores (split/marketplace) no Pagar.me V5.
  - body: { recipient_id?: string, page?: number, size?: number, data?: string, account?: string, recipient_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/recipients/write/create` — Criar/operar recebedores no Pagar.me V5 (só sk_).
  - body: { recipient_id?: string, data?: string, account?: string, recipient_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/recipients/write/create/anticipation` — Criar/operar recebedores no Pagar.me V5 (só sk_).
  - body: { recipient_id?: string, data?: string, account?: string, recipient_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/recipients/write/create/withdrawal` — Criar/operar recebedores no Pagar.me V5 (só sk_).
  - body: { recipient_id?: string, data?: string, account?: string, recipient_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/recipients/write/update` — Criar/operar recebedores no Pagar.me V5 (só sk_).
  - body: { recipient_id?: string, data?: string, account?: string, recipient_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/recipients/write/update/bank/account` — Criar/operar recebedores no Pagar.me V5 (só sk_).
  - body: { recipient_id?: string, data?: string, account?: string, recipient_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/subscriptions/cancel` — Cancela uma assinatura no Pagar.me V5 (requer subscription_id; data opcional: { cancel_pending_invoices }). Irreversível.
  - body: { subscription_id: string, data?: string, account?: string, subscription_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/subscriptions/cycles` — Assinaturas no Pagar.me V5.
  - body: { subscription_id?: string, item_id?: string, page?: number, size?: number, data?: string, account?: string, subscription_ids?: string[], item_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/subscriptions/get` — Assinaturas no Pagar.me V5.
  - body: { subscription_id?: string, item_id?: string, page?: number, size?: number, data?: string, account?: string, subscription_ids?: string[], item_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/subscriptions/items` — Assinaturas no Pagar.me V5.
  - body: { subscription_id?: string, item_id?: string, page?: number, size?: number, data?: string, account?: string, subscription_ids?: string[], item_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/subscriptions/list` — Assinaturas no Pagar.me V5.
  - body: { subscription_id?: string, item_id?: string, page?: number, size?: number, data?: string, account?: string, subscription_ids?: string[], item_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/subscriptions/usages` — Assinaturas no Pagar.me V5.
  - body: { subscription_id?: string, item_id?: string, page?: number, size?: number, data?: string, account?: string, subscription_ids?: string[], item_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/subscriptions/write/add/item` — Criar/operar assinaturas no Pagar.me V5 (só sk_; não-destrutivas).
  - body: { subscription_id?: string, item_id?: string, data?: string, account?: string, subscription_ids?: string[], item_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/subscriptions/write/add/usage` — Criar/operar assinaturas no Pagar.me V5 (só sk_; não-destrutivas).
  - body: { subscription_id?: string, item_id?: string, data?: string, account?: string, subscription_ids?: string[], item_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/subscriptions/write/create` — Criar/operar assinaturas no Pagar.me V5 (só sk_; não-destrutivas).
  - body: { subscription_id?: string, item_id?: string, data?: string, account?: string, subscription_ids?: string[], item_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/subscriptions/write/update/billing/date` — Criar/operar assinaturas no Pagar.me V5 (só sk_; não-destrutivas).
  - body: { subscription_id?: string, item_id?: string, data?: string, account?: string, subscription_ids?: string[], item_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/subscriptions/write/update/card` — Criar/operar assinaturas no Pagar.me V5 (só sk_; não-destrutivas).
  - body: { subscription_id?: string, item_id?: string, data?: string, account?: string, subscription_ids?: string[], item_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/subscriptions/write/update/payment/method` — Criar/operar assinaturas no Pagar.me V5 (só sk_; não-destrutivas).
  - body: { subscription_id?: string, item_id?: string, data?: string, account?: string, subscription_ids?: string[], item_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/transfers/get` — Transferências no Pagar.me V5.
  - body: { transfer_id?: string, page?: number, size?: number, data?: string, account?: string, transfer_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/transfers/list` — Transferências no Pagar.me V5.
  - body: { transfer_id?: string, page?: number, size?: number, data?: string, account?: string, transfer_ids?: string[] }
- `POST https://api.mcp.ai/api/pagarme/transfers/write` — Cria uma transferência no Pagar.me V5 (só sk_). data = JSON do corpo (amount, recipient_id, …).
  - body: { data: string, account?: string }

## Example prompts
- "Liste as cobranças pagas dos últimos 7 dias"
- "Mostre as assinaturas ativas e suas próximas faturas"
- "Qual o saldo do recebedor padrão e os próximos recebíveis?"

## More
- Page: https://mcp.ai/pagarme
- Agent spec (llms.txt): https://mcp.ai/pagarme/llms.txt
- Postman collection: https://mcp.ai/pagarme/postman.json