convez.ai
MCP ServerIntegração & APIsIntermediário
dan1d

MercadoLibre MCP Server

dan1d/mercadolibre-mcp

Integre agentes IA ao MercadoLibre para buscas, análise de tendências e conversão de moedas

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que conecta agentes de IA ao MercadoLibre, o maior marketplace de e-commerce da América Latina. Permite buscar produtos, obter detalhes de itens, navegar categorias, acompanhar tendências e converter moedas sem necessidade de API key para endpoints públicos.

Instalação

$npx convez-ai dan1d/mercadolibre-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
9
Forks
5
Acompanhando
0
Saúde
42%
Último commit
há 3 semanas
Versão
v1.0.0
Issues abertas
0
Contribuidores
1

Casos de uso

  • Buscas de produtos em múltiplos países da América Latina
  • Análise de tendências de mercado e preços competitivos
  • Automação de pesquisa de itens com filtros por categoria e preço
  • Conversão de moedas entre ARS, BRL, MXN e mais 8 paises

Veredito

MCP server prático e bem estruturado para integração com MercadoLibre, sem exigência de autenticação para buscas públicas. Cobertura sólida de 13 países da América Latina com ferramentas essenciais de busca, análise de tendências e conversão cambial.

README

A tradução para o português deste README ainda está na fila.

mercadolibre-mcp

MercadoLibre marketplace for AI agents.

npm version tests npm downloads license

MCP server that connects AI agents to MercadoLibre, the largest e-commerce marketplace in Latin America (150M+ users). Search products, get item details, browse categories, track trends, and convert currencies across Argentina, Brazil, Mexico, Chile, Colombia, and more.

npm | GitHub


Quick Start

No API key required for public endpoints (search, items, categories, trends).

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "mercadolibre": {
      "command": "npx",
      "args": ["-y", "@dan1d/mercadolibre-mcp"]
    }
  }
}

Claude Code

claude mcp add mercadolibre -- npx -y @dan1d/mercadolibre-mcp

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "mercadolibre": {
      "command": "npx",
      "args": ["-y", "@dan1d/mercadolibre-mcp"]
    }
  }
}

Windsurf

{
  "mcpServers": {
    "mercadolibre": {
      "command": "npx",
      "args": ["-y", "@dan1d/mercadolibre-mcp"]
    }
  }
}

With authentication (optional)

For endpoints that require auth (future premium features), add your access token:

{
  "mcpServers": {
    "mercadolibre": {
      "command": "npx",
      "args": ["-y", "@dan1d/mercadolibre-mcp"],
      "env": {
        "MERCADOLIBRE_ACCESS_TOKEN": "APP_USR-..."
      }
    }
  }
}

Once configured, ask your AI assistant things like: "Search for iPhone 15 on MercadoLibre" or "What are the trending searches in Argentina?" or "Show me details for item MLA1234567890"


Available Tools

ToolDescription
search_itemsSearch products by keyword. Filter by category, price range, and site (MLA=Argentina, MLB=Brazil, MLM=Mexico, MLC=Chile, MCO=Colombia).
get_itemGet full item details: title, price, pictures, seller, condition, stock, and more.
get_item_descriptionGet the full text description of an item.
get_categoriesList all top-level categories for a MercadoLibre site.
get_categoryGet category details including name, path from root, and children.
get_seller_infoGet seller profile: reputation, ratings, and transaction stats.
get_trendsGet current trending searches for a specific site/country.
get_currency_conversionConvert between currencies using MercadoLibre exchange rates (ARS, BRL, MXN, USD, etc.).

Supported Sites

Site IDCountry
MLAArgentina
MLBBrazil
MLMMexico
MLCChile
MCOColombia
MLUUruguay
MPEPeru
MECEcuador
MCRCosta Rica
MPAPanama
MLVVenezuela
MRDDominican Republic
MHNHonduras
MBOBolivia
MNINicaragua
MPYParaguay
MSVEl Salvador
MGTGuatemala

Example Prompts

  • "Search for PlayStation 5 under $500000 in Argentina"
  • "Show me the details of item MLA1405857684"
  • "What are the trending searches in Brazil?"
  • "List all categories on MercadoLibre Mexico"
  • "Show me the reputation of seller 123456789"
  • "Convert 100 USD to ARS"

Programmatic Usage

npm install @dan1d/mercadolibre-mcp
import { createMercadoLibreTools } from "@dan1d/mercadolibre-mcp";

const ml = createMercadoLibreTools();

// Search products
const results = await ml.tools.search_items({
  query: "iPhone 15",
  site_id: "MLA",
  price_max: 2000000,
  limit: 5,
});

// Get item details
const item = await ml.tools.get_item({ item_id: "MLA1405857684" });

// Get trending searches in Argentina
const trends = await ml.tools.get_trends({ site_id: "MLA" });

// Browse categories
const categories = await ml.tools.get_categories({ site_id: "MLA" });

// Get seller reputation
const seller = await ml.tools.get_seller_info({ seller_id: 123456789 });

// Convert currencies
const conversion = await ml.tools.get_currency_conversion({
  from: "USD",
  to: "BRL",
  amount: 100,
});

Part of the LATAM MCP Toolkit

ServerWhat it does
CobroYaMercado Pago payments — create links, search payments, refunds
MercadoLibre MCPMercadoLibre marketplace — search products, categories, trends
DolarAPI MCPArgentine exchange rates — blue, oficial, CCL, crypto, conversion

License

MIT -- by dan1d

Ver o original no GitHub

Bom para

Relacionados