# Mercado Pago MCP for AI Agents AI Agent Connect

> Mercado Pago MCP. Process Brazilian payments, generate Pix QR codes, and manage customer refunds through your AI client.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_Mx4Sw13BkVSyvhTG9vcHJTm07zdH5PNyBe4399ul/ai-agent-connect
- **Tags:** pix-payments, qr-code-payments, credit-card-processing, refund-management, checkout-api

## Description

This Connector connects your AI client to Mercado Pago, the primary payment gateway in Brazil. You can handle Pix payments, manage credit card transactions, and issue refunds through simple conversation. It removes the need to toggle between your merchant dashboard and your customer chat. This tool is part of the Vinkius catalog and helps you move money without the hassle of manual data entry. You can register new customers, save their payment cards for future use, and handle refunds without ever opening a browser tab. Whether you need to generate a Pix QR code or find a specific payment by email, your agent does the work for you.

## Tools

### create_card
Save a customer's card to your account. This allows for faster one-click payments in future transactions.

### create_customer
Register a new customer profile. This keeps your buyer data organized and accessible.

### create_payment
Process a transaction using a card token. This handles various card networks like Visa and Mastercard.

### create_preference
Generate a unique checkout link. You can send this to customers for external web redirects.

### get_customer
Retrieve specific details for a registered customer. This helps you quickly look up profile information.

### get_payment
Get the status and details of a specific payment. Use this to check if a transaction was successful.

### get_preference
Fetch the details of a specific checkout preference. This is useful for verifying redirect links.

### create_pix_payment
Generate a QR code for instant Pix payments. This allows customers to scan and pay immediately.

### refund_payment
Process a full or partial refund for a transaction. This handles returns without manual dashboard navigation.

### search_payments
Filter through your transaction history. This is perfect for reconciling payments by email or ID.

### get_identification_types
List valid identification types like CPF or CNPJ. Use this to ensure correct customer registration.

### list_payment_methods
Show all available payment methods in Brazil. This helps you see what options your customers can use.

## Prompt Examples

**Prompt:** 
```
Create a Pix payment for R$150 for a customer.
```

**Response:** 
```
Pix payment created! Status: pending. QR Code generated for customer to scan and pay instantly.
```

**Prompt:** 
```
Refund payment 12345678 fully.
```

**Response:** 
```
Full refund processed successfully! Status: refunded.
```

**Prompt:** 
```
Show me all approved payments for user@email.com.
```

**Response:** 
```
Found 3 approved payments:

| Status | Amount | Method |
| :--- | :--- | :--- |
| Approved | R$ 50.00 | Visa |
| Approved | R$ 120.00 | Pix |
| Approved | R$ 85.50 | Mastercard |
```

## Capabilities

### Generate Pix QR codes
Create instant QR codes for customers to scan and pay immediately.

### Process credit cards
Charge various Brazilian cards like Visa and Mastercard securely.

### Manage customer profiles
Register new customers and save their card details for one-click payments.

### Issue instant refunds
Process full or partial refunds to customers without leaving your chat.

### Create checkout links
Generate payment links for external web redirects and checkouts.

## Use Cases

### Sending a quick Pix link
A shop owner needs to collect payment. They ask the agent to use create_pix_payment to generate a unique QR code and share it in the chat.

### Processing a customer refund
A customer requests a return. The manager uses refund_payment to process a full refund for a specific transaction ID instantly.

### Registering a new buyer
A new customer wants to save their info. The agent uses create_customer and create_card to register them and store their payment method.

### Reconciling daily sales
An owner needs to find a specific sale from last week. They ask the agent to use search_payments to filter by email and status.

## Benefits

- Handle instant payments with create_pix_payment to send QR codes to customers immediately.
- Keep customer data organized by using create_customer to register profiles in one go.
- Reduce manual work with refund_payment to handle returns without opening your browser.
- Speed up checkout with create_preference to generate links for your web store.
- Find any transaction quickly using search_payments to filter by status or email.

## How It Works

The bottom line is you can manage your entire Brazilian payment lifecycle through a conversation instead of a dashboard.

1. Connect your Mercado Pago access token to the Connector.
2. Command your agent to perform actions like creating a payment or searching records.
3. Receive confirmation data or QR codes directly in your chat interface.

## Frequently Asked Questions

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