How to Use the Mercado Libre MCP in Windsurf

Q: Can Windsurf automatically answer buyer questions on Mercado Libre?

Yes, Cascade uses searchquestions to find pending inquiries and answerquestion to post replies. It drafts the answers based on your actual inventory data and price points.

Q: How do I add this Mercado Libre MCP to my Windsurf configuration?

You open your mcpconfig.json file and add the server under the mcpServers key. After a quick panel refresh, Cascade instantly detects all 17 commerce tools.

Q: Can Cascade handle post-sale messages for my store?

Cascade uses getpostsalemessages to read buyer threads and sendpostsalemessage to send updates. It automates these follow-ups right inside your coding environment.

Manage your Mercado Libre storefront directly inside Windsurf as Cascade handles order lookups and customer replies on autopilot.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Mercado Libre MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Auto-resolve shipping delays with Cascade

The `get_shipment_sla` tool lets Windsurf check transit deadlines the moment a Mercado Libre buyer asks about their package. When a customer messages your Mercado Libre store about a late delivery, Cascade reads the order details and triggers `get_shipment` to locate the package. You get a drafted response in Windsurf based on actual Mercado Libre carrier tracking. Cascade combines this shipping data with your store policies so you never have to open the Mercado Libre seller portal.

Run bulk inventory updates via Windsurf MCP Server

The `predict_category` tool analyzes your product titles to find the exact Mercado Libre category ID inside the Windsurf workspace. Cascade takes your raw product files, runs them through this classification, and uses `create_item` to publish new listings directly to your Mercado Libre storefront. You do not need to manually map categories or copy-paste prices from Windsurf to Mercado Libre. If a Mercado Libre upload fails, Cascade reads the API error in your Windsurf panel, adjusts the payload, and retries the upload.

Automate claim resolution workflows

The `get_claim` tool pulls the exact reason for a Mercado Libre customer dispute directly into your Windsurf workspace. Instead of navigating the Mercado Libre seller portal, Cascade checks the claim details and uses `get_return_details` to verify if the buyer shipped the item. You can let Cascade draft a tailored refund resolution within Windsurf. It handles the Mercado Libre API handshake, letting you resolve disputes inside Windsurf before they impact your seller reputation.

Setup guide

Set up Mercado Libre 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 Libre 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 Libre payment history." If connected, Cascade will call the Mercado Libre tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "mercado-libre-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 Libre. 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 Libre 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 Libre MCP in Windsurf

It connects Cascade directly to the seller API through your local configuration file. Once you add the server, your agent can call tools like `search_orders` and `get_me` to run storefront tasks without leaving the editor.

Yes, Cascade uses `search_questions` to find pending inquiries and `answer_question` to post replies. It drafts the answers based on your actual inventory data and price points.

You open your `mcp_config.json` file and add the server under the `mcpServers` key. After a quick panel refresh, Cascade instantly detects all 17 commerce tools.

Cascade uses `get_post_sale_messages` to read buyer threads and `send_post_sale_message` to send updates. It automates these follow-ups right inside your coding environment.

This server processes your API tokens and customer shipping details inside a secure, ephemeral V8 isolate sandbox. Your private authentication keys never touch public logs or external third-party databases.

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