mercadolibre-mcp
MercadoLibre MCP server for AI agents. Search products, browse categories, track trends across Latin America.
Documentation
mercadolibre-mcp
MercadoLibre marketplace for AI agents.
MCP server that connects AI agents to MercadoLibre, the largest e-commerce marketplace in Latin America (150M+ users). Search products, get item details, browse categories, track trends, and convert currencies across Argentina, Brazil, Mexico, Chile, Colombia, and more.
Quick Start
No API key required for public endpoints (search, items, categories, trends).
Claude Desktop
Add to your `claude_desktop_config.json`:
{
"mcpServers": {
"mercadolibre": {
"command": "npx",
"args": ["-y", "@dan1d/mercadolibre-mcp"]
}
}
}Claude Code
claude mcp add mercadolibre -- npx -y @dan1d/mercadolibre-mcpCursor
Add to `.cursor/mcp.json`:
{
"mcpServers": {
"mercadolibre": {
"command": "npx",
"args": ["-y", "@dan1d/mercadolibre-mcp"]
}
}
}Windsurf
{
"mcpServers": {
"mercadolibre": {
"command": "npx",
"args": ["-y", "@dan1d/mercadolibre-mcp"]
}
}
}With authentication (optional)
For endpoints that require auth (future premium features), add your access token:
{
"mcpServers": {
"mercadolibre": {
"command": "npx",
"args": ["-y", "@dan1d/mercadolibre-mcp"],
"env": {
"MERCADOLIBRE_ACCESS_TOKEN": "APP_USR-..."
}
}
}
}> Once configured, ask your AI assistant things like: *"Search for iPhone 15 on MercadoLibre"* or *"What are the trending searches in Argentina?"* or *"Show me details for item MLA1234567890"*
Available Tools
| Tool | Description |
|---|---|
| `search_items` | Search products by keyword. Filter by category, price range, and site (MLA=Argentina, MLB=Brazil, MLM=Mexico, MLC=Chile, MCO=Colombia). |
| `get_item` | Get full item details: title, price, pictures, seller, condition, stock, and more. |
| `get_item_description` | Get the full text description of an item. |
| `get_categories` | List all top-level categories for a MercadoLibre site. |
| `get_category` | Get category details including name, path from root, and children. |
| `get_seller_info` | Get seller profile: reputation, ratings, and transaction stats. |
| `get_trends` | Get current trending searches for a specific site/country. |
| `get_currency_conversion` | Convert between currencies using MercadoLibre exchange rates (ARS, BRL, MXN, USD, etc.). |
Supported Sites
| Site ID | Country |
|---|---|
| `MLA` | Argentina |
| `MLB` | Brazil |
| `MLM` | Mexico |
| `MLC` | Chile |
| `MCO` | Colombia |
| `MLU` | Uruguay |
| `MPE` | Peru |
| `MEC` | Ecuador |
| `MCR` | Costa Rica |
| `MPA` | Panama |
| `MLV` | Venezuela |
| `MRD` | Dominican Republic |
| `MHN` | Honduras |
| `MBO` | Bolivia |
| `MNI` | Nicaragua |
| `MPY` | Paraguay |
| `MSV` | El Salvador |
| `MGT` | Guatemala |
Example Prompts
- "Search for PlayStation 5 under $500000 in Argentina"
- "Show me the details of item MLA1405857684"
- "What are the trending searches in Brazil?"
- "List all categories on MercadoLibre Mexico"
- "Show me the reputation of seller 123456789"
- "Convert 100 USD to ARS"
Programmatic Usage
npm install @dan1d/mercadolibre-mcpimport { createMercadoLibreTools } from "@dan1d/mercadolibre-mcp";
const ml = createMercadoLibreTools();
// Search products
const results = await ml.tools.search_items({
query: "iPhone 15",
site_id: "MLA",
price_max: 2000000,
limit: 5,
});
// Get item details
const item = await ml.tools.get_item({ item_id: "MLA1405857684" });
// Get trending searches in Argentina
const trends = await ml.tools.get_trends({ site_id: "MLA" });
// Browse categories
const categories = await ml.tools.get_categories({ site_id: "MLA" });
// Get seller reputation
const seller = await ml.tools.get_seller_info({ seller_id: 123456789 });
// Convert currencies
const conversion = await ml.tools.get_currency_conversion({
from: "USD",
to: "BRL",
amount: 100,
});Part of the LATAM MCP Toolkit
| Server | What it does |
|---|---|
| CobroYa | Mercado Pago payments — create links, search payments, refunds |
| MercadoLibre MCP | MercadoLibre marketplace — search products, categories, trends |
| DolarAPI MCP | Argentine exchange rates — blue, oficial, CCL, crypto, conversion |
License
Frequently asked questions
What is mercadolibre-mcp?
mercadolibre-mcp is MercadoLibre MCP server for AI agents. Search products, browse categories, track trends across Latin America.
How do I install mercadolibre-mcp?
Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.
Is mercadolibre-mcp open source?
Yes — it is hosted on GitHub at https://github.com/dan1d/mercadolibre-mcp and has 2 stars.
Related MCP tools
serversModel Context Protocol Servers
n8n-mcpA MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you
Figma-Context-MCPMCP server to provide Figma layout information to AI coding agents like Cursor
butterbaseOpen-source backend-as-a-service. Postgres, auth, storage, functions, AI gateway, MCP.
supermemory-mcpYour memories are in ChatGPT... But nowhere else. Universal Memory MCP makes your memories available to every single LLM. No logins or paywall. One command to set it up.
mcp-server-kubernetesMCP Server for kubernetes management commands
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP