Vinkius

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.

Mercado Pago MCP is compatible with Claude Claude
Mercado Pago MCP is compatible with ChatGPT ChatGPT
Mercado Pago MCP is compatible with Cursor Cursor
Mercado Pago MCP is compatible with Gemini Gemini
Mercado Pago MCP is compatible with Windsurf Windsurf
Mercado Pago MCP is compatible with VS Code VS Code
Mercado Pago MCP is compatible with JetBrains JetBrains
Mercado Pago MCP is compatible with Vercel Vercel
See Vinkius in Action

Give Claude and any AI agent real-world access

Generate Instant Pix Payments

Creates the necessary QR code data for customers to pay immediately using Brazil's popular Pix system.

Process Credit Card Transactions

Charges various cards (Visa, Mastercard, Elo) securely, handling payment details and generating checkout links.

Manage Customer Data

Registers new users and saves their card information to facilitate quick, repeat payments.

Issue Refunds

Processes full or partial refunds on any completed payment using the transaction ID.

Track Payments

Searches and retrieves detailed records of past payments using criteria like customer email or status.

Waiting for input…

AI Agent
Mercado Pago

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 MCP

Create 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.

Mercado Pago MCP is compatible with Claude

Claude AI

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.

2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.

3

Start a conversation

Open a new chat. The Mercado Pago integration is available immediately — no restart needed.

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
Start building

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
Mercado Pago MCP server cover

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

Your data is protected. See how we built it.

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.

Built · Hosted · Managed by Vinkius Mercado Pago - Process Payments & Refunds via AI
Server ID 019d75d2-9be1-727a-926b-b02ccda689c1
Vinkius Inspector
Compliance Grade A+
Score 100/100
Vinkius Inspector Badge — Score 100/100

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.