Mercado Libre MCP Server for Mastra AIGive Mastra AI instant access to 17 tools to Answer Question, Create Item, Create Test User, and more
GDPR Free for SubscribersMastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Mercado Libre through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
Ask AI about this MCP Server for Mastra AI
The Mercado Libre MCP Server for Mastra AI is a standout in the Industry Titans category — giving your AI agent 17 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
Geminiimport { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"mercado-libre": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "Mercado Libre Agent",
instructions:
"You help users interact with Mercado Libre " +
"using 17 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with Mercado Libre?"
);
console.log(result.text);
}
main();
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About Mercado Libre MCP Server
Connect your Mercado Libre seller account to any AI agent to streamline your e-commerce operations through natural conversation.
Mastra's agent abstraction provides a clean separation between LLM logic and Mercado Libre tool infrastructure. Connect 17 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
What you can do
- Product Listing — Predict the correct category for your items and create new listings with full attribute support
- Order Management — Search and retrieve detailed metadata for orders, including status, payment, and buyer info
- Logistics & Shipping — Track shipment status and monitor SLA dispatch times to protect your seller reputation
- Customer Service — Search for buyer questions, provide answers, and manage post-sale messaging flows
- Claims & Returns — Inspect active claims and return details to resolve customer issues efficiently
- Price & Promos — Check sale prices and identify items eligible for promotions
The Mercado Libre MCP Server exposes 17 tools through the Vinkius. Connect it to Mastra AI in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 17 Mercado Libre tools available for Mastra AI
When Mastra AI connects to Mercado Libre through Vinkius, your AI agent gets direct access to every tool listed below — spanning marketplace, selling, customer-support, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Answer question on Mercado Libre
Answer a buyer question
Create item on Mercado Libre
Requires title, category_id, price, currency_id, available_quantity, buying_mode, condition, listing_type_id, and pictures. Publish a new item on Mercado Libre
Create test user on Mercado Libre
Create a test user
Get claim on Mercado Libre
Get details of a post-purchase claim
Get me on Mercado Libre
Get current Mercado Libre user info
Get order on Mercado Libre
Get details for a specific order
Get post sale messages on Mercado Libre
Get post-sale messages
Get promotion candidate on Mercado Libre
Check promotion eligibility
Get return details on Mercado Libre
Get details of a product return
Get sale price on Mercado Libre
Get the current sale price of an item
Get shipment on Mercado Libre
Get shipment information
Get shipment sla on Mercado Libre
Get shipment SLA (Service Level Agreement)
Get user addresses on Mercado Libre
Get addresses for a specific user
Predict category on Mercado Libre
Predict category for a product title
Search orders on Mercado Libre
Search orders for a seller
Search questions on Mercado Libre
Search questions for a seller
Send post sale message on Mercado Libre
Send a post-sale message
Connect Mercado Libre to Mastra AI via MCP
Follow these steps to wire Mercado Libre into Mastra AI. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install dependencies
npm install @mastra/core @mastra/mcp @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Mastra AI with the Mercado Libre MCP Server
Mastra AI provides unique advantages when paired with Mercado Libre through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Mercado Libre without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every Mercado Libre tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
Mercado Libre + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the Mercado Libre MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query Mercado Libre, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed Mercado Libre as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query Mercado Libre on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using Mercado Libre tools alongside other MCP servers
Example Prompts for Mercado Libre in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with Mercado Libre immediately.
"Search for all 'paid' orders for seller ID 123456789."
"What is the shipping status and SLA for shipment 405928374?"
"Predict the best category for a 'Wireless Mechanical Keyboard' on site MLB."
Troubleshooting Mercado Libre MCP Server with Mastra AI
Common issues when connecting Mercado Libre to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpMercado Libre + Mastra AI FAQ
Common questions about integrating Mercado Libre MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Explore More MCP Servers
View all →
Craft CMS (Craftnet)
10 toolsEquip your AI agent to manage plugins, licenses, and sales directly via the Craftnet (Craft CMS) API.
Evisort Contract Intelligence
10 toolsEquip your AI agent to manage contract documents, track AI-extracted provisions, and monitor workflows via the Evisort API.
Manage your Pinterest profile — audit boards and pins via AI.
WooCommerce Alternative
10 toolsManage your WooCommerce store — audit products, orders, and reports via AI.