Mercado Libre MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ML_SITE_ID | No | Mercado Libre site ID (MLA, MLU, MLB, MLC, MLM, MCO, CBT) | MLA |
| ML_AUTH_MODE | No | Force auth mode; e.g. 'standalone' forces auto-refresh even when Supabase is configured (to use the lease). | |
| ML_CLIENT_ID | No | Mercado Libre app client ID (Opción C: auto-refresh standalone) | |
| SUPABASE_URL | No | URL of your Supabase project (Opción A: multi-tenant auth), e.g. https://YOUR_PROJECT.supabase.co | |
| GCP_PROJECT_ID | No | Enables flows that use Vertex Gemini. Without this, W3.* flows start disabled. | |
| ML_TOKEN_TABLE | No | Name of the tokens table in Supabase (Opción A) | oauth_tokens |
| ML_ACCESS_TOKEN | No | Direct Mercado Libre access token (Opción B: token directo), e.g. APP_USR-... | |
| ML_ACCOUNT_LABEL | No | Account label used to look up the token row (Opción A), e.g. 'miami' | |
| ML_CLIENT_SECRET | No | Mercado Libre app client secret (Opción C: auto-refresh standalone) | |
| ML_REFRESH_TOKEN | No | Mercado Libre refresh token (Opción C: auto-refresh standalone) | |
| TRAID_CLIENT_SLUG | No | Slug of the current client in your knowledge base (e.g. 'mi-cliente'). Enables traid_client_context without args. | |
| TRAID_FLOWS_ENABLED | No | CSV of flow_* names to register. Default empty = only layers 0+1+2+4. | |
| SUPABASE_SERVICE_KEY | No | Supabase service role key (Opción A: multi-tenant auth) | |
| TRAID_DISABLE_LAYERS | No | CSV of layers to disable (official,ml,traid,flow) | |
| TRAID_KNOWLEDGE_MODE | No | Knowledge mode: 'bundled' (default; no base included since alpha.3, so traid_* tools return empty), 'filesystem' (reads your own base via TRAID_KNOWLEDGE_PATH), 'pinecone' (v1.3). | bundled |
| TRAID_KNOWLEDGE_PATH | No | Path to your knowledge base (only used in 'filesystem' mode) | |
| ML_SKIP_UPSTREAM_PROXY | No | Set to 1 to disable the official ML MCP upstream proxy (Capa 0) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_productsB | Lista los productos/publicaciones de un vendedor en Mercado Libre. Retorna título, precio, stock, estado, link y thumbnail. |
| get_ordersA | Obtiene las órdenes/ventas de un vendedor. Incluye comprador, items, envío y pagos. |
| update_priceB | Actualiza el precio de una publicación en Mercado Libre. Retorna precio anterior y nuevo para confirmación. |
| update_stockA | Actualiza el stock/cantidad disponible de una publicación en Mercado Libre. Retorna stock anterior y nuevo. |
| list_questionsB | Lista las preguntas recibidas en publicaciones de Mercado Libre. Puede filtrar por item o estado (sin responder, respondidas). |
| answer_questionB | Responde una pregunta en Mercado Libre. La respuesta es pública y visible por todos los compradores. |
| get_item_metricsB | Obtiene métricas de una publicación: visitas, salud de publicación y datos de catálogo. |
| manage_adsC | Gestiona Product Ads de Mercado Libre: activar, pausar o consultar estado de publicidad de un item. |
| get_reputationA | Obtiene la reputación de un vendedor: nivel, ventas completadas, reclamos, cancelaciones y tiempo de despacho. |
| search_competitorsB | Busca productos de la competencia en Mercado Libre. Retorna top resultados con precio, vendedor, ventas y envío gratis. |
| get_categoriesA | Obtiene categorías de Mercado Libre y sus atributos. Útil para saber qué categoría usar al publicar y qué atributos son requeridos. |
| price_to_winA | Precio para ganar el buy-box / competencia de catálogo de una publicación en Mercado Libre (solo lectura). Devuelve precio actual, precio sugerido para ganar, estado de competencia, participación de visitas y boosts que afectan el ranking. |
| price_historyA | Historial de cambios de precio de una publicación de Mercado Libre (solo lectura). Devuelve los eventos de cambio de precio del item en una ventana de días, paginados. Requiere item_id; days/page/size son opcionales. |
| stockout_riskB | Riesgo de quiebre de stock por publicación: días de cobertura y velocidad de venta (unidades/día) sobre una ventana histórica. Read-only, calculado en vivo desde la API de Mercado Libre (órdenes + stock). Sin escrituras. |
| traid_feature_lookupA | Busca features reusables en la base de conocimiento configurada (TRAID_KNOWLEDGE_MODE=filesystem y TRAID_KNOWLEDGE_PATH; el paquete no trae ninguna base incluida). Devuelve top N matches con descripción, cómo reusar y trade-offs. Ej: query="repricing". |
| traid_client_contextA | Devuelve metadata operativa del cliente TRAID actual (seller_ids, schema Supabase, n8n folder, repos, bloqueantes pendientes). Si no se pasa slug, usa TRAID_CLIENT_SLUG env var (auto-detect). Usar al arrancar sesión Claude en un proyecto cliente para cargar contexto sin parsear archivos. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 16 tools
Most tools target clearly distinct resources (orders, metrics, ads, reputation, questions) or actions (update_price, update_stock, answer_question). The price cluster (price_to_win vs price_history vs update_price) and stockout_risk vs get_item_metrics require reading descriptions to distinguish, but each still has a distinct purpose.
The majority follow a verb_noun snake_case pattern (get_orders, update_price, list_questions, answer_question). However, price_to_win, price_history, and stockout_risk are noun-phrase names without verbs, and the traid_* tools introduce a separate prefix, giving a mixed convention.
16 tools is at the upper end but each maps to a concrete seller workflow (sales, metrics, ads, reputation, pricing, stock, questions). The set is coherent and mostly earns its count, though the two traid_* tools feel somewhat unrelated to the core Mercado Libre domain.
The seller analytics/management surface is strong (orders, listings, pricing, stock, questions, competitors), but there is no tool to publish/create a listing despite get_categories describing attributes needed 'al publicar', and no order fulfillment or shipping operations. These are notable gaps for a full seller lifecycle.