mercadolibre-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ML_SITE | Yes | MercadoLibre site code (e.g., MLC for Chile) | |
| ML_APP_ID | Yes | Your MercadoLibre App ID | |
| ML_APP_SECRET | Yes | Your MercadoLibre Secret Key | |
| ML_SOLO_LECTURA | No | Set to "1" to enable read-only mode. Remove this line to allow write operations. | |
| ML_TRABAJADORES_WEBHOOK | No | Optional webhook for notifications; disabled by default. |
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 |
|---|---|
| ml_conectarB | Vincula una cuenta de MercadoLibre. Sin argumentos devuelve la URL para autorizar en el navegador; con |
| ml_cuentasB | Lista las cuentas de MercadoLibre conectadas (soporta varias tiendas). Con |
| ml_desconectarA | Elimina los tokens guardados de una cuenta (deja de estar conectada en esta computadora). |
| ml_versionA | Muestra la versión instalada del conector, chequea si hay una actualización publicada y explica cómo actualizar. |
| ml_ordenesA | Lista las ventas (órdenes) del vendedor, de la más reciente a la más vieja. Filtrable por fecha y estado. |
| ml_panel_ventasA | El tablero del vendedor en una llamada: facturación de HOY y del MES, productos más vendidos del mes, reparto por método de envío (FULL/Flex/Colecta...) y dónde se concentran las ventas por provincia. Ideal para "¿cómo venimos hoy?" o el panel del mes. |
| ml_metricasA | Facturación, unidades y ticket promedio de un período, comparado contra el período anterior. Ideal para "¿cómo vienen las ventas?". Con cuenta="todas" consolida todas las tiendas conectadas. |
| ml_enviosB | Estado del envío de una orden: tracking, estado y fechas. |
| ml_publicacionesB | Lista las publicaciones del vendedor con precio, stock y estado. |
| ml_publicacionB | Detalle completo de una publicación: precio, stock, ventas, tipo, garantía, envío, link. |
| ml_visitasA | Visitas de una publicación en una ventana de días, para medir tráfico y conversión. |
| ml_actualizar_publicacionA | MODIFICA una publicación real: precio, stock o estado (pausar/activar). Usar solo con confirmación explícita del usuario. |
| ml_crear_publicacionA | CREA una publicación real en la tienda. Con |
| ml_preguntasC | Preguntas de compradores; por defecto las pendientes de respuesta. |
| ml_responder_preguntaA | PUBLICA una respuesta real y visible a una pregunta de comprador. Irreversible: usar solo con el texto confirmado por el usuario. |
| ml_comisionesA | Cuánto cobra MercadoLibre por vender a un precio dado (comisión por tipo de publicación), para calcular márgenes. |
| ml_precio_catalogoB | Para publicaciones de catálogo: si estás ganando la buy box y qué precio necesitás para ganarla. |
| ml_buscarB | Busca publicaciones públicas en MercadoLibre (para espiar competencia y precios de mercado). |
| ml_reputacionC | Color de reputación, ventas y tasas de reclamos, demoras y cancelaciones. |
| ml_promocionesB | Campañas y promociones que MercadoLibre le ofrece al vendedor; con promocion_id y tipo, lista las publicaciones elegibles con su descuento. |
| ml_aceptar_promocionA | ACTIVA una publicación dentro de una promoción de MercadoLibre, al precio indicado. Visible para compradores: usar solo con confirmación explícita por ítem. |
| ml_auditar_publicacionesA | Lista las publicaciones del vendedor con un semáforo de calidad y cómo mejorar cada una: título corto o con relleno, pocas fotos, sin descripción, sin envío gratis, stock crítico, catálogo perdido, publicación pausada. Devuelve las peores primero con la acción concreta. Ideal para "¿qué publicaciones tengo que mejorar?". |
| ml_cerebroA | La base de datos local del negocio: guarda lo que el vendedor le enseña (costo de cada producto, % de impuestos, costo de envío, medidas, qué incluye, notas) y las demás herramientas lo usan solas — la calculadora de rentabilidad deja de preguntar lo que ya sabe. Todo queda en un archivo local de la máquina del vendedor, nunca sale de ahí. Acciones: guardar, ver, olvidar. Para datos del negocio entero (ej impuestos de todas las ventas), guardar sin item_id. |
| ml_publicidadA | Métricas de Product Ads al momento de la consulta: con item_id, el detalle del anuncio de esa publicación (inversión, impresiones, clics, CTR, CPC, ACOS, unidades y facturación por ads); sin item_id, las campañas del anunciante con su estado, presupuesto y resultados. Parámetro dias para el período (1 = hoy, default 30). |
| ml_rentabilidadA | El desglose real peso por peso de un producto: precio de venta MENOS comisión de MercadoLibre (tarifa real del tipo de publicación) MENOS publicidad por unidad (gasto de Product Ads en vivo del período) MENOS impuestos MENOS costo de envío MENOS costo del producto = ganancia neta y margen. Pide lo que falta (costo e impuestos NUNCA se inventan) y dice hasta qué ACOS aguanta el producto. |
| ml_clipsA | Consulta los Clips (videos verticales cortos) de tus publicaciones por la API y dice cuáles sirven: con item_id muestra cada clip y su estado de moderación (publicado ✅, en revisión ⏳ 24-48 hs, rechazado ❌ con el motivo y cómo corregirlo); sin item_id recorre tus publicaciones activas y arma el mapa de video de la tienda (clips + video clásico) con cuáles priorizar. |
| ml_subir_clipA | Sube un Clip (video vertical corto) a una publicación por la API. Requisitos de MercadoLibre: MP4/MOV/MPEG/AVI, vertical, 10 a 61 segundos, mínimo 360x640, máximo 280 MB, publicación activa. La moderación tarda 24-48 hs (verificar después con ml_clips). |
| ml_borrar_clipA | Borra un clip de una publicación (por ejemplo uno rechazado, para subir la versión corregida). Funciona en cualquier estado de moderación. |
| ml_vigilarB | Administra la lista de seguimiento de competencia y tendencias (se guarda local). Tipos: vendedor (nickname o id de un competidor), publicacion (item_id ajeno o propio), busqueda (keyword para vigilar su top 10) y tendencias (sitio o categoría). Acciones: listar, agregar, quitar. |
| ml_novedades_competenciaA | Recorre toda la lista de seguimiento y reporta SOLO lo que cambió desde la última corrida: precios que subieron/bajaron, publicaciones nuevas o dadas de baja, ventas estimadas de competidores, cambios de líder en búsquedas y keywords que entraron/salieron de tendencias. Ideal como rutina semanal. |
| ml_trabajadoresA | El equipo de 5 trabajadores que vigilan solos y constantemente a tus seguidos (rivales, productos, búsquedas y tendencias): 🕵️ Vera (precios), 📦 Tomás (ventas de rivales y quiebres de stock), 🏆 Martina (ranking en búsquedas y tu puesto), 🎯 Bruno (rivales nuevos) y 📈 Sofía (tendencias). Cada uno tiene sus skills a cargo y cada alerta recomienda qué skill correr. Envían sus resultados a Google Drive (planilla en vivo o carpeta de Drive). Acciones: equipo (estado de todos), asignar (darle una tarea), quitar, pausar, activar, frecuencia (minutos), correr (que trabajen ya), informe (alertas nuevas), resultados (tablas con todo lo que sabe cada uno), drive (conectar Google Drive). Se puede nombrar al trabajador por su nombre (Vera) o puesto (precios). Si un trabajador no tiene tareas propias vigila tus seguidos de ml_vigilar de su tipo. |
| ml_historial_competenciaA | La base de datos de competencia: evolución en el tiempo de un objetivo vigilado — precio y ventas de una publicación rival, líder y precio líder de una búsqueda, o cantidad de publicaciones y precio mediana de un vendedor. Se alimenta sola con cada control de ml_novedades_competencia. |
| ml_descubrir_ganadoresA | Encuentra artículos ganadores dentro de lo que permite la API: por CATEGORÍA usa el ranking oficial de más vendidos (highlights) + las tendencias de esa categoría; por BÚSQUEDA analiza el mercado de una keyword (competencia, precios, envío gratis, vendedores que dominan y ventas visibles). Indicar categoria (id tipo MLA1234) o busqueda (keyword). |
| ml_tendenciasC | Las búsquedas más populares del sitio o de una categoría: qué está queriendo comprar la gente. |
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 34 tools
Each tool has a clearly distinct purpose and the descriptions include 'ideal for' hints that help an agent pick correctly (e.g. ml_panel_ventas vs ml_metricas vs ml_ordenes, ml_clips vs ml_subir_clip vs ml_borrar_clip). The only real overlap is the competition-intelligence cluster (ml_vigilar, ml_novedades_competencia, ml_historial_competencia, ml_trabajadores, ml_descubrir_ganadores, ml_tendencias, ml_buscar), where boundaries between 'watch', 'what changed', 'history', and 'discover winners' require close reading.
Every tool shares the ml_ prefix and Spanish snake_case, which is highly predictable. The only inconsistency is stylistic: some names are bare nouns for resource queries (ml_ordenes, ml_metricas, ml_publicaciones) while others are verb_objeto for actions (ml_crear_publicacion, ml_borrar_clip, ml_responder_pregunta), but this reads naturally and stays parseable.
34 tools is heavy and past the comfortable range; several could be consolidated (ml_trabajadores alone bundles nine actions, and the six competition tools could collapse into fewer verbs). The domain is genuinely broad (sales, listings, ads, pricing, clips, competition, profitability), so it isn't gratuitous, but the surface is borderline unwieldy for an agent.
Coverage is strong: auth/account lifecycle, orders, shipping status, listing CRUD, questions/answers, promotions, ads, fees, catalog buy-box, reputation, clips/video, and a local knowledge base feeding profitability. Minor gaps remain — no order-detail lookup, no returns/claims handling or buyer messaging, and listings can be paused/edited but not deleted.