Mercadolibre MCP

What dan1d/mercadolibre-mcp MCP server does

The dan1d/mercadolibre-mcp MCP server exposes MercadoLibre marketplace data to MCP-compatible AI clients. It supports product discovery, listing research, category browsing, seller checks, trend lookup, and exchange-rate conversion across MercadoLibre sites in Latin America.

Product searches accept a keyword and can be narrowed by category, price range, and site. Item lookups return listing information such as the title, price, images, seller, condition, and stock. A separate description tool retrieves the full listing text. Seller lookups provide profile, reputation, ratings, and transaction statistics.

The server also handles marketplace navigation and regional context. Agents can list top-level categories, inspect a category's path and child categories, query current trending searches for a site, and convert amounts between currencies including ARS, BRL, MXN, and USD.

How it works

The dan1d/mercadolibre-mcp MCP server runs as a local stdio process through the npm package @dan1d/mercadolibre-mcp. MCP clients start it with npx, then expose its functions to an AI assistant. Programmatic users can install the package and create a tool collection with createMercadoLibreTools().

Requests identify a marketplace with a site ID. Examples include MLA for Argentina, MLB for Brazil, MLM for Mexico, MLC for Chile, and MCO for Colombia.

Setup and configuration

Install the package with npm, or let a supported client download it on startup:

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

The same stdio pattern is documented for Claude Desktop, Claude Code, Cursor, and Windsurf. Public endpoints for search, item data, categories, and trends do not require an API key. An optional MERCADOLIBRE_ACCESS_TOKEN can be supplied for endpoints requiring authentication, including future premium features.

Tools and capabilities

The dan1d/mercadolibre-mcp MCP server provides these tools:

• search_items searches by keyword with site, category, price, and result-limit inputs.
• get_item returns core listing details, including seller and stock information.
• get_item_description retrieves an item's complete description.
• get_categories lists top-level categories for a site.
• get_category returns category metadata, its root path, and child categories.
• get_seller_info retrieves reputation, ratings, and transaction statistics.
• get_trends returns current searches trending on a selected site.
• get_currency_conversion converts amounts using MercadoLibre exchange rates.

Limitations and notes

The documented unauthenticated coverage is limited to public search, item, category, and trend endpoints. Authentication is described as optional for endpoints that require it, rather than as a prerequisite for the listed public tools. Currency conversion uses MercadoLibre exchange rates, and results depend on the selected currencies and current rate data. The server provides marketplace information and lookup tools; the material does not describe checkout, purchasing, payment, order management, or listing creation features.