# Pagar.me [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/mcp-dir/pagarme-mcp  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/pagar-me

## Description
Stone's payments gateway (api.pagar.me), orders, charges (card, Pix, boleto), customers and cards, p

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "pagar-me": {
    "command": "npx",
    "args": ["-y","pagar-me"]
  }
}
```

## Documentation & README

# Pagar.me

### Pagar.me para Claude, Cursor e agentes de IA

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.

- 📊 **80 ferramentas**
- ✏️ **Leitura e escrita**
- 💬 **Funciona com qualquer cliente MCP**: Claude Desktop, Cursor, VS Code, Cline, Continue
- 🔑 **Login via magic-link (sem senha)**

[English version](https://github.com/mcp-dir/pagarme-mcp/blob/HEAD/README.en.md) · [Documentação completa](https://github.com/mcp-dir/pagarme-mcp/blob/HEAD/docs/) · [Skill pra agentes](https://github.com/mcp-dir/pagarme-mcp/blob/HEAD/skills/)

---

## Instalar em 1 clique

### Claude (Web e Desktop)

A Anthropic unificou a instalação de MCPs em `claude.ai/customize/connectors`. **O mesmo link serve pra Claude Web e Claude Desktop** (basta estar logado):

[➕ Abrir no Claude e conectar](https://claude.ai/customize/connectors?modal=add-custom-connector&mcpName=Pagar.me&mcpServerUrl=https%3A%2F%2Fapi.mcp.ai%2Fp_pagarme)

**Manual** (se o deeplink não abrir): [claude.ai/customize/connectors](https://claude.ai/customize/connectors) → **+** → **Adicionar conector personalizado** → cole **Nome** `Pagar.me` e **URL** `https://api.mcp.ai/p_pagarme`.

### Cursor

