How to Use the Mercado Pago MCP in Cursor

Q: How do I install the Mercado Pago MCP Server in Cursor?

Add the configuration block to your .cursor/mcp.json file at the project root. Once saved, Cursor Agent mode automatically detects the payment tools for your workspace.

Q: Can Cursor write frontend code using real Mercado Pago card tokens?

Yes, Cursor calls createpayment using mock or test card tokens to see how your backend processes the transaction. This ensures your frontend tokenization matches what the backend expects.

Q: How do I debug failing Pix checkouts inside Cursor?

Ask Cursor to run createpixpayment in Agent mode. The editor displays the raw JSON response, allowing you to trace field errors or validation issues instantly.

Q: Can I query active payment methods directly from the editor?

Yes, you can run listpaymentmethods inside Cursor chat. It returns the active card brands and payment networks currently enabled on your account.

Code and test Mercado Pago payment integrations directly inside Cursor using live API tools.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Mercado Pago MCP to Cursor

Create your Vinkius account to connect Mercado Pago to Cursor and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Mercado Pago with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Write payment code with live Cursor context

Stop writing fake API stubs for your Brazilian checkout flow. Cursor uses this MCP Server to call `create_payment` and `create_card` inside Agent mode to inject real, live API responses directly into your active workspace. Having actual card token responses in your editor workspace means your payment forms are built against real API shapes. You catch payload mismatches before pushing to staging.

Reconcile Brazilian sales in Cursor Chat

Debug ledger mismatches by letting this MCP Server query live records. Use `search_payments` directly inside Cursor chat to pull recent transaction lists into your coding context. The agent analyzes the returned JSON array to find failed Pix attempts or card chargebacks. You get instant context on production bugs without leaving your code editor.

Generate checkout preferences on the fly

Build dynamic redirects by invoking `create_preference` from your editor sidebar. Cursor generates the checkout configuration and returns the sandbox init point link instantly. You can immediately feed this link into your frontend test suite or use `get_preference` to inspect the payment methods allowed for that specific checkout session.

Setup guide

Set up Mercado Pago MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Mercado Pago MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Mercado Pago transactions." If the MCP tools are loaded correctly, Cursor will call the Mercado Pago tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

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

Get your connection token →

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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Mercado Pago now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Mercado Pago MCP in Cursor

Add the configuration block to your `.cursor/mcp.json` file at the project root. Once saved, Cursor Agent mode automatically detects the payment tools for your workspace.

Yes, Cursor calls `create_payment` using mock or test card tokens to see how your backend processes the transaction. This ensures your frontend tokenization matches what the backend expects.

Ask Cursor to run `create_pix_payment` in Agent mode. The editor displays the raw JSON response, allowing you to trace field errors or validation issues instantly.

Yes, you can run `list_payment_methods` inside Cursor chat. It returns the active card brands and payment networks currently enabled on your account.

The integration processes transaction amounts, customer names, and card tokens. Cursor handles these locally through your configuration file, ensuring your secret API keys are never leaked to outside servers.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript