What is Pagar.me MCP?

It's an MCP (Model Context Protocol) server that connects Pagar.me to your AI, giving the agent tools to act on your data, through a single remote link.

Which AI clients does it work with?

Any MCP-compatible client: Claude (web, desktop and mobile), Cursor, ChatGPT with connectors, OpenClaw and other agents.

No. Paste the remote URL into your client, authenticate once, and you're done. No packages to install, no code to write.

Is it secure? Can the AI change my data?

Access is authorized by you and can be revoked anytime. Permissions follow what Pagar.me exposes; you approve them when connecting.

Is my customers' data stored on mcp.ai?

No. Whatever Pagar.me returns passes through our infrastructure solely to reach the AI assistant you chose, and that content is not stored. By design we don't persist tool-call payloads: the log keeps metadata only (which tool, timestamp, status, duration, size and a hash of the arguments). Your credentials are stored encrypted and you can revoke the connection at any time. Retention periods and details are in the Privacy Policy at mcp.ai/privacy.

Is my data used to train AI models?

No. Nothing that flows through the connector is used to train or improve AI models, nor shared with third parties for that purpose. The conversation itself, meaning your prompts and the AI's answers, is processed by the AI provider you choose (Claude, ChatGPT and the like), under their own privacy policy.

How much does it cost?

You start free and upgrade when you need more usage. Billing and limits are managed in your mcp.ai account.

Can I cancel anytime?

Yes. Plans are monthly and can be cancelled at any time, with no lock-in.

Pagar.me MCP Server and REST API

Pagar.me

Stone's payments gateway (api.pagar.me), orders, charges (card, Pix, boleto), customers and cards, plans and subscriptions, recipients (split/marketplace), transfers, payables and invoices, via the official V5 API. Works across all versions: an sk_… key uses the V5 API (read + write); legacy accounts (ak_… key) get read access to the V1–V4 API (transactions, subscriptions, payables, balance). Auth via secret key generated in the dashboard → Settings → Keys.

Install in your client

MCP server URL

https://api.mcp.ai/p_pagarme

Secure connection via OAuth 2.0

Tools (80)

For developers

API & agent docs

Machine-readable docs to plug this server into an agent or call it over REST.

Skill (how to use)

Markdown: use via MCP or via the direct REST API.

Open

llms.txt

Agent-readable spec of this server.

Open

For agents

Install prompt — paste into Claude, ChatGPT, Cursor or any MCP agent and it sets itself up.

Open

Postman collection

Import the REST API into Postman.

Download

FAQ

Pagar.me

Tools (80)

API & agent docs

Frequently asked questions

Example prompts

Pagar.me

Tools (80)

pagarme_cards_deleteRemove um cartão salvo do cliente no Pagar.me V5 (requer customer_id + card_id). Irreversível.

pagarme_cards_getCartões salvos de um cliente no Pagar.me V5.

pagarme_cards_listCartões salvos de um cliente no Pagar.me V5.

pagarme_cards_write_createCriar/renovar cartões de um cliente no Pagar.me V5 (só sk_; requer customer_id).

pagarme_cards_write_renewCriar/renovar cartões de um cliente no Pagar.me V5 (só sk_; requer customer_id).

pagarme_charges_cancelCancela/estorna uma cobrança no Pagar.me V5 (requer charge_id; data opcional com amount p/ estorno parcial). Irreversível.

pagarme_charges_getCobranças (charges) no Pagar.me V5.

pagarme_charges_get_manyCobranças (charges) no Pagar.me V5.

pagarme_charges_listCobranças (charges) no Pagar.me V5.

pagarme_charges_summaryCobranças (charges) no Pagar.me V5.

pagarme_charges_write_captureOperar cobranças no Pagar.me V5 (só contas sk_; não-destrutivas).

pagarme_charges_write_confirmOperar cobranças no Pagar.me V5 (só contas sk_; não-destrutivas).

pagarme_charges_write_retryOperar cobranças no Pagar.me V5 (só contas sk_; não-destrutivas).

pagarme_charges_write_update_cardOperar cobranças no Pagar.me V5 (só contas sk_; não-destrutivas).

pagarme_charges_write_update_due_dateOperar cobranças no Pagar.me V5 (só contas sk_; não-destrutivas).

pagarme_charges_write_update_payment_methodOperar cobranças no Pagar.me V5 (só contas sk_; não-destrutivas).

pagarme_customers_getClientes e endereços no Pagar.me V5.

pagarme_customers_get_addressClientes e endereços no Pagar.me V5.

pagarme_customers_listClientes e endereços no Pagar.me V5.

pagarme_customers_list_addressesClientes e endereços no Pagar.me V5.

pagarme_customers_write_createCriar/atualizar clientes e endereços no Pagar.me V5 (só sk_).

pagarme_customers_write_create_addressCriar/atualizar clientes e endereços no Pagar.me V5 (só sk_).

pagarme_customers_write_delete_addressCriar/atualizar clientes e endereços no Pagar.me V5 (só sk_).

pagarme_customers_write_updateCriar/atualizar clientes e endereços no Pagar.me V5 (só sk_).

