Pagar.me MCP. Manage orders and subscriptions in Brazilian currency.
Pagar.me connects your AI agent to Brazil's payments system. Create orders using Pix, Boleto, or credit cards, manage recurring customer subscriptions, and track all transactions through natural conversation. Handle complex Brazilian financial flows without leaving your chat interface.
Give Claude and any AI agent real-world access
The system creates an immediate payment order and generates the necessary QR code.
You can create new orders using traditional credit cards or generating a specific Boleto Bancário payment slip.
The MCP sets up and updates subscription plans for existing customers.
You can register new people or retrieve detailed history for established accounts using their CPF or CNPJ.
The agent retrieves specific details on any existing order, letting you know if it's paid, pending, or canceled.
Ask an AI about this
Waiting for input…
What AI agents can do with Pagar.me: Payment & Order Mgmt with 11 Tools
These tools allow your agent to execute specific financial actions, from creating customer records to generating instant payment codes.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Pagar.me MCPCreate Boleto Order
Creates a new order that requires payment using the Boleto method.
Cancel Order
Marks an existing order as canceled in the system.
Capture Order
Finalizes a previously authorized order, capturing the funds.
Create Customer
Registers a new user account using their CPF or CNPJ identifiers.
Get Customer
Retrieves all relevant details about an existing customer profile.
Get Order
Fetches the full details, including items and payment status, for one specific order number.
Get Subscription
Retrieves current billing cycle information for a customer's subscription plan.
List Orders
Lists the most recent orders processed through the gateway, giving you an overview...
Create Order
Generates a new order that accepts payments via credit card or custom payment...
Create Pix Order
Creates an urgent, time-sensitive order specifically for immediate Pix payments.
Create Subscription
Sets up a continuous billing cycle, defining the recurring plan for a customer.
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on each call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Pagar.me, then connect any of our 5,200+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,200+ others, all in one place
- Add new capabilities to your AI anytime you want
- Connections are secured and governed automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog weekly
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Pagar.me. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS CLOUD
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on each call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Dealing with Brazilian Payments Feels Like a Chore
Today, setting up an order requires jumping between your CRM, the payments portal, and sometimes even emailing a payment slip to accounting. You have to copy transaction IDs, manually calculate due dates for Boleto, and check statuses in five different tabs just to confirm if money actually moved.
With this MCP, those manual jumps disappear. Your agent handles it all: you ask it to generate an order, specify the payment method—whether that's a credit card or a custom Pix code—and get confirmation immediately. It keeps the entire flow conversational and contained.
Pagar.me MCP Gives You Complete Control Over Money Movement
You no longer need to separately track customer details, then go back to create an order, and finally use a separate tool just to check the status. The agent links these actions: it can first call create_customer, then create_order, and finally retrieve all necessary payment information using get_order.
The result is financial automation that flows naturally with your conversation. It’s not just about connecting an API; it's about making complex finance management feel simple.
What Pagar.me MCP does for your AI
Need to process sales in Brazil? This MCP lets you connect your payment processing directly into your AI client. You can initiate orders for any item using multiple methods like Pix, Boleto, or a credit card. Need recurring revenue? Set up and manage customer subscriptions right from the conversation. It also handles core tasks like registering new customers and listing past transactions to keep your records clean.
By connecting Pagar.me through Vinkius, you give your agent access to deep payment infrastructure. Your client can now track order status or create an instant Pix QR code—all without needing a web login. It’s about giving your AI workflow the financial muscle it needs for the Brazilian market.
019d75ee-05c0-734c-961c-69ba8d6e49ad How to set up Pagar.me MCP
The bottom line is that you get to manage complex sales and financial processes using simple chat commands, keeping everything contained in your AI workflow.
Subscribe to this MCP and provide your Pagar.me Secret Key in the Vinkius catalog.
Your AI client sends a natural language request (e.g., 'Create a Pix order for R$100').
The MCP executes the payment flow, generating confirmation or necessary codes directly within the conversation.
Who uses Pagar.me MCP
E-commerce managers running operations in Brazil. SaaS founders who need automated billing cycles. Any developer building an AI agent that must handle real money transactions.
They use the MCP to automatically create and renew customer subscriptions based on service usage, ensuring consistent revenue capture.
They manage the full sales cycle by generating orders via Pix or Boleto, checking payment status, and resolving transaction disputes without logging into a separate dashboard.
They connect the MCP to complex AI workflows to handle multi-step financial processes, like first creating a customer record and then generating an order for them.
Benefits of connecting Pagar.me MCP
Process payments immediately through Pix or Boleto directly from your agent, removing the need for manual QR code generation outside of the chat.
Handle complex billing lifecycles by using create_subscription to set up recurring revenue streams, which is crucial for any SaaS model.
Keep track of everything with list_orders and get_order. You can query transaction history and status checks in one conversational step.
Build customer records accurately using create_customer, ensuring your agent always has the proper CPF or CNPJ data before placing an order.
The ability to capture funds using capture_order means you can authorize a sale now and take the money later when all conditions are met.
Pagar.me MCP use cases
Fulfilling a new client payment
A sales agent needs to onboard a new client. Instead of sending them a link, they ask their AI agent: 'Create an order for 3 months using the subscription tool and pay with a credit card.' The agent executes create_subscription and create_order in one go.
Handling bulk transaction checks
The ops team needs to know if payments went through yesterday. They simply ask their AI client: 'Show me the last 5 orders.' The agent uses list_orders and provides a formatted summary of payment statuses.
Troubleshooting an expired payment
A customer reports that a Boleto they paid never registered. The support agent asks: 'What is the status of order #987?' The agent uses get_order to confirm if the transaction was successful or expired.
Automating product launches
The marketing team wants to launch a limited-time sale. They instruct their AI agent: 'Generate an order for R$100 using create_pix_order.' The system instantly provides the payment details needed.
Pagar.me MCP tradeoffs
What to watch out for, and the recommended way to handle each one.
Using Pagar.me only for initial payments
Just running create_order and assuming the sale is final. This leaves you vulnerable if the customer doesn't pay or needs to cancel.
Always sequence your calls: first, use create_order; then, wait for confirmation; finally, execute capture_order only when payment is confirmed.
Manually managing subscriptions
Having a spreadsheet and updating dates or plan changes manually. This is slow, error-prone, and misses potential revenue.
Use create_subscription to automate the billing start. Then, periodically use get_subscription to verify status and next payment date.
Ignoring customer data requirements
Trying to place an order without knowing who the buyer is or if they are a new user. The transaction will fail later.
Always start by using create_customer first, capturing their CPF/CNPJ details, before attempting any major payment action.
When to use Pagar.me MCP
Use this MCP if your primary business function is e-commerce or SaaS billing within Brazil. You need to initiate payments via Pix, Boleto, or credit card; you manage recurring subscriptions; and you must interact with these tools using natural conversation rather than a web portal.
Don't use it if you only process refunds (use dedicated refund APIs instead), or if your primary market is outside of Brazil. If all you need is to read data without initiating payments, then simply listing orders might be enough, but this MCP gives you the full write access needed for money movement.
Frequently asked questions about Pagar.me MCP
How do I get my Secret Key? +
Log in to the Pagar.me dashboard, navigate to Settings > API Keys and copy your Secret Key (starts with sk_...). No complex OAuth apps, no webhooks — just connect and start processing payments.
Does it support Pix and Boleto? +
Yes! Generate instant Pix QR Codes or Boletos right in the chat. Your agent handles the entire checkout flow — creating the order, retrieving the payment code, and allowing the customer to pay without ever leaving the conversation.
Can I manage subscriptions? +
Yes. Just tell your AI agent to subscribe a new customer. It will register the customer, attach them to your predefined SaaS recurring plan, and confirm the active billing status — all in a single prompt without touching a dashboard.
Can I manage complete customer profiles and track their transaction histories? +
Absolutely. View detailed customer records, pull entire order histories, and verify payment statuses instantly — perfect for SaaS founders, customer support teams, and digital agencies handling multiple accounts.