About mcp-mercado-libre
mcp-mercado-libre is an MCP server for Mercado Libre, a large Latin American marketplace. It is aimed at sellers and developers who want to automate listings, orders and shipments through an MCP client. It supports product search, listing updates and post-sale messaging.
Key features
- 01Product search and detail lookup
- 02Category browsing and category prediction
- 03Listing stock, status and price updates
- 04Order and shipment tracking queries
- 05Post-sale buyer and seller messaging
- 06Product question and review access
Use cases
- 01Updating listing stock or prices from an AI assistant
- 02Checking order status and retrieving shipping labels
- 03Answering buyer questions on product listings
MCP support
This is an MCP server that exposes 22 tools to MCP clients, covering products, categories, orders, shipments and post-sale messages.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y @codespar/mcp-mercado-libreMELI_ACCESS_TOKENSecretAPI key/token for mercado-libreLocal servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
22Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| sort | enum | No | Sort orderrelevance | price_asc | price_desc |
| limit | number | No | Results limit (max 50) |
| query | string | Yes | Search query |
| offset | number | No | Results offset |
| category | string | No | Category ID filter |
| maxPrice | number | No | Maximum price |
| minPrice | number | No | Minimum price |
Details
From the project README@codespar/mcp-mercado-libre
MCP server for Mercado Libre — largest LATAM marketplace with 100M+ users across 18 countries
Quick Start
Claude Desktop
{
"mcpServers": {
"mercado-libre": {
"command": "npx",
"args": ["-y", "@codespar/mcp-mercado-libre"],
"env": {
"MELI_ACCESS_TOKEN": "your-access-token"
}
}
}
}
Claude Code
claude mcp add mercado-libre -- npx @codespar/mcp-mercado-libre
Tools (22)
| Tool | Purpose |
|---|---|
search_products | Search products in Mercado Libre marketplace |
get_product | Get detailed product information by item ID |
get_product_description | Get product description text by item ID |
list_categories | List all marketplace categories for the site |
get_category | Get category details and children |
predict_category | Predict the best category for a product title (domain_discovery) |
get_trends | Get trending searches in the marketplace |
list_listings | List seller's active product listings |
update_item | Update item fields such as available_quantity (stock), status (active/paused/closed), price, or title |
get_seller | Get seller information and reputation |
list_orders | List seller orders with filters |
get_order | Get order details by ID |
get_user | Get authenticated user information |
get_shipment | Get shipment details |
get_shipment_history | Get tracking history (status changes) for a shipment |
get_shipping_label | Get shipping labels (PDF or ZPL) for one or more shipments. |
list_questions | List questions on a product listing |
answer_question | Answer a question on a product listing |
list_messages | List post-sale conversation messages between seller and buyer for an order pack |
send_message | Send a post-sale message to the buyer associated with an order pack |
list_reviews | List reviews and rating average for a product |
create_promotion | Create a price discount promotion for an item (PRICE_DISCOUNT) |
Authentication
Mercado Libre uses OAuth2. Get your access token from the Developers Portal.
Environment Variables
| Variable | Required | Description |
|---|---|---|
MELI_ACCESS_TOKEN | Yes | OAuth2 access token |
MELI_SITE_ID | No | Site 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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.