MercadoLibre MCP server

This MCP server provides access to the MercadoLibre API, allowing you to search products, retrieve product reviews and descriptions, and check seller reputation through Claude Desktop.

Features

The MercadoLibre MCP Server offers several tools:

• search_products: Search products in MercadoLibre
  • query: Your search term
  • category: Specific category to search within
  • filters: Additional search filters
• product_reviews: Retrieve product reviews
• product_description: Get detailed product descriptions
• seller_reputation: Check seller reputation information

Prerequisites

Before installing, you'll need:

1. A MercadoLibre Client ID and Client Secret from MercadoLibre Developers
2. A MercadoLibre Site ID for your region

Available Site IDs

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

Installation

Via Smithery (Easiest Method)

Install automatically via Smithery with:

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

Via 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>"
      }
    }
  }
}

Local Installation

1. Clone the repository
2. Install dependencies:

   npm install
   

3. Build the server:

   npm run build
   

4. 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, you can use the MCP Inspector for debugging:

npm run inspector

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

Using the MCP Server

Once installed, Claude Desktop will be able to access MercadoLibre data through the server's tools. You can ask Claude to search for products, look up reviews, or get product descriptions, and it will use the appropriate MCP tool to retrieve the information.

Example prompts to use with Claude:

• "Find me laptops under $1000 on MercadoLibre"
• "What are the reviews like for [product] on MercadoLibre?"
• "Tell me about this seller's reputation on MercadoLibre"

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

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

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "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>"
            }
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration 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>"
            }
        }
    }
}

3. Restart Claude Desktop for the changes to take effect