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.

npm | GitHub

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-mcp

Cursor

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-mcp

import { 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

MIT -- by dan1d