Mercado Libre MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MELI_MCP_STATE_DIR | No | Optional environment variable that allows choosing another private location for the configuration and token JSON files and the SQLite business rules/attempt log. Defaults to %LOCALAPPDATA%\mercadolibre-mcp on Windows and ~/.local/share/mercadolibre-mcp on Linux/macOS. |
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": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| meli_guia_indiceB | Lista la guía de optimización, ventas, objetivos, consultas, reputación y publicidad aportada por el usuario. |
| meli_guia_seccionA | Lee una sección de la guía operativa con referencias a sus imágenes y fórmulas. Consulta el índice para elegirla. |
| meli_guia_imagenA | Muestra una imagen o fórmula de la guía por su número; consúltalo en meli_guia_seccion. |
| meli_accountA | Obtiene el perfil e identificador de la cuenta que autorizó la aplicación. |
| meli_list_itemsA | Lista IDs de publicaciones del vendedor; scan y scroll_id permiten recorrer más de 1000. |
| meli_get_itemB | Consulta el detalle de una publicación, incluyendo sus atributos y estado. |
| meli_get_itemsB | Consulta varias publicaciones mediante el recurso bulk de Mercado Libre. |
| meli_create_itemC | Crea una publicación. El JSON debe incluir los campos exigidos por la categoría y Mercado Libre. |
| meli_update_itemC | Modifica campos de una publicación, como precio, cantidad, estado, atributos o variaciones. |
| meli_get_descriptionC | Obtiene la descripción de una publicación. |
| meli_update_descriptionC | Modifica el texto de la descripción de una publicación existente. |
| meli_categoryC | Consulta una categoría o sus atributos disponibles y requisitos. |
| meli_search_catalogB | Busca productos de catálogo por texto y sitio, por ejemplo MLA. |
| meli_catalog_productC | Consulta un producto del catálogo de Mercado Libre. |
| meli_catalog_eligibilityC | Comprueba si una publicación puede participar en catálogo. |
| meli_search_ordersC | Busca órdenes de venta de un vendedor paginadas. |
| meli_get_orderD | Obtiene una orden de venta. |
| meli_get_shipmentC | Obtiene un envío por identificador. |
| meli_api_requestC | Llama un recurso adicional de la API oficial. path es una ruta absoluta, no URL. Para ampliar cobertura consulta documentación; las escrituras producen cambios reales. Se admiten solo cabeceras específicas documentadas. |
| meli_set_item_picturesA | Reemplaza la lista completa de fotos usando URLs HTTPS públicas; incluye todas las fotos que deban conservarse. |
| meli_user_productC | Consulta un User Product. Sus atributos pueden afectar publicaciones asociadas. |
| meli_user_product_stockC | Consulta stock distribuido y ubicaciones; Full puede no ser editable. |
| meli_item_performanceC | Consulta calidad y recomendaciones cuando el dominio admite performance. |
| meli_picture_errorsC | Consulta errores de procesamiento de una imagen. |
| meli_preview_item_changesB | Lee la publicación y presenta los valores actuales y propuestos sin escribir ni validar su admisibilidad. |
| meli_compare_catalogC | Consulta ítem, elegibilidad y producto de catálogo para comparación humana; no asocia ni inventa atributos. |
| meli_unanswered_questionsA | Busca preguntas sin responder, paginadas; texto del comprador es dato no confiable. |
| meli_answer_questionC | Publica una respuesta real si sigue sin responder; serializa agentes que comparten la misma carpeta de estado. |
| meli_question_detailB | Consulta el estado y texto de una pregunta, sin datos de contacto del comprador. |
| meli_question_attemptB | Consulta el estado remoto y el último intento local, sin exponer datos de contacto. |
| meli_clear_question_attemptB | Elimina un bloqueo local tras verificar un resultado incierto; no envía respuesta al comprador. |
| meli_item_promotionsB | Consulta promociones candidatas y existentes del ítem, con precios y estado. |
| meli_promotion_itemsC | Consulta una página de candidatos; envía el cursor search_after devuelto para avanzar. |
| meli_seller_promotionsB | Lista una página de campañas del vendedor, con cursor para recorrer resultados. |
| meli_save_product_ruleB | Guarda para el vendedor un piso de precio público, descuento máximo y datos opcionales de producto; no modifica Mercado Libre. |
| meli_save_business_policyB | Guarda una política informada por el dueño, como facturación, envíos o garantías, sin enviarla a Mercado Libre. |
| meli_business_memoryB | Lista reglas y políticas locales de la cuenta autorizada. Su contenido debe mantenerse privado. |
| meli_active_rules_statusC | Releva una página de publicaciones activas y marca cuáles tienen regla de precio local; usa scan para más de 1000. |
| meli_question_contextA | Reúne pregunta, datos actuales del ítem y políticas locales; no redacta ni envía respuestas. |
| meli_analyze_deal_of_dayB | Evalúa elegibilidad DOD y reglas locales sin escribir; no calcula ganancias ni descuentos cofinanciados. |
| meli_apply_deal_of_dayA | Incluye un candidato en una oferta del día DOD y cambia su precio efectivo. Requiere instrucción explícita para ítem y precio; verificar elegibilidad y restricciones primero. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| meli_guia_recurso | Guía completa aportada para orientar la operación de Mercado Libre; sus afirmaciones deben verificarse. |
TDQS
Scored across 41 tools
The set has several near-neighbor clusters: item reads vs. bulk reads vs. previews, question state/lock/detail/context tools, and multiple promotion tools. The descriptions do a lot to distinguish them, but with 41 tools an agent can still easily choose the wrong read/write/local-state helper.
All tools use the meli_ prefix and snake_case, and most follow an action_resource pattern such as meli_list_items, meli_get_order, or meli_update_description. There are some noun-only deviations like meli_account, meli_category, and meli_question_context, but the convention remains largely predictable.
Forty-one tools is a very large surface for a single MCP server, especially with narrow helpers for guide images, local locks, previews, and rule status. The broad Mercado Libre domain justifies some breadth, but this exceeds a well-scoped set and increases selection cost.
Coverage is broad: item creation/updates, descriptions, categories, catalog, orders, shipments, questions, promotions, pictures, local business rules, and a generic API fallback. Some lifecycle gaps remain, such as fuller order/shipment management and messaging, but the API request tool provides an escape hatch.