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)#

text

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
2. Authorize via OAuth to get your refresh token
3. Set environment variables:

text

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