Mercado Pago Connector for AI agents.

Q: How do I get a Mercado Pago Access Token?

Go to your Mercado Pago account, navigate to Developers > Your Integrations > Production Credentials (or Sandbox), and copy your Access Token. It starts with 'APPUSR-' for production.

Q: Can I generate Pix payments?

Yes! Use the createpixpayment action. It generates a Pix transaction and returns QR Code data that can be displayed for the payer to scan and pay instantly.

12 live capabilities

Manage Brazilian payments and Pix QR codes through your chat.

Live agent request Mercado Pago / Connector

Waiting for input…

AI Agent

Why people use Mercado Pago

Mercado Pago for Ending Manual Refund Entry

With this Connector, you can handle the entire refund lifecycle through your AI client. Just tell your agent to issue a refund, and it uses refund_payment to get it done. You get the confirmation immediately without ever leaving your conversation.

What Vinkius changes

You can manage your entire Brazilian payment lifecycle through a conversation instead of a dashboard.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 5,900+ Connectors

Real-world use case 01

Sending a quick Pix link

A shop owner needs to collect payment.
Real-world use case 02

Processing a customer refund

A customer requests a return.
Real-world use case 03

Registering a new buyer

A new customer wants to save their info.

Complete set · 12capabilities

The complete Mercado Pago capability set.

These are the exact actions your AI can choose when you ask it to work with Mercado Pago.

Capability set01 / 03

01—04

4 capabilities in this set.

Part of 12 available through Mercado Pago.

01 Capability
Create card
Save a customer's card to your account. This allows for faster one-click payments in future transactions.
02 Capability
Create customer
Register a new customer profile. This keeps your buyer data organized and accessible.
03 Capability
Create payment
Process a transaction using a card token. This handles various card networks like Visa and Mastercard.
04 Capability
Create preference
Generate a unique checkout link. You can send this to customers for external web redirects.

Capability set02 / 03

05—08

4 capabilities in this set.

Part of 12 available through Mercado Pago.

05 Capability
Get customer
Retrieve specific details for a registered customer. This helps you quickly look up profile information.
06 Capability
Get payment
Get the status and details of a specific payment. Use this to check if a transaction was successful.
07 Capability
Get preference
Fetch the details of a specific checkout preference. This is useful for verifying redirect links.
08 Capability
Create pix payment
Generate a QR code for instant Pix payments. This allows customers to scan and pay immediately.

Capability set03 / 03

09—12

4 capabilities in this set.

Part of 12 available through Mercado Pago.

09 Capability
Refund payment
Process a full or partial refund for a transaction. This handles returns without manual dashboard navigation.
10 Capability
Search payments
Filter through your transaction history. This is perfect for reconciling payments by email or ID.
11 Capability
Get identification types
List valid identification types like CPF or CNPJ. Use this to ensure correct customer registration.
12 Capability
List payment methods
Show all available payment methods in Brazil. This helps you see what options your customers can use.

Set up in minutes

One URL. Then ask Mercado Pago to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Mercado Pago from the conversation.

Choose your client

Live preview

Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_Mx4Sw13BkVSyvhTG9vcHJTm07zdH5PNyBe4399ul/mcp

Step 01

Open Connectors

In Claude Web or Claude Desktop, open Settings and choose Connectors.
Step 02

Add the URL

Choose Add custom connector, name it Mercado Pago, and paste the URL above.
Step 03

Turn it on in chat

Select +, open Connectors, and enable Mercado Pago for the conversation.

ChatGPT · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_Mx4Sw13BkVSyvhTG9vcHJTm07zdH5PNyBe4399ul/mcp

Step 01

Open MCP settings

On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
Step 02

Add the URL

Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Mercado Pago URL.
Step 03

Save and start

Save the connection and enable Mercado Pago in your conversation. Desktop may ask you to restart once.

Cursor · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "mercado-pago": {
      "url": "https://edge.vinkius.com/vk_preview_Mx4Sw13BkVSyvhTG9vcHJTm07zdH5PNyBe4399ul/mcp"
    }
  }
}

Step 01

Open MCP Settings

Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
Step 02

Add the server config

Paste the JSON configuration above into the mcp.json file that opens
Step 03

Save the file

Cursor will automatically detect the new Connector
Step 04

Start using Mercado Pago

Open Agent mode in chat and ask: "Using Mercado Pago, help me...". 12 tools available

VS Code Copilot · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "mercado-pago": {
      "url": "https://edge.vinkius.com/vk_preview_Mx4Sw13BkVSyvhTG9vcHJTm07zdH5PNyBe4399ul/mcp"
    }
  }
}

Step 01

Create MCP config

Create a .vscode/mcp.json file in your project root
Step 02

Add the server config

Paste the JSON configuration above
Step 03

Enable Agent mode

Open GitHub Copilot Chat and switch to Agent mode using the dropdown
Step 04

Start using Mercado Pago

Ask Copilot: "Using Mercado Pago, help me...". 12 tools available

Windsurf · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "mercado-pago": {
      "url": "https://edge.vinkius.com/vk_preview_Mx4Sw13BkVSyvhTG9vcHJTm07zdH5PNyBe4399ul/mcp"
    }
  }
}

Step 01

Open MCP Settings

Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
Step 02

Add the server

Paste the JSON configuration above into mcp_config.json
Step 03

Save and reload

Windsurf will detect the new server automatically
Step 04

Start using Mercado Pago

Open Cascade and ask: "Using Mercado Pago, help me...". 12 tools available

Cline · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "mercado-pago": {
      "url": "https://edge.vinkius.com/vk_preview_Mx4Sw13BkVSyvhTG9vcHJTm07zdH5PNyBe4399ul/mcp"
    }
  }
}

Step 01

Open Cline MCP Settings

Click the Connectors icon in the Cline sidebar panel
Step 02

Add remote server

Click "Add Connector" and paste the configuration above
Step 03

Enable the server

Toggle the server switch to ON
Step 04

Start using Mercado Pago

Ask Cline: "Using Mercado Pago, help me...". 12 tools available

Claude Code · Terminal command

Official guide ↗

Advanced setup

claude mcp add mercado-pago --transport http "https://edge.vinkius.com/vk_preview_Mx4Sw13BkVSyvhTG9vcHJTm07zdH5PNyBe4399ul/mcp"

Step 01

Install Claude Code

Run npm install -g @anthropic-ai/claude-code if not already installed
Step 02

Add the Connector

Run the command above in your terminal
Step 03

Verify the connection

Run claude mcp to list connected servers, or type /mcp inside a session
Step 04

Start using Mercado Pago

Ask Claude: "Using Mercado Pago, show me...". 12 tools are ready

Where the request belongs

Work Mercado Pago can move forward.

Built around the request

This is for Brazilian merchants and fintech workers who are tired of switching tabs between their customer chat and the Mercado Pago dashboard to process orders.

E-commerce Manager

Handles high-volume orders and issues refunds for customers directly from a chat interface.

Fintech Developer

Builds AI-driven financial workflows that automate Pix and card payments for Brazilian users.

Small Business Owner

Generates payment links and tracks daily transactions without needing to write any code.

Build the capability set

Each Connector adds new actions and data without changing how you work.

Browse Connectors

01 11 capabilities

Pagar.me

Create orders, manage subscriptions, and process Pix/Boleto payments via Pagar.me API.

View Connector

02 8 capabilities

Braintree

Process and manage payments via Braintree GraphQL API. search transactions, manage customers, and issue refunds directly from any AI agent.

View Connector

03 8 capabilities

Checkout.com

Manage global payments via Checkout.com. track transactions, process refunds, and monitor account health directly from any AI agent.

View Connector

04 10 capabilities