pagarme_customers_write_update_addressCriar/atualizar clientes e endereços no Pagar.me V5 (só sk_).

pagarme_invoices_cancelCancela uma fatura no Pagar.me V5 (requer invoice_id). Irreversível.

pagarme_invoices_getFaturas (invoices) de assinatura no Pagar.me V5.

pagarme_invoices_listFaturas (invoices) de assinatura no Pagar.me V5.

pagarme_invoices_writeAltera o status de uma fatura no Pagar.me V5 (requer invoice_id + status, ex.: 'paid', 'canceled').

pagarme_legacy_balanceLeitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa

pagarme_legacy_get_transactionLeitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa

pagarme_legacy_list_customersLeitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa

pagarme_legacy_list_payablesLeitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa

pagarme_legacy_list_plansLeitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa

pagarme_legacy_list_recipientsLeitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa

pagarme_legacy_list_subscriptionsLeitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa

pagarme_legacy_list_transactionsLeitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa

pagarme_legacy_list_transfersLeitura da API LEGADA V1–V4 do Pagar.me (modelo "transactions"). Ativa

pagarme_list_accountsLista as contas Pagar.me (chaves) conectadas a este install — id, label e versão (V5 ou legado V1–V4).

pagarme_orders_getPedidos (orders) no Pagar.me V5.

pagarme_orders_get_manyPedidos (orders) no Pagar.me V5.

pagarme_orders_listPedidos (orders) no Pagar.me V5.

pagarme_orders_write_closeCriar/atualizar/fechar pedidos no Pagar.me V5 (só contas sk_).

pagarme_orders_write_createCriar/atualizar/fechar pedidos no Pagar.me V5 (só contas sk_).

pagarme_orders_write_updateCriar/atualizar/fechar pedidos no Pagar.me V5 (só contas sk_).

pagarme_payables_getRecebíveis (payables) no Pagar.me V5.

pagarme_payables_listRecebíveis (payables) no Pagar.me V5.

pagarme_plans_deleteRemove um plano no Pagar.me V5 (requer plan_id). Irreversível.

pagarme_plans_getPlanos de assinatura no Pagar.me V5.

pagarme_plans_listPlanos de assinatura no Pagar.me V5.

pagarme_plans_write_createCriar/atualizar planos no Pagar.me V5 (só sk_).

pagarme_plans_write_updateCriar/atualizar planos no Pagar.me V5 (só sk_).

pagarme_recipients_anticipation_limitsRecebedores (split/marketplace) no Pagar.me V5.

pagarme_recipients_anticipationsRecebedores (split/marketplace) no Pagar.me V5.

pagarme_recipients_balanceRecebedores (split/marketplace) no Pagar.me V5.

pagarme_recipients_defaultRecebedores (split/marketplace) no Pagar.me V5.

pagarme_recipients_getRecebedores (split/marketplace) no Pagar.me V5.

pagarme_recipients_listRecebedores (split/marketplace) no Pagar.me V5.

pagarme_recipients_transfersRecebedores (split/marketplace) no Pagar.me V5.

pagarme_recipients_withdrawalsRecebedores (split/marketplace) no Pagar.me V5.

pagarme_recipients_write_createCriar/operar recebedores no Pagar.me V5 (só sk_).

pagarme_recipients_write_create_anticipationCriar/operar recebedores no Pagar.me V5 (só sk_).

pagarme_recipients_write_create_withdrawalCriar/operar recebedores no Pagar.me V5 (só sk_).

pagarme_recipients_write_updateCriar/operar recebedores no Pagar.me V5 (só sk_).

pagarme_recipients_write_update_bank_accountCriar/operar recebedores no Pagar.me V5 (só sk_).

pagarme_subscriptions_cancelCancela uma assinatura no Pagar.me V5 (requer subscription_id; data opcional: { cancel_pending_invoices }). Irreversível.

pagarme_subscriptions_cyclesAssinaturas no Pagar.me V5.

pagarme_subscriptions_getAssinaturas no Pagar.me V5.

pagarme_subscriptions_itemsAssinaturas no Pagar.me V5.

pagarme_subscriptions_listAssinaturas no Pagar.me V5.

pagarme_subscriptions_usagesAssinaturas no Pagar.me V5.

pagarme_subscriptions_write_add_itemCriar/operar assinaturas no Pagar.me V5 (só sk_; não-destrutivas).

pagarme_subscriptions_write_add_usageCriar/operar assinaturas no Pagar.me V5 (só sk_; não-destrutivas).

pagarme_subscriptions_write_createCriar/operar assinaturas no Pagar.me V5 (só sk_; não-destrutivas).

pagarme_subscriptions_write_update_billing_dateCriar/operar assinaturas no Pagar.me V5 (só sk_; não-destrutivas).

pagarme_subscriptions_write_update_cardCriar/operar assinaturas no Pagar.me V5 (só sk_; não-destrutivas).

pagarme_subscriptions_write_update_payment_methodCriar/operar assinaturas no Pagar.me V5 (só sk_; não-destrutivas).

pagarme_transfers_getTransferências no Pagar.me V5.