[➕ Instalar Pagar.me no Cursor](https://github.com/mcp-dir/pagarme-mcp/blob/HEAD/cursor://anysphere.cursor-deeplink/mcp/install?name=pagarme&config=eyJ1cmwiOiJodHRwczovL2FwaS5tY3AuYWkvcF9wYWdhcm1lIn0=)

### VS Code (Copilot Chat)

[➕ Instalar Pagar.me no VS Code](https://github.com/mcp-dir/pagarme-mcp/blob/HEAD/vscode:mcp/install?name=pagarme&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.mcp.ai%2Fp_pagarme%22%7D)

### ChatGPT, Manus, OpenClaw e mais 40+ clientes

Funciona em qualquer cliente MCP que suporte **MCP over HTTP**. A URL do servidor é sempre:

```
https://api.mcp.ai/p_pagarme
```

Detalhes por cliente: [INSTALL.md](https://github.com/mcp-dir/pagarme-mcp/blob/HEAD/INSTALL.md).

---

## Exemplos de uso

```
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?
```

---

## 80 ferramentas disponíveis

| Tool | Descrição |
|---|---|
| `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 por order_id. - get_many: busca vários por order_ids (lote, retorna { results, errors }). [Flattened action: list] |
| `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 por order_id. - get_many: busca vários por order_ids (lote, retorna { results, errors }). [Flattened action: get] |
| `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 por order_id. - get_many: busca vários por order_ids (lote, retorna { results, errors }). [Flattened action: get_many] |
| `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[], payments[]). - update: atualiza pedido (requer order_id). data = campos a alterar. - close: fecha (closed:true) ou reabre (closed:false) o pedido (requer order_id). [Flattened action: create] Bulk support: accepts order_ids for batched execution. |
| `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[], payments[]). - update: atualiza pedido (requer order_id). data = campos a alterar. - close: fecha (closed:true) ou reabre (closed:false) o pedido (requer order_id). [Flattened action: update] Bulk support: accepts order_ids for batched execution. |
| `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[], payments[]). - update: atualiza pedido (requer order_id). data = campos a alterar. - close: fecha (closed:true) ou reabre (closed:false) o pedido (requer order_id). [Flattened action: close] Bulk support: accepts order_ids for batched execution. |
| `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, created_since/until). - summary: agregado de cobranças (data: status, created_since/until). - get: detalhe por charge_id. - get_many: vários por charge_ids (lote). [Flattened action: list] |
| `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, created_since/until). - summary: agregado de cobranças (data: status, created_since/until). - get: detalhe por charge_id. - get_many: vários por charge_ids (lote). [Flattened action: summary] |
| `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, created_since/until). - summary: agregado de cobranças (data: status, created_since/until). - get: detalhe por charge_id. - get_many: vários por charge_ids (lote). [Flattened action: get] |
| `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, created_since/until). - summary: agregado de cobranças (data: status, created_since/until). - get: detalhe por charge_id. - get_many: vários por charge_ids (lote). [Flattened action: get_many] |
| `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: reprocessa. - confirm: confirma pagamento (cash/voucher; data opcional). - update_due_date: altera vencimento (data: { due_at }). - update_payment_method: altera meio de pagamento (data). - update_card: altera cartão (data). [Flattened action: capture] Bulk support: accepts charge_ids for batched execution. |
| `pagarme_charges_write_retry` | Operar cobranças no Pagar.me V5 (só contas sk_; não-destrutivas). Ações (requerem charge_id): - capture: captura (data opcional: amount). - retry: reprocessa. - confirm: confirma pagamento (cash/voucher; data opcional). - update_due_date: altera vencimento (data: { due_at }). - update_payment_method: altera meio de pagamento (data). - update_card: altera cartão (data). [Flattened action: retry] Bulk support: accepts charge_ids for batched execution. |
| `pagarme_charges_write_confirm` | Operar cobranças no Pagar.me V5 (só contas sk_; não-destrutivas). Ações (requerem charge_id): - capture: captura (data opcional: amount). - retry: reprocessa. - confirm: confirma pagamento (cash/voucher; data opcional). - update_due_date: altera vencimento (data: { due_at }). - update_payment_method: altera meio de pagamento (data). - update_card: altera cartão (data). [Flattened action: confirm] Bulk support: accepts charge_ids for batched execution. |
| `pagarme_charges_write_update_due_date` | Operar cobranças no Pagar.me V5 (só contas sk_; não-destrutivas). Ações (requerem charge_id): - capture: captura (data opcional: amount). - retry: reprocessa. - confirm: confirma pagamento (cash/voucher; data opcional). - update_due_date: altera vencimento (data: { due_at }). - update_payment_method: altera meio de pagamento (data). - update_card: altera cartão (data). [Flattened action: update_due_date] Bulk support: accepts charge_ids for batched execution. |
| `pagarme_charges_write_update_payment_method` | Operar cobranças no Pagar.me V5 (só contas sk_; não-destrutivas). Ações (requerem charge_id): - capture: captura (data opcional: amount). - retry: reprocessa. - confirm: confirma pagamento (cash/voucher; data opcional). - update_due_date: altera vencimento (data: { due_at }). - update_payment_method: altera meio de pagamento (data). - update_card: altera cartão (data). [Flattened action: update_payment_method] Bulk support: accepts charge_ids for batched execution. |
| `pagarme_charges_write_update_card` | Operar cobranças no Pagar.me V5 (só contas sk_; não-destrutivas). Ações (requerem charge_id): - capture: captura (data opcional: amount). - retry: reprocessa. - confirm: confirma pagamento (cash/voucher; data opcional). - update_due_date: altera vencimento (data: { due_at }). - update_payment_method: altera meio de pagamento (data). - update_card: altera cartão (data). [Flattened action: update_card] Bulk support: accepts charge_ids for batched execution. |
| `pagarme_charges_cancel` | Cancela/estorna uma cobrança no Pagar.me V5 (requer charge_id; data opcional com amount p/ estorno parcial). Irreversível. Bulk support: accepts charge_ids for batched execution. |
| `pagarme_customers_list` | Clientes e endereços no Pagar.me V5. Ações: - list: lista clientes (page, size; data: name, email, document, code). - get: cliente por customer_id. - list_addresses: endereços do cliente (requer customer_id). - get_address: endereço (requer customer_id + address_id). [Flattened action: list] Bulk support: accepts customer_ids, address_ids for batched execution. |
| `pagarme_customers_get` | Clientes e endereços no Pagar.me V5. Ações: - list: lista clientes (page, size; data: name, email, document, code). - get: cliente por customer_id. - list_addresses: endereços do cliente (requer customer_id). - get_address: endereço (requer customer_id + address_id). [Flattened action: get] Bulk support: accepts customer_ids, address_ids for batched execution. |
| `pagarme_customers_list_addresses` | Clientes e endereços no Pagar.me V5. Ações: - list: lista clientes (page, size; data: name, email, document, code). - get: cliente por customer_id. - list_addresses: endereços do cliente (requer customer_id). - get_address: endereço (requer customer_id + address_id). [Flattened action: list_addresses] Bulk support: accepts customer_ids, address_ids for batched execution. |
| `pagarme_customers_get_address` | Clientes e endereços no Pagar.me V5. Ações: - list: lista clientes (page, size; data: name, email, document, code). - get: cliente por customer_id. - list_addresses: endereços do cliente (requer customer_id). - get_address: endereço (requer customer_id + address_id). [Flattened action: get_address] Bulk support: accepts customer_ids, address_ids for batched execution. |
| `pagarme_customers_write_create` | Criar/atualizar clientes e endereços no Pagar.me V5 (só sk_). Ações: - create: cria cliente (data: name, email, document, type, …). - update: atualiza cliente (requer customer_id; data). - create_address: cria endereço (requer customer_id; data). - update_address: atualiza endereço (requer customer_id + address_id; data). - delete_address: remove endereço (requer customer_id + address_id). [Flattened action: create] Bulk support: accepts customer_ids, address_ids for batched execution. |
| `pagarme_customers_write_update` | Criar/atualizar clientes e endereços no Pagar.me V5 (só sk_). Ações: - create: cria cliente (data: name, email, document, type, …). - update: atualiza cliente (requer customer_id; data). - create_address: cria endereço (requer customer_id; data). - update_address: atualiza endereço (requer customer_id + address_id; data). - delete_address: remove endereço (requer customer_id + address_id). [Flattened action: update] Bulk support: accepts customer_ids, address_ids for batched execution. |
| `pagarme_customers_write_create_address` | Criar/atualizar clientes e endereços no Pagar.me V5 (só sk_). Ações: - create: cria cliente (data: name, email, document, type, …). - update: atualiza cliente (requer customer_id; data). - create_address: cria endereço (requer customer_id; data). - update_address: atualiza endereço (requer customer_id + address_id; data). - delete_address: remove endereço (requer customer_id + address_id). [Flattened action: create_address] Bulk support: accepts customer_ids, address_ids for batched execution. |
| `pagarme_customers_write_update_address` | Criar/atualizar clientes e endereços no Pagar.me V5 (só sk_). Ações: - create: cria cliente (data: name, email, document, type, …). - update: atualiza cliente (requer customer_id; data). - create_address: cria endereço (requer customer_id; data). - update_address: atualiza endereço (requer customer_id + address_id; data). - delete_address: remove endereço (requer customer_id + address_id). [Flattened action: update_address] Bulk support: accepts customer_ids, address_ids for batched execution. |
| `pagarme_customers_write_delete_address` | Criar/atualizar clientes e endereços no Pagar.me V5 (só sk_). Ações: - create: cria cliente (data: name, email, document, type, …). - update: atualiza cliente (requer customer_id; data). - create_address: cria endereço (requer customer_id; data). - update_address: atualiza endereço (requer customer_id + address_id; data). - delete_address: remove endereço (requer customer_id + address_id). [Flattened action: delete_address] Bulk support: accepts customer_ids, address_ids for batched execution. |
| `pagarme_cards_list` | Cartões salvos de um cliente no Pagar.me V5. Ações (requerem customer_id): - list: lista cartões. - get: cartão por card_id. [Flattened action: list] Bulk support: accepts customer_ids, card_ids for batched execution. |
| `pagarme_cards_get` | Cartões salvos de um cliente no Pagar.me V5. Ações (requerem customer_id): - list: lista cartões. - get: cartão por card_id. [Flattened action: get] Bulk support: accepts customer_ids, card_ids for batched execution. |
| `pagarme_cards_write_create` | Criar/renovar cartões de um cliente no Pagar.me V5 (só sk_; requer customer_id). Ações: - create: tokeniza/salva cartão (data: number, holder_name, exp_month, exp_year, cvv ou card_token). - renew: renova cartão (requer card_id). [Flattened action: create] Bulk support: accepts customer_ids, card_ids for batched execution. |
| `pagarme_cards_write_renew` | Criar/renovar cartões de um cliente no Pagar.me V5 (só sk_; requer customer_id). Ações: - create: tokeniza/salva cartão (data: number, holder_name, exp_month, exp_year, cvv ou card_token). - renew: renova cartão (requer card_id). [Flattened action: renew] Bulk support: accepts customer_ids, card_ids for batched execution. |
| `pagarme_cards_delete` | Remove um cartão salvo do cliente no Pagar.me V5 (requer customer_id + card_id). Irreversível. Bulk support: accepts customer_ids, card_ids for batched execution. |
| `pagarme_plans_list` | Planos de assinatura no Pagar.me V5. Ações: - list: lista planos (page, size; data: name, status). - get: plano por plan_id. [Flattened action: list] Bulk support: accepts plan_ids for batched execution. |
| `pagarme_plans_get` | Planos de assinatura no Pagar.me V5. Ações: - list: lista planos (page, size; data: name, status). - get: plano por plan_id. [Flattened action: get] Bulk support: accepts plan_ids for batched execution. |
| `pagarme_plans_write_create` | Criar/atualizar planos no Pagar.me V5 (só sk_). Ações: - create: cria plano (data: name, interval, interval_count, items[], …). - update: atualiza plano (requer plan_id; data). [Flattened action: create] Bulk support: accepts plan_ids for batched execution. |
| `pagarme_plans_write_update` | Criar/atualizar planos no Pagar.me V5 (só sk_). Ações: - create: cria plano (data: name, interval, interval_count, items[], …). - update: atualiza plano (requer plan_id; data). [Flattened action: update] Bulk support: accepts plan_ids for batched execution. |
| `pagarme_plans_delete` | Remove um plano no Pagar.me V5 (requer plan_id). Irreversível. Bulk support: accepts plan_ids for batched execution. |
| `pagarme_subscriptions_list` | Assinaturas no Pagar.me V5. Ações: - list: lista assinaturas (page, size; data: customer_id, plan_id, status, created_since/until). - get: assinatura por subscription_id. - items: itens da assinatura (requer subscription_id). - cycles: ciclos da assinatura (requer subscription_id). - usages: usos de um item medido (requer subscription_id + item_id). [Flattened action: list] Bulk support: accepts subscription_ids, item_ids for batched execution. |
| `pagarme_subscriptions_get` | Assinaturas no Pagar.me V5. Ações: - list: lista assinaturas (page, size; data: customer_id, plan_id, status, created_since/until). - get: assinatura por subscription_id. - items: itens da assinatura (requer subscription_id). - cycles: ciclos da assinatura (requer subscription_id). - usages: usos de um item medido (requer subscription_id + item_id). [Flattened action: get] Bulk support: accepts subscription_ids, item_ids for batched execution. |
| `pagarme_subscriptions_items` | Assinaturas no Pagar.me V5. Ações: - list: lista assinaturas (page, size; data: customer_id, plan_id, status, created_since/until). - get: assinatura por subscription_id. - items: itens da assinatura (requer subscription_id). - cycles: ciclos da assinatura (requer subscription_id). - usages: usos de um item medido (requer subscription_id + item_id). [Flattened action: items] Bulk support: accepts subscription_ids, item_ids for batched execution. |
| `pagarme_subscriptions_cycles` | Assinaturas no Pagar.me V5. Ações: - list: lista assinaturas (page, size; data: customer_id, plan_id, status, created_since/until). - get: assinatura por subscription_id. - items: itens da assinatura (requer subscription_id). - cycles: ciclos da assinatura (requer subscription_id). - usages: usos de um item medido (requer subscription_id + item_id). [Flattened action: cycles] Bulk support: accepts subscription_ids, item_ids for batched execution. |
| `pagarme_subscriptions_usages` | Assinaturas no Pagar.me V5. Ações: - list: lista assinaturas (page, size; data: customer_id, plan_id, status, created_since/until). - get: assinatura por subscription_id. - items: itens da assinatura (requer subscription_id). - cycles: ciclos da assinatura (requer subscription_id). - usages: usos de um item medido (requer subscription_id + item_id). [Flattened action: usages] Bulk support: accepts subscription_ids, item_ids for batched execution. |
| `pagarme_subscriptions_write_create` | Criar/operar assinaturas no Pagar.me V5 (só sk_; não-destrutivas). Ações: - create: cria assinatura (data: customer_id/customer, plan_id ou items[], payment_method, card_id, …). - update_card: altera cartão (requer subscription_id; data). - update_payment_method: altera meio de pagamento (requer subscription_id; data). - update_billing_date: altera data de cobrança (requer subscription_id; data). - add_item: adiciona item (requer subscription_id; data). - add_usage: registra uso de item medido (requer subscription_id + item_id; data opcional). [Flattened action: create] Bulk support: accepts subscription_ids, item_ids for batched execution. |
| `pagarme_subscriptions_write_update_card` | Criar/operar assinaturas no Pagar.me V5 (só sk_; não-destrutivas). Ações: - create: cria assinatura (data: customer_id/customer, plan_id ou items[], payment_method, card_id, …). - update_card: altera cartão (requer subscription_id; data). - update_payment_method: altera meio de pagamento (requer subscription_id; data). - update_billing_date: altera data de cobrança (requer subscription_id; data). - add_item: adiciona item (requer subscription_id; data). - add_usage: registra uso de item medido (requer subscription_id + item_id; data opcional). [Flattened action: update_card] Bulk support: accepts subscription_ids, item_ids for batched execution. |
| `pagarme_subscriptions_write_update_payment_method` | Criar/operar assinaturas no Pagar.me V5 (só sk_; não-destrutivas). Ações: - create: cria assinatura (data: customer_id/customer, plan_id ou items[], payment_method, card_id, …). - update_card: altera cartão (requer subscription_id; data). - update_payment_method: altera meio de pagamento (requer subscription_id; data). - update_billing_date: altera data de cobrança (requer subscription_id; data). - add_item: adiciona item (requer subscription_id; data). - add_usage: registra uso de item medido (requer subscription_id + item_id; data opcional). [Flattened action: update_payment_method] Bulk support: accepts subscription_ids, item_ids for batched execution. |
| `pagarme_subscriptions_write_update_billing_date` | Criar/operar assinaturas no Pagar.me V5 (só sk_; não-destrutivas). Ações: - create: cria assinatura (data: customer_id/customer, plan_id ou items[], payment_method, card_id, …). - update_card: altera cartão (requer subscription_id; data). - update_payment_method: altera meio de pagamento (requer subscription_id; data). - update_billing_date: altera data de cobrança (requer subscription_id; data). - add_item: adiciona item (requer subscription_id; data). - add_usage: registra uso de item medido (requer subscription_id + item_id; data opcional). [Flattened action: update_billing_date] Bulk support: accepts subscription_ids, item_ids for batched execution. |
| `pagarme_subscriptions_write_add_item` | Criar/operar assinaturas no Pagar.me V5 (só sk_; não-destrutivas). Ações: - create: cria assinatura (data: customer_id/customer, plan_id ou items[], payment_method, card_id, …). - update_card: altera cartão (requer subscription_id; data). - update_payment_method: altera meio de pagamento (requer subscription_id; data). - update_billing_date: altera data de cobrança (requer subscription_id; data). - add_item: adiciona item (requer subscription_id; data). - add_usage: registra uso de item medido (requer subscription_id + item_id; data opcional). [Flattened action: add_item] Bulk support: accepts subscription_ids, item_ids for batched execution. |
| `pagarme_subscriptions_write_add_usage` | Criar/operar assinaturas no Pagar.me V5 (só sk_; não-destrutivas). Ações: - create: cria assinatura (data: customer_id/customer, plan_id ou items[], payment_method, card_id, …). - update_card: altera cartão (requer subscription_id; data). - update_payment_method: altera meio de pagamento (requer subscription_id; data). - update_billing_date: altera data de cobrança (requer subscription_id; data). - add_item: adiciona item (requer subscription_id; data). - add_usage: registra uso de item medido (requer subscription_id + item_id; data opcional). [Flattened action: add_usage] Bulk support: accepts subscription_ids, item_ids for batched execution. |
| `pagarme_subscriptions_cancel` | Cancela uma assinatura no Pagar.me V5 (requer subscription_id; data opcional: { cancel_pending_invoices }). Irreversível. Bulk support: accepts subscription_ids for batched execution. |
| `pagarme_recipients_list` | Recebedores (split/marketplace) no Pagar.me V5. Ações: - list: lista recebedores (page, size). - get: recebedor por recipient_id. - default: recebedor padrão (a própria conta). - balance: saldo do recebedor (requer recipient_id). - transfers: transferências do recebedor (requer recipient_id). - withdrawals: saques do recebedor (requer recipient_id). - anticipations: antecipações do recebedor (requer recipient_id). - anticipation_limits: limites de antecipação (requer recipient_id). [Flattened action: list] Bulk support: accepts recipient_ids for batched execution. |
| `pagarme_recipients_get` | Recebedores (split/marketplace) no Pagar.me V5. Ações: - list: lista recebedores (page, size). - get: recebedor por recipient_id. - default: recebedor padrão (a própria conta). - balance: saldo do recebedor (requer recipient_id). - transfers: transferências do recebedor (requer recipient_id). - withdrawals: saques do recebedor (requer recipient_id). - anticipations: antecipações do recebedor (requer recipient_id). - anticipation_limits: limites de antecipação (requer recipient_id). [Flattened action: get] Bulk support: accepts recipient_ids for batched execution. |
| `pagarme_recipients_default` | Recebedores (split/marketplace) no Pagar.me V5. Ações: - list: lista recebedores (page, size). - get: recebedor por recipient_id. - default: recebedor padrão (a própria conta). - balance: saldo do recebedor (requer recipient_id). - transfers: transferências do recebedor (requer recipient_id). - withdrawals: saques do recebedor (requer recipient_id). - anticipations: antecipações do recebedor (requer recipient_id). - anticipation_limits: limites de antecipação (requer recipient_id). [Flattened action: default] Bulk support: accepts recipient_ids for batched execution. |
| `pagarme_recipients_balance` | Recebedores (split/marketplace) no Pagar.me V5. Ações: - list: lista recebedores (page, size). - get: recebedor por recipient_id. - default: recebedor padrão (a própria conta). - balance: saldo do recebedor (requer recipient_id). - transfers: transferências do recebedor (requer recipient_id). - withdrawals: saques do recebedor (requer recipient_id). - anticipations: antecipações do recebedor (requer recipient_id). - anticipation_limits: limites de antecipação (requer recipient_id). [Flattened action: balance] Bulk support: accepts recipient_ids for batched execution. |
| `pagarme_recipients_transfers` | Recebedores (split/marketplace) no Pagar.me V5. Ações: - list: lista recebedores (page, size). - get: recebedor por recipient_id. - default: recebedor padrão (a própria conta). - balance: saldo do recebedor (requer recipient_id). - transfers: transferências do recebedor (requer recipient_id). - withdrawals: saques do recebedor (requer recipient_id). - anticipations: antecipações do recebedor (requer recipient_id). - anticipation_limits: limites de antecipação (requer recipient_id). [Flattened action: transfers] Bulk support: accepts recipient_ids for batched execution. |
| `pagarme_recipients_withdrawals` | Recebedores (split/marketplace) no Pagar.me V5. Ações: - list: lista recebedores (page, size). - get: recebedor por recipient_id. - default: recebedor padrão (a própria conta). - balance: saldo do recebedor (requer recipient_id). - transfers: transferências do recebedor (requer recipient_id). - withdrawals: saques do recebedor (requer recipient_id). - anticipations: antecipações do recebedor (requer recipient_id). - anticipation_limits: limites de antecipação (requer recipient_id). [Flattened action: withdrawals] Bulk support: accepts recipient_ids for batched execution. |
| `pagarme_recipients_anticipations` | Recebedores (split/marketplace) no Pagar.me V5. Ações: - list: lista recebedores (page, size). - get: recebedor por recipient_id. - default: recebedor padrão (a própria conta). - balance: saldo do recebedor (requer recipient_id). - transfers: transferências do recebedor (requer recipient_id). - withdrawals: saques do recebedor (requer recipient_id). - anticipations: antecipações do recebedor (requer recipient_id). - anticipation_limits: limites de antecipação (requer recipient_id). [Flattened action: anticipations] Bulk support: accepts recipient_ids for batched execution. |
| `pagarme_recipients_anticipation_limits` | Recebedores (split/marketplace) no Pagar.me V5. Ações: - list: lista recebedores (page, size). - get: recebedor por recipient_id. - default: recebedor padrão (a própria conta). - balance: saldo do recebedor (requer recipient_id). - transfers: transferências do recebedor (requer recipient_id). - withdrawals: saques do recebedor (requer recipient_id). - anticipations: antecipações do recebedor (requer recipient_id). - anticipation_limits: limites de antecipação (requer recipient_id). [Flattened action: anticipation_limits] Bulk support: accepts recipient_ids for batched execution. |
| `pagarme_recipients_write_create` | Criar/operar recebedores no Pagar.me V5 (só sk_). Ações: - create: cria recebedor (data). - update: atualiza recebedor (requer recipient_id; data). - update_bank_account: atualiza conta bancária (requer recipient_id; data). - create_withdrawal: cria saque (requer recipient_id; data: { amount }). - create_anticipation: cria antecipação (requer recipient_id; data). [Flattened action: create] Bulk support: accepts recipient_ids for batched execution. |
| `pagarme_recipients_write_update` | Criar/operar recebedores no Pagar.me V5 (só sk_). Ações: - create: cria recebedor (data). - update: atualiza recebedor (requer recipient_id; data). - update_bank_account: atualiza conta bancária (requer recipient_id; data). - create_withdrawal: cria saque (requer recipient_id; data: { amount }). - create_anticipation: cria antecipação (requer recipient_id; data). [Flattened action: update] Bulk support: accepts recipient_ids for batched execution. |
| `pagarme_recipients_write_update_bank_account` | Criar/operar recebedores no Pagar.me V5 (só sk_). Ações: - create: cria recebedor (data). - update: atualiza recebedor (requer recipient_id; data). - update_bank_account: atualiza conta bancária (requer recipient_id; data). - create_withdrawal: cria saque (requer recipient_id; data: { amount }). - create_anticipation: cria antecipação (requer recipient_id; data). [Flattened action: update_bank_account] Bulk support: accepts recipient_ids for batched execution. |
| `pagarme_recipients_write_create_withdrawal` | Criar/operar recebedores no Pagar.me V5 (só sk_). Ações: - create: cria recebedor (data). - update: atualiza recebedor (requer recipient_id; data). - update_bank_account: atualiza conta bancária (requer recipient_id; data). - create_withdrawal: cria saque (requer recipient_id; data: { amount }). - create_anticipation: cria antecipação (requer recipient_id; data). [Flattened action: create_withdrawal] Bulk support: accepts recipient_ids for batched execution. |
| `pagarme_recipients_write_create_anticipation` | Criar/operar recebedores no Pagar.me V5 (só sk_). Ações: - create: cria recebedor (data). - update: atualiza recebedor (requer recipient_id; data). - update_bank_account: atualiza conta bancária (requer recipient_id; data). - create_withdrawal: cria saque (requer recipient_id; data: { amount }). - create_anticipation: cria antecipação (requer recipient_id; data). [Flattened action: create_anticipation] Bulk support: accepts recipient_ids for batched execution. |
| `pagarme_transfers_list` | Transferências no Pagar.me V5. Ações: - list: lista transferências (page, size; data: filtros). - get: transferência por transfer_id. [Flattened action: list] Bulk support: accepts transfer_ids for batched execution. |
| `pagarme_transfers_get` | Transferências no Pagar.me V5. Ações: - list: lista transferências (page, size; data: filtros). - get: transferência por transfer_id. [Flattened action: get] Bulk support: accepts transfer_ids for batched execution. |
| `pagarme_transfers_write` | Cria uma transferência no Pagar.me V5 (só sk_). data = JSON do corpo (amount, recipient_id, …). |
| `pagarme_payables_list` | Recebíveis (payables) no Pagar.me V5. Ações: - list: lista recebíveis (page, size; data: status, payment_date, type, …). - get: recebível por payable_id. [Flattened action: list] Bulk support: accepts payable_ids for batched execution. |
| `pagarme_payables_get` | Recebíveis (payables) no Pagar.me V5. Ações: - list: lista recebíveis (page, size; data: status, payment_date, type, …). - get: recebível por payable_id. [Flattened action: get] Bulk support: accepts payable_ids for batched execution. |
| `pagarme_invoices_list` | Faturas (invoices) de assinatura no Pagar.me V5. Ações: - list: lista faturas (page, size; data: subscription_id, customer_id, status, due_since/until). - get: fatura por invoice_id. [Flattened action: list] Bulk support: accepts invoice_ids for batched execution. |
| `pagarme_invoices_get` | Faturas (invoices) de assinatura no Pagar.me V5. Ações: - list: lista faturas (page, size; data: subscription_id, customer_id, status, due_since/until). - get: fatura por invoice_id. [Flattened action: get] Bulk support: accepts invoice_ids for batched execution. |
| `pagarme_invoices_write` | Altera o status de uma fatura no Pagar.me V5 (requer invoice_id + status, ex.: 'paid', 'canceled'). Bulk support: accepts invoice_ids for batched execution. |
| `pagarme_invoices_cancel` | Cancela uma fatura no Pagar.me V5 (requer invoice_id). Irreversível. Bulk support: accepts invoice_ids for batched execution. |
| `pagarme_legacy_list_transactions` | Leitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa quando a conexão usa uma chave ak_… (contas ainda não migradas pra V5). As 4 versões legadas compartilham estes endpoints; diferenças de campo entre V1/V2/V3/V4 vêm cruas no payload. Ações: - list_transactions / get_transaction (requer transaction_id) - list_subscriptions / list_plans / list_payables / list_recipients / list_customers / list_transfers - balance: saldo da conta Filtros de lista (count, page, status, …) via data (JSON). [Flattened action: list_transactions] Bulk support: accepts transaction_ids for batched execution. |
| `pagarme_legacy_get_transaction` | Leitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa quando a conexão usa uma chave ak_… (contas ainda não migradas pra V5). As 4 versões legadas compartilham estes endpoints; diferenças de campo entre V1/V2/V3/V4 vêm cruas no payload. Ações: - list_transactions / get_transaction (requer transaction_id) - list_subscriptions / list_plans / list_payables / list_recipients / list_customers / list_transfers - balance: saldo da conta Filtros de lista (count, page, status, …) via data (JSON). [Flattened action: get_transaction] Bulk support: accepts transaction_ids for batched execution. |
| `pagarme_legacy_list_subscriptions` | Leitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa quando a conexão usa uma chave ak_… (contas ainda não migradas pra V5). As 4 versões legadas compartilham estes endpoints; diferenças de campo entre V1/V2/V3/V4 vêm cruas no payload. Ações: - list_transactions / get_transaction (requer transaction_id) - list_subscriptions / list_plans / list_payables / list_recipients / list_customers / list_transfers - balance: saldo da conta Filtros de lista (count, page, status, …) via data (JSON). [Flattened action: list_subscriptions] Bulk support: accepts transaction_ids for batched execution. |
| `pagarme_legacy_list_plans` | Leitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa quando a conexão usa uma chave ak_… (contas ainda não migradas pra V5). As 4 versões legadas compartilham estes endpoints; diferenças de campo entre V1/V2/V3/V4 vêm cruas no payload. Ações: - list_transactions / get_transaction (requer transaction_id) - list_subscriptions / list_plans / list_payables / list_recipients / list_customers / list_transfers - balance: saldo da conta Filtros de lista (count, page, status, …) via data (JSON). [Flattened action: list_plans] Bulk support: accepts transaction_ids for batched execution. |
| `pagarme_legacy_list_payables` | Leitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa quando a conexão usa uma chave ak_… (contas ainda não migradas pra V5). As 4 versões legadas compartilham estes endpoints; diferenças de campo entre V1/V2/V3/V4 vêm cruas no payload. Ações: - list_transactions / get_transaction (requer transaction_id) - list_subscriptions / list_plans / list_payables / list_recipients / list_customers / list_transfers - balance: saldo da conta Filtros de lista (count, page, status, …) via data (JSON). [Flattened action: list_payables] Bulk support: accepts transaction_ids for batched execution. |
| `pagarme_legacy_list_recipients` | Leitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa quando a conexão usa uma chave ak_… (contas ainda não migradas pra V5). As 4 versões legadas compartilham estes endpoints; diferenças de campo entre V1/V2/V3/V4 vêm cruas no payload. Ações: - list_transactions / get_transaction (requer transaction_id) - list_subscriptions / list_plans / list_payables / list_recipients / list_customers / list_transfers - balance: saldo da conta Filtros de lista (count, page, status, …) via data (JSON). [Flattened action: list_recipients] Bulk support: accepts transaction_ids for batched execution. |
| `pagarme_legacy_list_customers` | Leitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa quando a conexão usa uma chave ak_… (contas ainda não migradas pra V5). As 4 versões legadas compartilham estes endpoints; diferenças de campo entre V1/V2/V3/V4 vêm cruas no payload. Ações: - list_transactions / get_transaction (requer transaction_id) - list_subscriptions / list_plans / list_payables / list_recipients / list_customers / list_transfers - balance: saldo da conta Filtros de lista (count, page, status, …) via data (JSON). [Flattened action: list_customers] Bulk support: accepts transaction_ids for batched execution. |
| `pagarme_legacy_list_transfers` | Leitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa quando a conexão usa uma chave ak_… (contas ainda não migradas pra V5). As 4 versões legadas compartilham estes endpoints; diferenças de campo entre V1/V2/V3/V4 vêm cruas no payload. Ações: - list_transactions / get_transaction (requer transaction_id) - list_subscriptions / list_plans / list_payables / list_recipients / list_customers / list_transfers - balance: saldo da conta Filtros de lista (count, page, status, …) via data (JSON). [Flattened action: list_transfers] Bulk support: accepts transaction_ids for batched execution. |
| `pagarme_legacy_balance` | Leitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa quando a conexão usa uma chave ak_… (contas ainda não migradas pra V5). As 4 versões legadas compartilham estes endpoints; diferenças de campo entre V1/V2/V3/V4 vêm cruas no payload. Ações: - list_transactions / get_transaction (requer transaction_id) - list_subscriptions / list_plans / list_payables / list_recipients / list_customers / list_transfers - balance: saldo da conta Filtros de lista (count, page, status, …) via data (JSON). [Flattened action: balance] Bulk support: accepts transaction_ids for batched execution. |

Detalhe de cada tool: [docs/ferramentas.md](https://github.com/mcp-dir/pagarme-mcp/blob/HEAD/docs/ferramentas.md)

---

## Preços

Planos a partir do tier grátis. Veja [docs/precos.md](https://github.com/mcp-dir/pagarme-mcp/blob/HEAD/docs/precos.md).

---

## Privacidade & LGPD

- **Sub-processadores**: Pagar.me (Stone), o LLM host que você escolher (Claude, ChatGPT, Cursor, agente próprio). Lista completa em [docs/privacidade-lgpd.md](https://github.com/mcp-dir/pagarme-mcp/blob/HEAD/docs/privacidade-lgpd.md).
- Os dados retornados pelas tools são enviados ao **LLM host que você escolher**, sub-processador fora do nosso controle. Recomendamos planos com opt-out de treinamento.

---

## Perguntas frequentes

**O servidor é open source?**
O servidor é proprietário (hosted). Este repositório é o wrapper público com manifestos, docs e skills — tudo MIT.

**Posso usar com agente próprio (não Claude/Cursor)?**
Sim — qualquer cliente que suporte MCP over HTTP. URL: `https://api.mcp.ai/p_pagarme`.


---

## Suporte

- 📧 [pagarme@mcp.ai](mailto:pagarme@mcp.ai)
- 🐛 [GitHub Issues](https://github.com/mcp-dir/pagarme-mcp/issues)
- 📄 [docs/](https://github.com/mcp-dir/pagarme-mcp/blob/HEAD/docs/)

---

## Licença

MIT — veja [LICENSE](https://github.com/mcp-dir/pagarme-mcp/blob/HEAD/LICENSE). O servidor MCP em `api.mcp.ai/p_pagarme` é proprietário (hosted); este repositório (manifestos, docs, skills) é MIT.