Mcp Mercado Libre

io.github.codesparPublished by GitHub account codesparv0.2.2Updated Oct 24, 2026

Mercado Libre — LATAM marketplace, product search, orders, sellers, shipments

VerifiedSTDIODesktop onlyProductivity & WorkflowBusiness & Commerce

Overview

AI-generated overview

Local MCP server for Mercado Libre that lets an assistant search products, inspect sellers and orders, track shipments, and manage listings and buyer messages.

What you can do
Search and read marketplace catalog data: products, descriptions, categories, trends and reviews, plus category prediction for a title. Manage a seller's listings: list active items and update price, stock, title or status. Review orders and sellers: list and read orders, seller reputation and the authenticated user. Track shipments: shipment details, status history and shipping labels. Handle buyer interaction: list and answer listing questions, read and send post-sale messages. Run promotions: create a price discount promotion for an item.
When to use it
Useful when an assistant needs to work with a Mercado Libre seller account or research the LATAM marketplace: catalog lookups, stock and price updates, order and shipment follow-up, answering buyer questions, or creating discounts.
Requirements
Runs locally via npx from the npm package, so Node.js is needed. Requires an OAuth2 access token from the Mercado Libre Developers Portal, supplied as the MELI_ACCESS_TOKEN environment variable. An optional MELI_SITE_ID selects the site (default MLB for Brazil; MLA for Argentina, MLM for Mexico). Network access to Mercado Libre APIs.
Before you install
The access token is a secret tied to a seller account; keep it out of shared configs. Several tools change live marketplace data: update_item alters price, stock, title or status, answer_question and send_message contact buyers, and create_promotion creates discounts. Shipping labels may contain buyer personal data. The README mentions an enterprise offering with payment routing, but this server itself declares no payment tools.

Installation

In SourceWeft

  1. Open Mcp Mercado Libre in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@codespar/mcp-mercado-libre

MCP server for Mercado Libre — largest LATAM marketplace with 100M+ users across 18 countries

[npm] [License: MIT]

Quick Start

Claude Desktop

json
{  "mcpServers": {    "mercado-libre": {      "command": "npx",      "args": ["-y", "@codespar/mcp-mercado-libre"],      "env": {        "MELI_ACCESS_TOKEN": "your-access-token"      }    }  }}

Claude Code

bash
claude mcp add mercado-libre -- npx @codespar/mcp-mercado-libre

Tools (22)

ToolPurpose
search_productsSearch products in Mercado Libre marketplace
get_productGet detailed product information by item ID
get_product_descriptionGet product description text by item ID
list_categoriesList all marketplace categories for the site
get_categoryGet category details and children
predict_categoryPredict the best category for a product title (domain_discovery)
get_trendsGet trending searches in the marketplace
list_listingsList seller's active product listings
update_itemUpdate item fields such as available_quantity (stock), status (active/paused/closed), price, or title
get_sellerGet seller information and reputation
list_ordersList seller orders with filters
get_orderGet order details by ID
get_userGet authenticated user information
get_shipmentGet shipment details
get_shipment_historyGet tracking history (status changes) for a shipment
get_shipping_labelGet shipping labels (PDF or ZPL) for one or more shipments.
list_questionsList questions on a product listing
answer_questionAnswer a question on a product listing
list_messagesList post-sale conversation messages between seller and buyer for an order pack
send_messageSend a post-sale message to the buyer associated with an order pack
list_reviewsList reviews and rating average for a product
create_promotionCreate a price discount promotion for an item (PRICE_DISCOUNT)

Authentication

Mercado Libre uses OAuth2. Get your access token from the Developers Portal.

Environment Variables

VariableRequiredDescription
MELI_ACCESS_TOKENYesOAuth2 access token
MELI_SITE_IDNoSite ID (default: MLB for Brazil). Use MLA for Argentina, MLM for Mexico.

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

Source: packages/payments/mercado-libre/README.md at commit d0a519a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts