Mercado Pago MCP. Charge cards, generate Pix codes, and manage refunds instantly.
Mercado Pago connects your AI agent directly to Brazil’s top payment gateway. You can generate instant Pix QR codes, securely charge credit cards (Visa, Mastercard), handle customer records, and issue full or partial refunds—all from a natural conversation with zero manual dashboard clicks.
Give Claude and any AI agent real-world access
Creates the necessary QR code data for customers to pay immediately using Brazil's popular Pix system.
Charges various cards (Visa, Mastercard, Elo) securely, handling payment details and generating checkout links.
Registers new users and saves their card information to facilitate quick, repeat payments.
Processes full or partial refunds on any completed payment using the transaction ID.
Searches and retrieves detailed records of past payments using criteria like customer email or status.
Ask an AI about this
Waiting for input…
What AI agents can do with Mercado Pago: 12 Tools for Financial Ops
Use these tools to handle the full spectrum of financial tasks, from generating instant payment QR codes to managing customer records and issuing accurate refunds.
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 Mercado Pago MCPCreate Card
Saves a customer's payment details so the card can be used for future payments.
Create Customer
Registers an entirely new user account within the Mercado Pago system.
Create Payment
Processes a payment using card details or other methods for immediate charges.
Create Preference
Generates a secure, temporary link that customers can use to complete an online...
Get Customer
Retrieves specific details about an existing customer account.
Get Payment
Fetches all detailed information for a single payment using its unique ID.
Get Preference
Retrieves the current details of a generated checkout link or preference.
Get Identification Types
Lists all valid identification formats used in Brazil, such as CPF and CNPJ.
List Payment Methods
Shows every payment method currently accepted by the gateway in Brazil.
Create Pix Payment
Generates a unique QR code and associated data for an instant Pix payment request.
Refund Payment
Initiates a refund, allowing you to partially or fully return funds on a completed...
Search Payments
Searches across all transactions using filters like email address, status, or ID for reconciliation.
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 Mercado Pago, 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 Mercado Pago. 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
Tracking down lost money after a sale is always a headache.
Right now, when something goes wrong—a customer says their charge failed or they just can't find yesterday's payment receipt—you have to jump through hoops. You log into the portal, search by email in one tab, check status codes in another, and then copy-paste IDs between five different screens just to piece together what happened.
With this MCP, your agent does the legwork for you. Instead of clicking around, you simply ask: 'Show me all approved payments from user@email.com.' You get a clear, actionable list right back in chat, letting you confirm payment details or identify exactly which transactions need attention.
Creating secure checkout links with Mercado Pago MCP
Before this, setting up a web checkout usually meant hardcoding the payment gateway API call directly into your site's backend code. You had to manage tokens and redirection logic manually every time you needed a new link.
Now, you just ask for it. The agent uses create_preference to generate that secure, ready-to-use payment link instantly. It takes away the entire process of manual API configuration.
What Mercado Pago MCP does for your AI
Need to manage sales in Brazil? This MCP connects your AI agent to Mercado Pago, letting you run the entire financial workflow through simple chat commands. You can create instant Pix payments by generating scannable QR codes for the customer, or process traditional charges using credit cards like Visa and Mastercard.
It handles more than just charging: you can register new customers and save their card details for one-click reorders. Need to fix an order? Simply trigger a refund, partial or full. Furthermore, if a transaction fails or you need reporting, you don't have to guess; the MCP allows you to search for specific payments using filters like email address or status.
By connecting this capability through Vinkius, your AI client gets immediate access to Brazil’s leading payment tools. This means e-commerce managers and small business owners can run their entire finance stack—from capturing customer data to issuing refunds—without ever touching a developer console.
019d75d2-9be1-727a-926b-b02ccda689c1 How to set up Mercado Pago MCP
The bottom line is that your AI client acts as a direct financial worker, handling payment logic without you writing any boilerplate code.
First, subscribe to this MCP and provide your unique Mercado Pago Access Token.
Next, tell your AI client exactly what payment action you need—for example, 'Generate a Pix QR code for R$150.'
Finally, the agent executes the request using the integrated tools and returns confirmation details or data.
Who uses Mercado Pago MCP
This MCP is built for anyone who handles money flow in an e-commerce setting. If you're tired of manually logging into multiple dashboards to track failed payments or generate refund codes, this is for you.
Managing daily sales requires issuing refunds and checking payment status quickly so that customer service doesn't stall.
Needs to integrate local Brazilian payment methods like Pix into an AI-driven workflow without building the entire API layer from scratch.
Generates simple web checkout links and tracks all transactions directly through chat when managing sales remotely.
Benefits of connecting Mercado Pago MCP
Start checking payment status right away. Instead of navigating multiple screens to reconcile sales, you can use the search_payments tool to find all transactions by email or ID in one prompt.
Handle cash-flow issues without delay. If a customer needs a partial credit, simply calling refund_payment lets your agent issue it instantly, logging the transaction details for accounting.
Speed up checkouts dramatically. You can use create_pix_payment to generate QR codes on demand, enabling instant payments that don't rely on card processing.
Improve customer data integrity. When a user signs up or makes an order, you can use create_customer and create_card to save their details securely for future one-click purchases.
Build checkout flows easily. Instead of hardcoding payment logic, you can use create_preference to generate dynamic links that redirect customers to the correct payment portal.
Mercado Pago MCP use cases
Handling a Failed Payment
A customer calls because their card was declined. Instead of making them manually repeat all details, you ask your agent to search_payments using their email address to find the last successful transaction and then use create_card to save their billing info for a quick retry.
Processing Bulk Returns
Your warehouse manager needs to issue refunds for 10 items sold yesterday. You tell your agent, which uses refund_payment, to process the full or partial returns across multiple payment IDs without needing to open ten different screens.
Setting up a New Sales Channel
A small business owner needs to accept payments from an online partner. They ask their agent to use create_preference, which generates the necessary secure checkout link for immediate deployment across the web.
Reconciling Daily Sales
It's end of day and you need a report on all successful transactions from the last 24 hours. You instruct your agent to search_payments, filtering by status 'approved', pulling together all necessary payment IDs.
Mercado Pago MCP tradeoffs
What to watch out for, and the recommended way to handle each one.
Assuming Payment Success
A developer writes code that assumes a charge worked and moves on. They never check the status, leading to lost revenue because they didn't confirm payment.
Always use search_payments or get_payment after initiating a transaction. This confirms the final status and prevents failed payments from being treated as successful.
Forgetting Pix Payments
The system only handles card charges, ignoring local payment methods. The business loses access to customers who prefer instant QR code payments.
Use create_pix_payment whenever a customer opts for an immediate, non-card method of payment in Brazil.
Recreating Customer Data
Every time a user orders something, the system prompts them to re-enter their full name and card number. This is bad UX and adds friction.
Use create_customer first, then create_card. The MCP saves this data, allowing you to reference saved details for one-click payments.
When to use Mercado Pago MCP
You should use this MCP if your core business function revolves around accepting money or managing the lifecycle of a payment in Brazil. Specifically, if you need to charge cards (create_payment), manage local Pix methods (create_pix_payment), or handle post-sale adjustments like refunds (refund_payment). Don't use this if your primary task is inventory management, user profile creation unrelated to billing, or complex reporting that doesn't involve transaction IDs. If you only need a simple contact list, look at general database connectors; if you need payment processing, stick with the tools here.
Frequently asked questions about Mercado Pago MCP
How do I use Mercado Pago with Pix payments? +
You initiate a Pix transaction using create_pix_payment. The MCP returns QR code data that you can give to the customer, enabling instant payment without relying on credit cards.
Can I refund payments if they were made with Pix? +
Yes. You use the refund_payment tool and provide the original payment ID. The MCP handles the refund process regardless of whether the initial payment method was a card or Pix.
Do I need to know the customer's email when searching payments? +
No, but it helps. You can use search_payments with various filters, including ID, status (like 'pending'), or even just a date range, so you don't have to guess what information you have.
What is the difference between create_payment and create_preference? +
create_payment charges a card immediately. create_preference generates a secure link that directs the user to an external page where they can complete the payment themselves.
How do I save customer cards using Mercado Pago MCP? +
You use the create_customer tool first, then use create_card. This saves their details securely within the system for future one-click transactions.