Pagar.me MCP. Process Brazilian payments and billing flows from chat.

Pagar.me connects your AI client directly to Brazil’s payment infrastructure. You use this server when you need to handle everything financial—from registering a customer to capturing funds and setting up monthly billing cycles—all through natural conversation with your agent.

When you're getting an order processed, you can first register local customers by calling create_customer, using their Brazilian tax ID either as a CPF or CNPJ. Once that record exists, you’ve got options for generating the sale. You can generate a standard order requiring product details and an existing customer record using create_order.

If the payment needs to be handled with a credit card, create_order handles it. For instant payments, use create_pix_order; this generates an order that requires Pix payment and includes a one-hour expiration window for quick capture. If you need them to pay via bank slip instead, call create_boleto_order, generating an order specifically designed for Boleto Bancário.

After the customer makes a payment, you have control over the funds. You finalize an authorized order—meaning the money is held but not yet taken—by executing capture_order. If something goes sideways and you need to completely void the transaction before capturing funds, you call cancel_order to cancel that specific order record.

For ongoing revenue streams, you don't have to deal with manual invoices. You set up continuous billing cycles by calling create_subscription, which establishes recurring payments for an existing customer on a defined plan. You can later check the status of these automated charges using get_subscription to retrieve all the billing details.

When tracking down what's happening with money, you have full visibility into the transaction history. Use list_orders when you want a quick overview of multiple recent transactions, giving you an immediate picture of your sales flow. If you only need details on one specific purchase, calling get_order fetches all the current status and payment methods for that order ID.

Similarly, if you're checking up on a customer’s details or needing to verify their account information, you use get_customer. Finally, if you just want the billing specifics of any subscription you set up, you check those records with get_subscription.

It's all about managing the full lifecycle. You get the payment method ready—whether it’s a credit card, Pix, or Boleto. You establish the customer record using their CPF or CNPJ. You create and manage the order via create_order, create_pix_order, or create_boleto_order. You handle the recurring revenue with create_subscription, while always maintaining control to capture funds with capture_order or void things entirely using cancel_order.

All of this happens through direct, programmatic calls to Pagar.me's tools.