How to Use the Mercado Pago MCP in Windsurf

Process payments and manage customers directly in Windsurf. Cascade chains these tools to handle your entire checkout flow.

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 Windsurf

Create your Vinkius account to connect Mercado Pago to Windsurf 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 Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Full payment lifecycle in Windsurf

Cascade manages your transaction pipeline without manual intervention. Use `create_payment` or `create_pix_payment` to initiate charges and let the agent monitor status changes via `get_payment`. This MCP Server handles the logic for you. You define the amount and the intent, and the agent executes the necessary calls to finalize the operation.

Automated customer and card records

Keep your user database synced with your payment provider. Use `create_customer` to register new profiles and `create_card` to attach payment instruments to them. Everything stays organized within your project context. When you need to verify account details, the agent calls `get_customer` to pull the latest records.

Manage refunds and reconciliation

Handle post-payment tasks without leaving your IDE. Trigger `refund_payment` for partial or full reversals and use `search_payments` to pull transaction history for your reports. This keeps your accounting clean. The agent parses the returned data to ensure your logs match your actual processed transactions.

Setup guide

Set up Mercado Pago MCP in Windsurf

Prerequisites

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

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Mercado Pago MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Mercado Pago payment history." If connected, Cascade will call the Mercado Pago tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.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 Windsurf

Open your MCP settings in Windsurf and add the server configuration. Once saved, Cascade detects the 12 available tools automatically. You're ready to run payment tasks immediately.

Yes. Simply ask Cascade to initiate a transaction, and it invokes `create_pix_payment` to generate the QR code. You get the payload back instantly in your chat window.

It does. You can command the agent to perform a refund on a specific transaction ID. It uses the `refund_payment` tool to process the request against the gateway.

Your API tokens stay local to your environment. The MCP Server acts as a secure bridge, ensuring your keys are never exposed to external logs.

It only accesses your transaction metadata, customer IDs, and payment statuses. No sensitive raw credit card numbers are stored within the IDE.

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