MercadoLibre MCP Server

An MCP server that provides access to MercadoLibre API.

IMPORTANT: due to changes in MercadoLibre's API policies, it is no longer possible to access their search API. As a result, we have had to deprecate the search_products tool. This change is in compliance with MercadoLibre's new restrictions on API usage. Other tools remain functional and will continue to be supported.

Features

Tools

search_products - DEPRECATED: Search products in MercadoLibre, and return a list of products. (No longer available due to API policy changes)
- 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.

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

Enables interaction with MercadoLibre's API for product search, reviews, descriptions, and seller reputation insights.

Related Resources

Reddit Discussion about this server

Related MCP Servers

PolyMarket MCP Server
berlinbra
A
security
A
license
A
quality
Enables interaction with the PolyMarket API to fetch prediction market data such as market information, prices, and historical data, with robust error handling and rate limit management.
Last updated -
4
35
Python
MIT License
Shopify MCP Server
amir-bengherbi
A
security
A
license
A
quality
Enables interaction with Shopify store data using the GraphQL API, supporting product, customer, and order management with comprehensive error handling.
Last updated -
15
761
11
TypeScript
MIT License
Shopify MCP Server
rezapex
A
security
A
license
A
quality
Enables interaction with Shopify store data via GraphQL API, providing tools for managing products, customers, orders, discounts, and more with robust error handling.
Last updated -
15
761
30
TypeScript
MIT License
Shopify MCP Server
therealhexi
-
security
A
license
-
quality
Enables interaction with Shopify stores through GraphQL API, providing tools for managing products, customers, orders, and more.
Last updated -
761
8
TypeScript
MIT License

View all related MCP servers

MercadoLibre MCP Server