Complete MCP server for Mercado Libre seller operations โ products, orders, pricing, stock, questions, ads, reputation, competitor analysis
---
name: mercadolibre-mcp
description: Complete MCP server for Mercado Libre seller operations โ products, orders, pricing, stock, questions, ads, reputation, competitor analysis
version: 1.0.0
metadata:
openclaw:
requires:
env:
- ML_CLIENT_ID
- ML_CLIENT_SECRET
- ML_REFRESH_TOKEN
bins:
- node
primaryEnv: ML_REFRESH_TOKEN
emoji: "๐"
homepage: https://github.com/MarcosNahuel/mercadolibre-mcp
---
# Mercado Libre MCP Server
The first complete MCP server for Mercado Libre. 11 tools for seller operations โ manage products, orders, pricing, stock, customer questions, advertising, reputation, and competitor intelligence.
## Setup
Two authentication modes:
### Option A: Direct token (recommended if you have n8n/cron managing refresh)
```
ML_ACCESS_TOKEN=APP_USR-...
ML_SITE_ID=MLA
```
### Option B: Auto-refresh (standalone, no external dependencies)
1. Create an app at [developers.mercadolibre.com](https://developers.mercadolibre.com)
2. Authorize via OAuth to get your refresh token
3. Set environment variables:
```
ML_CLIENT_ID=your_client_id
ML_CLIENT_SECRET=your_client_secret
ML_REFRESH_TOKEN=your_refresh_token
ML_SITE_ID=MLA
```
## Tools
### Read operations
- **list_products** โ List all products/listings for a seller with price, stock, status, and thumbnails
- **get_orders** โ Get orders/sales with buyer info, items, shipping, and payment details
- **list_questions** โ List questions received on listings, filterable by status (unanswered/answered)
- **get_item_metrics** โ Get visits, health score, conversion rate, and catalog status for a listing
- **get_reputation** โ Get seller reputation: level, completed sales, claims, cancellations, handling time
- **search_competitors** โ Search competitor products by keyword with price, seller, sales volume
- **get_categories** โ Browse ML categories and required attributes for publishing
### Write operations
- **update_price** โ Update listing price (returns before/after for confirmation)
- **update_stock** โ Update available quantity (returns before/after for confirmation)
- **answer_question** โ Answer a buyer question (public, visible to all buyers)
- **manage_ads** โ Activate, pause, or check status of Product Ads
## Supported countries
Works with all Mercado Libre sites: MLA (Argentina), MLU (Uruguay), MLB (Brazil), MLC (Chile), MLM (Mexico), MCO (Colombia), and more.
## Features
- **OAuth2 auto-refresh** โ Token renews automatically every 6 hours
- **Rate limiting** โ Automatic retry with backoff when hitting API limits
- **Multi-get batching** โ Fetches multiple items in batches of 20
- **Zod validation** โ All inputs validated before calling the API
- **Clear error messages** โ Human-readable errors in Spanish, not raw JSON
## Example prompts
- "List my active products"
- "Show me today's orders"
- "Update the price of MLA123456 to $5000"
- "What unanswered questions do I have?"
- "Search competitors for brake pads Toyota"
- "What category should I use for motorcycle parts?"
- "Activate ads on MLA123456 with $500/day budget"
- "How is my seller reputation?"
## License
MIT โ by [TRAID](https://traid.ai)
don't have the plugin yet? install it then click "run inline in claude" again.