README - MercadoLibre by lumile

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 file for details.

Made with ❤️ by Lumile