mercadolibre MCP Server

Use This MCP server To

Search MercadoLibre products by query and category Retrieve detailed product descriptions from MercadoLibre Fetch product reviews for quality assessment Check seller reputation scores for trust evaluation Integrate MercadoLibre product data into AI agents Filter product searches with custom parameters Build e-commerce chatbots with live MercadoLibre data Automate product comparison using MercadoLibre listings

README

MercadoLibre MCP Server

An MCP server that provides access to MercadoLibre API.

Features

Tools

search_products - Search products in MercadoLibre, and return a list of products.
- query - The search query
- category - The category to search in
- filters - The filters to apply
product_reviews - Get product reviews
product_description - Get product description
seller_reputation - Get seller reputation

Setup

Prerequisites

You'll need a MercadoLibre Client ID and Client Secret to use this server. You can get one for free at https://developers.mercadolibre.com/, create an application and get the credentials.

Once you have the credentials, you can set the CLIENT_ID and CLIENT_SECRET environment variables. And theres also the need to set the SITE_ID environment variable to the site you want to use.

Mercado Libre Site ID

MLA: Argentina (default)
MLB: Brasil
MCO: Colombia
MEX: México
MLU: Uruguay
MLC: Chile

Installation

There are two ways to use this server:

Installing via Smithery

To install MercadoLibre MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @lumile/mercadolibre-mcp --client claude

Option 1: NPX (Recommended)

Add this configuration to your Claude Desktop config file:

{
  "mcpServers": {
    "mercadolibre-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mercadolibre-mcp"
      ],
      "env": {
        "CLIENT_ID": "<YOUR_CLIENT_ID>",
        "CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
        "SITE_ID": "<YOUR_SITE_ID>"
      }
    }
  }
}

Option 2: Local Installation

Clone the repository
Install dependencies:

npm install

Build the server:

npm run build

Add this configuration to your Claude Desktop config:

{
  "mcpServers": {
    "mercadolibre-mcp": {
      "command": "node",
      "args": [
        "/path/to/mercadolibre-mcp/dist/index.js"
      ],
      "env": {
        "CLIENT_ID": "<YOUR_CLIENT_ID>",
        "CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
        "SITE_ID": "<YOUR_SITE_ID>"
      }
    }
  }
}

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.

Contributing

Contributions are extremely welcome! Please open a PR with new MCP servers or any other improvements to the codebase.

Disclaimer

This project is not affiliated with MercadoLibre. All logos are trademarks of their respective owners.

License

This project is licensed under the MIT License - see the LICENSE.md file for details.

Made with ❤️ by Lumile

mercadolibre-mcp FAQ

How do I authenticate the mercadolibre-mcp server?

You need a MercadoLibre Client ID and Client Secret obtained from https://developers.mercadolibre.com/ to authenticate API requests.

What product information can I retrieve with this server?

You can get product search results, detailed descriptions, reviews, and seller reputation data.

Can I filter product searches by category or other criteria?

Yes, the server supports filtering searches by category and additional filters to refine results.

Is this server compatible with multiple LLM providers?

Yes, it works with OpenAI, Anthropic Claude, and Google Gemini models via MCP.

How do I handle rate limits or API errors?

Implement retry logic and error handling in your MCP client; the server passes through MercadoLibre API responses.

Can I use this server to build e-commerce chatbots?

Absolutely, it enables real-time product data access for conversational agents and AI workflows.

What setup is required before using this server?

You must register an application on MercadoLibre developers portal to get API credentials and configure them in the server.

Does the server provide seller reputation details?

Yes, it exposes seller reputation metrics to help evaluate trustworthiness.