Skip to main content
Glama
kokesaurio
by kokesaurio

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
ML_APP_IDYesYour MercadoLibre application App ID from the DevCenter.
ML_APP_SECRETYesYour MercadoLibre application Secret Key from the DevCenter.
ML_SOLO_LECTURANoSet to 1 to disable write tools and run in read-only mode. Optional.

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

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
ml_conectarA

Vincula una cuenta de MercadoLibre. Sin argumentos devuelve la URL para autorizar en el navegador; con code (el código que muestra la página al autorizar) completa la conexión. Requiere ML_APP_ID y ML_APP_SECRET configurados.

ml_cuentasB

Lista las cuentas de MercadoLibre conectadas (soporta varias tiendas). Con predeterminada fija cuál usar cuando no se indica cuenta.

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 copiar_de clona una publicación existente (título, categoría, atributos, fotos, descripción) y permite pisar título/precio/stock — ideal para duplicar entre tus propias cuentas. Usar solo con confirmación explícita del usuario.

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_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_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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

B3.2/5.0

Scored across 32 tools

Disambiguation4/5

Most tools have clearly distinct purposes, especially around publications, orders, promotions, ads, clips, and competition tracking. Some analytical tools (ml_panel_ventas, ml_metricas, ml_rentabilidad, ml_publicidad) and market-research tools (ml_buscar, ml_descubrir_ganadores, ml_tendencias) have adjacent scopes, but the descriptions generally distinguish them well.

Naming Consistency4/5

All tools use a consistent ml_ prefix and lower snake_case, which is easy to scan. The main deviation is that read tools are mostly noun-only (ml_ordenes, ml_publicaciones) while mutating tools use verb_noun (ml_actualizar_publicacion, ml_responder_pregunta), but this pattern is still fairly predictable.

Tool Count2/5

With 32 tools, the server is well beyond the ideal 3-15 range and exceeds the 25+ threshold for being heavy. The domain is broad, so not every tool is unjustified, but the set would benefit from consolidation or grouping.

Completeness4/5

The surface covers connection, accounts, sales, shipping, publication lifecycle, questions, promotions, ads, profitability, clips, and competition research. It is very broad, with only minor gaps such as a dedicated order-detail tool or hard-delete publication operation.

Maintenance

ActivityMaintained
ResponsivenessNo issues