MercadoLibre

Provides MCP access to MercadoLibre API tools including product data, reviews, descriptions, and seller reputation.

typescript

8

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can use the MercadoLibre MCP Server to access MercadoLibre API endpoints from your MCP client. It exposes tools to fetch product data, descriptions, reviews, and seller reputation, enabling you to build AI-powered experiences that rely on MercadoLibre data with a configurable, self-hosted MCP server.

How to use

Choose MercadoLibre MCP Server in your MCP client to start interacting with MercadoLibre data. You can run and configure the server locally or via an external runtime as described in the installation steps. The available tools let you search for products (deprecated), get product descriptions, fetch product reviews, and check seller reputation. Note that the search_products tool has been deprecated due to API policy changes, but the other tools remain functional.

How to install

Prerequisites you need before installation are: • Node.js (with npm) installed on your machine.

Option 1: NPX (Recommended) Install via NPX and configure your MCP client.

{
  "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 Run the server locally after cloning the repository and installing dependencies.

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

Steps to set up a local installation: 1) Clone the repository 2) Install dependencies: npm install 3) Build the server: npm run build 4) Add the MCP server configuration to your MCP client using the snippet above for the stdio configuration.

Additional setup and troubleshooting

Environment variables you must provide: - CLIENT_ID: MercadoLibre Client ID - CLIENT_SECRET: MercadoLibre Client Secret - SITE_ID: Site identifier (e.g., MLA, MLB, MCO, MEX, MLU, MLC) These are required by the server to authorize API requests.

Debugging MCP servers that communicate over stdio can be challenging. You can use the MCP Inspector to access debugging tools in your browser. Run the inspector script provided with your MCP setup to obtain the debugging URL.

Notes on tools and capabilities

The server provides the following tools: - search_products: Search products in MercadoLibre (DEPRECATED and no longer available due to API policy changes) - product_reviews: Get product reviews - product_description: Get product description - seller_reputation: Get seller reputation

Available tools

search_products

Search products in MercadoLibre (DEPRECATED: no longer available due to API policy changes)

product_reviews

Get product reviews from MercadoLibre for a given product

product_description

Get a product description from MercadoLibre

seller_reputation

Get seller reputation information from MercadoLibre