mercadolibre-mcp
If you are the rightful owner of mercadolibre-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
An MCP server that provides access to MercadoLibre API.
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 querycategory- The category to search infilters- The filters to apply
product_reviews- Get product reviewsproduct_description- Get product descriptionseller_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
Contact us for custom AI development and automation solutions.
