Skip to main content
Glama
Sign In
mercadolibre-mcp

mercadolibre-mcp

by dan1d
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

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

An access token is required. MercadoLibre now gates almost every endpoint behind an app token (search, items, categories list, sellers, trends, currency conversion return 403/401 anonymously; only get_category works without one). Create a free application at developers.mercadolibre.com and use its access token as MERCADOLIBRE_ACCESS_TOKEN in every config below.

Claude Desktop

Add to your claude_desktop_config.json:

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

Claude Code

claude mcp add mercadolibre -e MERCADOLIBRE_ACCESS_TOKEN=APP_USR-... -- npx -y @dan1d/mercadolibre-mcp

Cursor

Add to .cursor/mcp.json:

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

Windsurf

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

With authentication (required for all tools except get_category)

Add your access token to the env block (the Claude Desktop / Cursor / Windsurf snippets above need the same env):

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

Related MCP server: cobroya

Available Tools

Tool

Description

search_items

Search products by keyword. Filter by category, price range, and site (MLA=Argentina, MLB=Brazil, MLM=Mexico, MLC=Chile, MCO=Colombia).

get_item

Get full item details: title, price, pictures, seller, condition, stock, and more.

get_item_description

Get the full text description of an item.

get_categories

List all top-level categories for a MercadoLibre site.

get_category

Get category details including name, path from root, and children.

get_seller_info

Get seller profile: reputation, ratings, and transaction stats.

get_trends

Get current trending searches for a specific site/country.

get_currency_conversion

Convert between currencies using MercadoLibre exchange rates (ARS, BRL, MXN, USD, etc.).

Supported Sites

Site ID

Country

MLA

Argentina

MLB

Brazil

MLM

Mexico

MLC

Chile

MCO

Colombia

MLU

Uruguay

MPE

Peru

MEC

Ecuador

MCR

Costa Rica

MPA

Panama

MLV

Venezuela

MRD

Dominican Republic

MHN

Honduras

MBO

Bolivia

MNI

Nicaragua

MPY

Paraguay

MSV

El Salvador

MGT

Guatemala

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

Server

What it does

CobroYa

Mercado Pago payments — create links, search payments, refunds

MercadoLibre MCP

MercadoLibre marketplace — search products, categories, trends

DolarAPI MCP

Argentine exchange rates — blue, oficial, CCL, crypto, conversion

License

MIT -- by dan1d

Available Tools

8 tools
get_categoriesB

List all top-level categories for a MercadoLibre site.

Inputs: site_id.

get_categoryA

Get category details including name, path from root, and children categories.

Inputs: category_id (required).

get_currency_conversionB

Convert between currencies using MercadoLibre exchange rates (ARS, BRL, MXN, USD, etc.).

Inputs: from (required), to (required), amount.

get_itemA

Get full details of a MercadoLibre item including title, price, pictures, seller, condition, and stock.

Inputs: item_id (required).

get_item_descriptionA

Get the full text description of a MercadoLibre item.

Inputs: item_id (required).

get_seller_infoA

Get seller profile including reputation, ratings, and transaction stats.

Inputs: seller_id (required).

get_trendsA

Get current trending searches on MercadoLibre for a specific site/country.

Inputs: site_id.

search_itemsB

Search products on MercadoLibre by keyword. Supports filtering by category, price range, and site (MLA=Argentina, MLB=Brazil, MLM=Mexico, etc.)

Inputs: query (required), site_id, category, price_min, +3 more.

Tool Schema Changelog

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

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.9/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: categories (list vs detail), items (full vs description), search, currency conversion, seller info, and trends. No overlap or ambiguity.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern with snake_case, mostly using 'get_' prefix ('get_categories', 'get_item', etc.) except 'search_items' which still follows the verb_noun pattern. Very predictable.

    Tool Count5/5

    8 tools is well within the ideal 3-15 range. The set covers all essential read operations for a marketplace data API without being too sparse or bloated.

    Completeness5/5

    The tool surface covers browsing categories, searching/filtering items, retrieving item details and descriptions, seller info, trends, and currency conversion. No obvious gaps for a read-only marketplace data API.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • cobroya

      dan1d
      A
      license
      A
      quality
      D
      maintenance
      Connects AI agents to Mercado Pago, the leading payment platform in Latin America. Create payment links, search payments, get payment details, issue refunds, and retrieve merchant info.
      5
      67 npm
      3
      MIT

    • MercadoLibre MCP Server

      eme-ce
      F
      license
      Not graded
      quality
      D
      maintenance
      Connects Claude to your MercadoLibre seller account, enabling natural language management of listings, orders, and shipments.
      -

    Appeared in Searches