# Pagar.me — MCP server on 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.

By: mcp.ai · official
Page: https://mcp.ai/pagarme

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_pagarme?ms=1781045820000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/pagarme/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/pagarme/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/pagarme/skill.md
Postman collection (v2.1): https://mcp.ai/pagarme/postman.json

## Tools
- pagarme_cards_delete(customer_id: string, card_id: string, account?: string, customer_ids?: string[], card_ids?: string[]) — Remove um cartão salvo do cliente no Pagar.me V5 (requer customer_id + card_id). Irreversível.
- pagarme_cards_get(customer_id: string, card_id?: string, account?: string, customer_ids?: string[], card_ids?: string[]) — Cartões salvos de um cliente no Pagar.me V5.
- pagarme_cards_list(customer_id: string, card_id?: string, account?: string, customer_ids?: string[], card_ids?: string[]) — Cartões salvos de um cliente no Pagar.me V5.
- pagarme_cards_write_create(customer_id: string, card_id?: string, data?: string, account?: string, customer_ids?: string[], card_ids?: string[]) — Criar/renovar cartões de um cliente no Pagar.me V5 (só sk_; requer customer_id).
- pagarme_cards_write_renew(customer_id: string, card_id?: string, data?: string, account?: string, customer_ids?: string[], card_ids?: string[]) — Criar/renovar cartões de um cliente no Pagar.me V5 (só sk_; requer customer_id).
- pagarme_charges_cancel(charge_id: string, data?: string, account?: string, charge_ids?: string[]) — Cancela/estorna uma cobrança no Pagar.me V5 (requer charge_id; data opcional com amount p/ estorno parcial). Irreversível.
- pagarme_charges_get(charge_id?: string, charge_ids?: string[], page?: number, size?: number, data?: string, account?: string) — Cobranças (charges) no Pagar.me V5.
- pagarme_charges_get_many(charge_id?: string, charge_ids?: string[], page?: number, size?: number, data?: string, account?: string) — Cobranças (charges) no Pagar.me V5.
- pagarme_charges_list(charge_id?: string, charge_ids?: string[], page?: number, size?: number, data?: string, account?: string) — Cobranças (charges) no Pagar.me V5.
- pagarme_charges_summary(charge_id?: string, charge_ids?: string[], page?: number, size?: number, data?: string, account?: string) — Cobranças (charges) no Pagar.me V5.
- pagarme_charges_write_capture(charge_id: string, data?: string, account?: string, charge_ids?: string[]) — Operar cobranças no Pagar.me V5 (só contas sk_; não-destrutivas).
- pagarme_charges_write_confirm(charge_id: string, data?: string, account?: string, charge_ids?: string[]) — Operar cobranças no Pagar.me V5 (só contas sk_; não-destrutivas).
- pagarme_charges_write_retry(charge_id: string, data?: string, account?: string, charge_ids?: string[]) — Operar cobranças no Pagar.me V5 (só contas sk_; não-destrutivas).
- pagarme_charges_write_update_card(charge_id: string, data?: string, account?: string, charge_ids?: string[]) — Operar cobranças no Pagar.me V5 (só contas sk_; não-destrutivas).
- pagarme_charges_write_update_due_date(charge_id: string, data?: string, account?: string, charge_ids?: string[]) — Operar cobranças no Pagar.me V5 (só contas sk_; não-destrutivas).
- pagarme_charges_write_update_payment_method(charge_id: string, data?: string, account?: string, charge_ids?: string[]) — Operar cobranças no Pagar.me V5 (só contas sk_; não-destrutivas).
- pagarme_customers_get(customer_id?: string, address_id?: string, page?: number, size?: number, data?: string, account?: string, customer_ids?: string[], address_ids?: string[]) — Clientes e endereços no Pagar.me V5.
- pagarme_customers_get_address(customer_id?: string, address_id?: string, page?: number, size?: number, data?: string, account?: string, customer_ids?: string[], address_ids?: string[]) — Clientes e endereços no Pagar.me V5.
- pagarme_customers_list(customer_id?: string, address_id?: string, page?: number, size?: number, data?: string, account?: string, customer_ids?: string[], address_ids?: string[]) — Clientes e endereços no Pagar.me V5.
- pagarme_customers_list_addresses(customer_id?: string, address_id?: string, page?: number, size?: number, data?: string, account?: string, customer_ids?: string[], address_ids?: string[]) — Clientes e endereços no Pagar.me V5.
- pagarme_customers_write_create(customer_id?: string, address_id?: string, data?: string, account?: string, customer_ids?: string[], address_ids?: string[]) — Criar/atualizar clientes e endereços no Pagar.me V5 (só sk_).
- pagarme_customers_write_create_address(customer_id?: string, address_id?: string, data?: string, account?: string, customer_ids?: string[], address_ids?: string[]) — Criar/atualizar clientes e endereços no Pagar.me V5 (só sk_).
- pagarme_customers_write_delete_address(customer_id?: string, address_id?: string, data?: string, account?: string, customer_ids?: string[], address_ids?: string[]) — Criar/atualizar clientes e endereços no Pagar.me V5 (só sk_).
- pagarme_customers_write_update(customer_id?: string, address_id?: string, data?: string, account?: string, customer_ids?: string[], address_ids?: string[]) — Criar/atualizar clientes e endereços no Pagar.me V5 (só sk_).
- pagarme_customers_write_update_address(customer_id?: string, address_id?: string, data?: string, account?: string, customer_ids?: string[], address_ids?: string[]) — Criar/atualizar clientes e endereços no Pagar.me V5 (só sk_).
- pagarme_invoices_cancel(invoice_id: string, account?: string, invoice_ids?: string[]) — Cancela uma fatura no Pagar.me V5 (requer invoice_id). Irreversível.
- pagarme_invoices_get(invoice_id?: string, page?: number, size?: number, data?: string, account?: string, invoice_ids?: string[]) — Faturas (invoices) de assinatura no Pagar.me V5.
- pagarme_invoices_list(invoice_id?: string, page?: number, size?: number, data?: string, account?: string, invoice_ids?: string[]) — Faturas (invoices) de assinatura no Pagar.me V5.
- pagarme_invoices_write(invoice_id: string, status: string, account?: string, invoice_ids?: string[]) — Altera o status de uma fatura no Pagar.me V5 (requer invoice_id + status, ex.: 'paid', 'canceled').
- pagarme_legacy_balance(transaction_id?: string, data?: string, account?: string, transaction_ids?: string[]) — Leitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa
- pagarme_legacy_get_transaction(transaction_id?: string, data?: string, account?: string, transaction_ids?: string[]) — Leitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa
- pagarme_legacy_list_customers(transaction_id?: string, data?: string, account?: string, transaction_ids?: string[]) — Leitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa
- pagarme_legacy_list_payables(transaction_id?: string, data?: string, account?: string, transaction_ids?: string[]) — Leitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa
- pagarme_legacy_list_plans(transaction_id?: string, data?: string, account?: string, transaction_ids?: string[]) — Leitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa
- pagarme_legacy_list_recipients(transaction_id?: string, data?: string, account?: string, transaction_ids?: string[]) — Leitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa
- pagarme_legacy_list_subscriptions(transaction_id?: string, data?: string, account?: string, transaction_ids?: string[]) — Leitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa
- pagarme_legacy_list_transactions(transaction_id?: string, data?: string, account?: string, transaction_ids?: string[]) — Leitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa
- pagarme_legacy_list_transfers(transaction_id?: string, data?: string, account?: string, transaction_ids?: string[]) — Leitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa
- pagarme_list_accounts(account?: string) — Lista as contas Pagar.me (chaves) conectadas a este install — id, label e versão (V5 ou legado V1–V4).
- pagarme_orders_get(order_id?: string, order_ids?: string[], page?: number, size?: number, data?: string, account?: string) — Pedidos (orders) no Pagar.me V5.
- pagarme_orders_get_many(order_id?: string, order_ids?: string[], page?: number, size?: number, data?: string, account?: string) — Pedidos (orders) no Pagar.me V5.
- pagarme_orders_list(order_id?: string, order_ids?: string[], page?: number, size?: number, data?: string, account?: string) — Pedidos (orders) no Pagar.me V5.
- pagarme_orders_write_close(order_id?: string, closed?: boolean, data?: string, account?: string, order_ids?: string[]) — Criar/atualizar/fechar pedidos no Pagar.me V5 (só contas sk_).
- pagarme_orders_write_create(order_id?: string, closed?: boolean, data?: string, account?: string, order_ids?: string[]) — Criar/atualizar/fechar pedidos no Pagar.me V5 (só contas sk_).
- pagarme_orders_write_update(order_id?: string, closed?: boolean, data?: string, account?: string, order_ids?: string[]) — Criar/atualizar/fechar pedidos no Pagar.me V5 (só contas sk_).
- pagarme_payables_get(payable_id?: string, page?: number, size?: number, data?: string, account?: string, payable_ids?: string[]) — Recebíveis (payables) no Pagar.me V5.
- pagarme_payables_list(payable_id?: string, page?: number, size?: number, data?: string, account?: string, payable_ids?: string[]) — Recebíveis (payables) no Pagar.me V5.
- pagarme_plans_delete(plan_id: string, account?: string, plan_ids?: string[]) — Remove um plano no Pagar.me V5 (requer plan_id). Irreversível.
- pagarme_plans_get(plan_id?: string, page?: number, size?: number, data?: string, account?: string, plan_ids?: string[]) — Planos de assinatura no Pagar.me V5.
- pagarme_plans_list(plan_id?: string, page?: number, size?: number, data?: string, account?: string, plan_ids?: string[]) — Planos de assinatura no Pagar.me V5.
- pagarme_plans_write_create(plan_id?: string, data?: string, account?: string, plan_ids?: string[]) — Criar/atualizar planos no Pagar.me V5 (só sk_).
- pagarme_plans_write_update(plan_id?: string, data?: string, account?: string, plan_ids?: string[]) — Criar/atualizar planos no Pagar.me V5 (só sk_).
- pagarme_recipients_anticipation_limits(recipient_id?: string, page?: number, size?: number, data?: string, account?: string, recipient_ids?: string[]) — Recebedores (split/marketplace) no Pagar.me V5.
- pagarme_recipients_anticipations(recipient_id?: string, page?: number, size?: number, data?: string, account?: string, recipient_ids?: string[]) — Recebedores (split/marketplace) no Pagar.me V5.
- pagarme_recipients_balance(recipient_id?: string, page?: number, size?: number, data?: string, account?: string, recipient_ids?: string[]) — Recebedores (split/marketplace) no Pagar.me V5.
- pagarme_recipients_default(recipient_id?: string, page?: number, size?: number, data?: string, account?: string, recipient_ids?: string[]) — Recebedores (split/marketplace) no Pagar.me V5.
- pagarme_recipients_get(recipient_id?: string, page?: number, size?: number, data?: string, account?: string, recipient_ids?: string[]) — Recebedores (split/marketplace) no Pagar.me V5.
- pagarme_recipients_list(recipient_id?: string, page?: number, size?: number, data?: string, account?: string, recipient_ids?: string[]) — Recebedores (split/marketplace) no Pagar.me V5.
- pagarme_recipients_transfers(recipient_id?: string, page?: number, size?: number, data?: string, account?: string, recipient_ids?: string[]) — Recebedores (split/marketplace) no Pagar.me V5.
- pagarme_recipients_withdrawals(recipient_id?: string, page?: number, size?: number, data?: string, account?: string, recipient_ids?: string[]) — Recebedores (split/marketplace) no Pagar.me V5.
- pagarme_recipients_write_create(recipient_id?: string, data?: string, account?: string, recipient_ids?: string[]) — Criar/operar recebedores no Pagar.me V5 (só sk_).
- pagarme_recipients_write_create_anticipation(recipient_id?: string, data?: string, account?: string, recipient_ids?: string[]) — Criar/operar recebedores no Pagar.me V5 (só sk_).
- pagarme_recipients_write_create_withdrawal(recipient_id?: string, data?: string, account?: string, recipient_ids?: string[]) — Criar/operar recebedores no Pagar.me V5 (só sk_).
- pagarme_recipients_write_update(recipient_id?: string, data?: string, account?: string, recipient_ids?: string[]) — Criar/operar recebedores no Pagar.me V5 (só sk_).
- pagarme_recipients_write_update_bank_account(recipient_id?: string, data?: string, account?: string, recipient_ids?: string[]) — Criar/operar recebedores no Pagar.me V5 (só sk_).
- pagarme_subscriptions_cancel(subscription_id: string, data?: string, account?: string, subscription_ids?: string[]) — Cancela uma assinatura no Pagar.me V5 (requer subscription_id; data opcional: { cancel_pending_invoices }). Irreversível.
- pagarme_subscriptions_cycles(subscription_id?: string, item_id?: string, page?: number, size?: number, data?: string, account?: string, subscription_ids?: string[], item_ids?: string[]) — Assinaturas no Pagar.me V5.
- pagarme_subscriptions_get(subscription_id?: string, item_id?: string, page?: number, size?: number, data?: string, account?: string, subscription_ids?: string[], item_ids?: string[]) — Assinaturas no Pagar.me V5.
- pagarme_subscriptions_items(subscription_id?: string, item_id?: string, page?: number, size?: number, data?: string, account?: string, subscription_ids?: string[], item_ids?: string[]) — Assinaturas no Pagar.me V5.
- pagarme_subscriptions_list(subscription_id?: string, item_id?: string, page?: number, size?: number, data?: string, account?: string, subscription_ids?: string[], item_ids?: string[]) — Assinaturas no Pagar.me V5.
- pagarme_subscriptions_usages(subscription_id?: string, item_id?: string, page?: number, size?: number, data?: string, account?: string, subscription_ids?: string[], item_ids?: string[]) — Assinaturas no Pagar.me V5.
- pagarme_subscriptions_write_add_item(subscription_id?: string, item_id?: string, data?: string, account?: string, subscription_ids?: string[], item_ids?: string[]) — Criar/operar assinaturas no Pagar.me V5 (só sk_; não-destrutivas).
- pagarme_subscriptions_write_add_usage(subscription_id?: string, item_id?: string, data?: string, account?: string, subscription_ids?: string[], item_ids?: string[]) — Criar/operar assinaturas no Pagar.me V5 (só sk_; não-destrutivas).
- pagarme_subscriptions_write_create(subscription_id?: string, item_id?: string, data?: string, account?: string, subscription_ids?: string[], item_ids?: string[]) — Criar/operar assinaturas no Pagar.me V5 (só sk_; não-destrutivas).
- pagarme_subscriptions_write_update_billing_date(subscription_id?: string, item_id?: string, data?: string, account?: string, subscription_ids?: string[], item_ids?: string[]) — Criar/operar assinaturas no Pagar.me V5 (só sk_; não-destrutivas).
- pagarme_subscriptions_write_update_card(subscription_id?: string, item_id?: string, data?: string, account?: string, subscription_ids?: string[], item_ids?: string[]) — Criar/operar assinaturas no Pagar.me V5 (só sk_; não-destrutivas).
- pagarme_subscriptions_write_update_payment_method(subscription_id?: string, item_id?: string, data?: string, account?: string, subscription_ids?: string[], item_ids?: string[]) — Criar/operar assinaturas no Pagar.me V5 (só sk_; não-destrutivas).
- pagarme_transfers_get(transfer_id?: string, page?: number, size?: number, data?: string, account?: string, transfer_ids?: string[]) — Transferências no Pagar.me V5.
- pagarme_transfers_list(transfer_id?: string, page?: number, size?: number, data?: string, account?: string, transfer_ids?: string[]) — Transferências no Pagar.me V5.
- pagarme_transfers_write(data: string, account?: string) — Cria uma transferência no Pagar.me V5 (só sk_). data = JSON do corpo (amount, recipient_id, …).

## 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?"

## Links
Docs: https://mcp.ai/docs/mcps/pagarme
Website: https://mcp.ai/mcps/pagarme