Blink Payment

Manage payments, customers, and paylinks seamlessly using Blink Payment with AI Agents.

View Connector

05 4 capabilities

Adyen

Global payment processing. manage payments, refunds, and merchant accounts via AI.

View Connector

06 10 capabilities

PayPal

Manage e-commerce payments via PayPal. orchestrate orders, process captures securely, issue refunds natively, and structure active subscriptions using AI.

View Connector

Bring your own AI

Change the model, client or framework. Keep Mercado Pago connected.

Claude
ChatGPT
Gemini
Cursor
VS Code
Windsurf
ZCode
Cline
Zed
Continue
Kiro
Roo Code
Zencoder
Goose
Void
Augment Code
Amp
Qodo
Tabnine
Pieces
Sourcegraph Cody
JetBrains
Warp
Amazon Q
Antigravity
BoltAI
Raycast
Jan
LM Studio
AnythingLLM
Open WebUI
Msty
Cherry Studio
LibreChat
TypingMind
Chorus
5ire
n8n
LangChain
LlamaIndex
CrewAI
Vercel AI SDK

Before you connect

Questions about Mercado Pago.

The practical details behind the request, access and result.

Can I use the Mercado Pago MCP to handle Pix payments?

Yes. You can ask your AI agent to generate Pix QR codes instantly for your customers, allowing them to scan and pay immediately.

Does the Mercado Pago MCP support credit card refunds?

Yes. You can issue full or partial refunds for credit card transactions directly through your AI client without opening the Mercado Pago dashboard.

How does the Mercado Pago MCP help with customer management?

It allows your agent to register new customers and save their payment cards, making it easier to process one-click payments in the future.

Can I search for old transactions using the Mercado Pago MCP?

Yes. Your agent can filter through your payment history to find specific transactions using details like the customer's email or the payment status.

Is the Mercado Pago MCP good for Brazilian e-commerce?

It is specifically built for the Brazilian market, supporting local favorites like Pix and various regional credit cards.

Can I create checkout links with the Mercado Pago MCP?

Yes. You can have your agent generate unique checkout preferences, which you can then send to customers for web redirects.

How do I get a Mercado Pago Access Token?

Go to your Mercado Pago account, navigate to Developers > Your Integrations > Production Credentials (or Sandbox), and copy your Access Token. It starts with 'APP_USR-' for production.

Can I generate Pix payments?

Yes! Use the create_pix_payment action. It generates a Pix transaction and returns QR Code data that can be displayed for the payer to scan and pay instantly.

Can I issue refunds?

Yes! Use the refund_payment action with a payment_id. If you omit the amount, it performs a full refund. If you provide an amount, it performs a partial refund.

One connection away

Give your agent a direct line to Mercado Pago.

Connect Mercado Pago once. Keep it beside 5,900+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available

Mercado Pago for Ending Manual Refund Entry

You can manage your entire Brazilian payment lifecycle through a conversation instead of a dashboard.

Sending a quick Pix link

Processing a customer refund

Registering a new buyer

Create card

Create customer

Create payment

Create preference

Get customer

Get payment

Get preference

Create pix payment

Refund payment

Search payments

Get identification types

List payment methods

Open Connectors

Add the URL

Turn it on in chat

Open MCP settings

Add the URL

Save and start

Open MCP Settings

Add the server config

Save the file

Start using Mercado Pago

Create MCP config

Add the server config

Enable Agent mode

Start using Mercado Pago

Open MCP Settings

Add the server

Save and reload

Start using Mercado Pago

Open Cline MCP Settings

Add remote server

Enable the server

Start using Mercado Pago

Install Claude Code

Add the Connector

Verify the connection

Start using Mercado Pago

E-commerce Manager

Fintech Developer

Small Business Owner

Pagar.me

Braintree

Checkout.com

Blink Payment

Adyen

PayPal

Give your agent a direct line to Mercado Pago.