Skip to main content
Glama
MercadoLibre MCP Server

MercadoLibre MCP Server

by lumile

insignia de herrería

Servidor MCP de MercadoLibre

Un servidor MCP que proporciona acceso a la API de MercadoLibre.

Características

Herramientas

  • search_products - Busca productos en MercadoLibre y devuelve una lista de productos.

    • query - La consulta de búsqueda

    • category : La categoría en la que buscar

    • filters - Los filtros a aplicar

  • product_reviews - Obtenga reseñas de productos

  • product_description - Obtener la descripción del producto

  • seller_reputation - Obtener la reputación del vendedor

Related MCP server: Mercado Livre MCP Server

Configuración

Prerrequisitos

Necesitarás un ID de cliente y una clave secreta de cliente de MercadoLibre para usar este servidor. Puedes obtener uno gratis en https://developers.mercadolibre.com/ , crear una aplicación y obtener las credenciales.

Una vez que tenga las credenciales, puede configurar las variables de entorno CLIENT_ID y CLIENT_SECRET . También debe configurar la variable de entorno SITE_ID para el sitio que desea usar.

ID del sitio de Mercado Libre

  • MLA: Argentina (predeterminado)

  • MLB: Brasil

  • MCO: Colombia

  • MEX: México

  • MLU: Uruguay

  • MLC: Chile

Instalación

Hay dos formas de utilizar este servidor:

Instalación mediante herrería

Para instalar MercadoLibre MCP Server para Claude Desktop automáticamente a través de Smithery :

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

Opción 1: NPX (Recomendado)

Agregue esta configuración a su archivo de configuración de Claude Desktop:

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

Opción 2: Instalación local

  1. Clonar el repositorio

  2. Instalar dependencias:

npm install
  1. Construir el servidor:

npm run build
  1. Agregue esta configuración a su configuración de Claude Desktop:

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

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser complicada. Recomendamos usar el Inspector MCP , disponible como script de paquete:

npm run inspector

El Inspector proporcionará una URL para acceder a las herramientas de depuración en su navegador.

Contribuyendo

¡Las contribuciones son muy bienvenidas! Por favor, abran una solicitud de colaboración con nuevos servidores MCP o cualquier otra mejora al código base.

Descargo de responsabilidad

Este proyecto no está afiliado a MercadoLibre. Todos los logotipos son marcas registradas de sus respectivos propietarios.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo LICENSE.md para obtener más detalles.


Available Tools

3 tools
product_descriptionB

Obtiene la descripción de un producto

Inputs: productId.

product_reviewsC

Obtiene las reseñas de un producto

Inputs: productId.

seller_reputationC

Obtiene la reputación de un vendedor

Inputs: sellerId.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose targeting different aspects of products and sellers: product_description retrieves product details, product_reviews gets customer feedback, and seller_reputation assesses seller credibility. There is no overlap or ambiguity between these functions.

    Naming Consistency5/5

    All tool names follow a consistent snake_case pattern with a clear 'noun_noun' structure (product_description, product_reviews, seller_reputation). This predictable naming makes it easy for agents to understand and select the appropriate tool.

    Tool Count2/5

    With only 3 tools, the server feels under-scoped for a marketplace domain like MercadoLibre. While the tools cover basic product and seller information, there are likely many other operations (e.g., search, purchase, listing management) that are missing, making the set feel incomplete for comprehensive marketplace interactions.

    Completeness2/5

    The tool surface is severely incomplete for a marketplace server. It only provides read-only access to product descriptions, reviews, and seller reputation, with no ability to search for products, create listings, manage orders, or perform other essential marketplace operations. This creates significant gaps that will limit agent functionality.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Connects AI agents to MercadoLibre, the largest e-commerce marketplace in Latin America. Search products, get item details, browse categories, track trends, and convert currencies.
      8
      32 npm
      9
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Connects Claude to your MercadoLibre seller account, enabling natural language management of listings, orders, and shipments.
      -