Skip to main content
Glama

MCP MercadoLibre — conectá MercadoLibre con Claude AI

MCP Node License Herramientas

Servidor MCP (Model Context Protocol) de MercadoLibre para Claude. Conectá tu cuenta de MercadoLibre a Claude AI y consultá ventas, facturación, rentabilidad real, stock, publicaciones, preguntas de compradores, reclamos, reputación, Product Ads y precios de la competencia — todo en lenguaje natural, desde el chat.

Es multitienda de fábrica: si tenés varias cuentas de MercadoLibre, el resumen del día y las métricas llegan sumadas, con el aporte de cada tienda al total. No hay que preguntar cuenta por cuenta.

Compatible con Claude Desktop, Claude Code y cualquier cliente MCP. Funciona como conector local (stdio) o como conector remoto con OAuth 2.1. Pensado para vendedores de MercadoLibre Argentina, México, Brasil, Chile y Colombia.

Palabras clave: MCP MercadoLibre · MercadoLibre API · Claude AI MercadoLibre · conector MCP · Model Context Protocol · automatizar MercadoLibre · ERP MercadoLibre · analytics MercadoLibre · rentabilidad MercadoLibre · MercadoLibre Claude Desktop

No es un panel más. Es la capacidad de preguntar lo que quieras sobre tu cuenta y que alguien cruce los datos por vos.

"¿Cómo viene el día?"
"¿Cuánta plata tengo por acreditar esta semana?"
"¿Qué se me está por quedar sin stock antes del finde?"
"El set de mates dejó de vender, ¿por qué?"
"¿Estoy caro contra la competencia en los productos que más facturan?"
"Contestá las preguntas pendientes, pero mostrame los textos antes"
"¿Cuánto gano realmente con cada venta después de comisión, envío e impuestos?"

Contenido


Related MCP server: MercadoLibre MCP Server

Qué problema resuelve

MercadoLibre te da paneles sueltos: uno de ventas, uno de publicidad, uno de reputación, uno de stock en Full. Ninguno te contesta las preguntas que importan, porque esas preguntas cruzan dos o tres paneles a la vez.

"¿Por qué cayó la facturación este mes?" no está en ningún reporte. La respuesta puede ser que perdiste la caja de compra en tres publicaciones de catálogo, que un competidor bajó el precio, que se te agotó el stock en Full de tu producto estrella, o que subió el ACOS de la pauta y dejaste de ser rentable. Sacar eso a mano son cuarenta minutos de pestañas.

Este conector le da a Claude las 32 puertas de entrada a esos datos, y Claude arma el cruce solo.


Cómo funciona

Claude ──MCP──> este servidor ──HTTP+JWT──> CRM Algoritmo Digital ──OAuth──> API MercadoLibre
                      │                            │
              formatea en markdown          sincroniza, cachea,
              y acota los resultados        calcula rentabilidad real

El conector no habla directo con la API de MercadoLibre, y eso es a propósito:

  • Sin rate limit. MercadoLibre limita fuerte las llamadas. El CRM ya sincroniza y cachea, así que Claude consulta una base local y responde al instante, sin quemar cuota ni arriesgar un 429 en medio de una conversación.

  • Datos que la API no te da. La rentabilidad real necesita el costo de tus productos, tu situación fiscal y el histórico de comisiones. Eso vive en el CRM, no en MercadoLibre.

  • Multicuenta resuelto. El OAuth, el refresh de tokens y el manejo de varias cuentas ya están hechos del lado del CRM.

  • Histórico. Cambios de precio, visitas y reputación acumulados en el tiempo, algo que la API solo devuelve como foto del momento.

Cada herramienta devuelve markdown ya formateado —tablas legibles, pesos argentinos, fechas locales, listas acotadas— en lugar de JSON crudo. Baja mucho el consumo de contexto y hace que Claude razone sobre los números, no sobre la forma del JSON.


Todo lo que hace

Las 33 herramientas MCP que este servidor le expone a Claude, agrupadas por lo que resuelven. Cada una es una consulta que podés hacer en lenguaje natural.

Cuenta y sincronización

Herramienta

Qué devuelve

ml_cuentas

Cuentas de MercadoLibre vinculadas, con su ID interno, el user_id de ML, si están activas y desde cuándo. Además el estado de la conexión: si la app está configurada y cuántas cuentas responden. Es el primer paso cuando manejás más de una cuenta, porque devuelve el ID que el resto de las herramientas usa para filtrar.

ml_conectar

Genera el link de autorización para vincular una tienda nueva y muestra las que ya están conectadas. Con diagnostico: true revisa la configuración punto por punto y te dice exactamente qué falta. No autoriza nada solo: devuelve el link para que lo abras vos.

ml_sincronizar

Fuerza una sincronización de órdenes, publicaciones y preguntas contra la API oficial. El sistema ya sincroniza solo cada media hora; esto es para cuando necesitás el dato de hace dos minutos.

Ventas y plata

Herramienta

Qué devuelve

ml_panel

El resumen consolidado de todas tus tiendas. Ventas, facturación y unidades del día sumando cada cuenta conectada, la comparación contra ayer a la misma hora, la tabla tienda por tienda con el aporte de cada una al total, la curva de ventas por hora y las últimas ventas mezcladas. Si le pasás una cuenta, muestra solo esa. Es por donde conviene empezar.

ml_metricas

Los últimos 30 días sumando todas las tiendas, con el desglose de cuánto aportó cada una: cantidad de ventas, facturado bruto, neto después de comisiones, ticket promedio, cuántas publicaciones tuvieron al menos una venta, el desglose por tipo de envío (Full, Flex, colecta, a acordar) y el top 12 de productos por facturación con unidades y si están en Full.

ml_ordenes

Las últimas 100 ventas, una por fila: fecha y hora, número de orden, comprador, total, comisión que se llevó MercadoLibre, neto, estado de la venta, estado del pago y la fecha en que ese dinero se acredita.

ml_caja

Tres modos. dia: cuánto acredita una fecha puntual, cuánto ya está liberado y cuánto falta. rango: los últimos 14 días día por día. proyeccion: todo lo que todavía no se acreditó, con la fecha de cada acreditación futura. Es la herramienta para "¿cuándo cobro?" y "¿me alcanza para pagarle al proveedor el jueves?".

ml_facturacion

Facturación y comisiones agregadas por el período que pidas, hasta 365 días. Pensada para conciliar contra AFIP o armar un cierre de mes.

ml_rentabilidad

La más importante y la que ningún panel de ML te da. Margen real después de comisión, costo de envío, costo del producto e impuestos. Modo periodo para un rango puntual (o por días), modo mensual para la serie mes a mes con margen en pesos y en porcentaje. Avisa si todavía faltan sincronizar costos, para que no leas un número incompleto como si fuera definitivo.

ml_ventas_geo

Ventas y monto por provincia. Sirve para decidir dónde conviene un depósito, cómo negociar envíos o dónde pautar.

ml_embudo

Por publicación: visitas, preguntas que generó y ventas que cerró, con la tasa de conversión. Muestra en qué escalón se cae cada producto.

Publicaciones, precios y stock

Herramienta

Qué devuelve

ml_publicaciones

El catálogo con precio, stock, unidades vendidas, estado y link. Acepta una búsqueda por título o por código MLA.

ml_actualizar_publicacion

✍️ Escribe en MercadoLibre. Cambia precio, stock, título o estado (activar / pausar / cerrar) de una publicación. El cambio es inmediato y visible para los compradores.

ml_stock

Modo bajo: publicaciones por debajo del umbral que le pases. Modo full: panorama del stock en Fulfillment con días de cobertura estimados y riesgo de quiebre, que es lo que te avisa antes de quedarte sin stock, no después.

ml_salud_publicaciones

El puntaje de calidad que MercadoLibre le pone a cada publicación y, sobre todo, las tareas concretas para subirlo: faltan fotos, falta ficha técnica, falta garantía, la descripción es pobre. La salud impacta directo en el posicionamiento.

ml_rendimiento_publicaciones

Visitas contra ventas de los últimos 30 días, con la conversión de cada publicación. Detecta el caso más caro de todos: la que recibe tráfico y no vende, donde ya pagaste el costo de atraer al comprador.

ml_visitas

La serie histórica de visitas por publicación, para ver si el tráfico viene subiendo o cayendo.

ml_costos_publicaciones

Cuánto se lleva MercadoLibre de cada venta: comisión y costo de envío por publicación, agrupado por categoría. Es el número que hay que tener antes de fijar un precio.

ml_simular_precios

Aplica tus reglas de precio (porcentaje o monto fijo) sobre todo el catálogo y te muestra el precio nuevo y la diferencia de cada publicación sin tocar nada. Para ver el impacto de un aumento antes de aplicarlo.

Preguntas, mensajes y post-venta

Herramienta

Qué devuelve

ml_preguntas

Las preguntas de los compradores, filtrables por pendientes o respondidas, por publicación, por mes o por texto. Devuelve el ID que necesitás para contestar. Por defecto trae las pendientes, que es lo que quema.

ml_responder_pregunta

✍️ Escribe en MercadoLibre. Publica la respuesta, visible para cualquiera que entre a la publicación.

ml_preguntas_estadisticas

Tasa de respuesta, demora promedio en minutos, cuántas preguntas terminaron en venta y con qué tasa de conversión, qué publicaciones generan más preguntas y la distribución por hora del día. Con eso se decide en qué franja horaria hay que tener a alguien contestando.

ml_mensajes

La mensajería post-venta atada a cada orden, para detectar un reclamo antes de que se convierta en reclamo formal.

ml_reclamos

Reclamos abiertos, devoluciones en curso, cuáles afectan la reputación, cuáles tienen plazo de acción por vencer y cuánta plata hay en juego. Lo primero a mirar cuando el termómetro baja.

ml_reputacion

Color de reputación, nivel MercadoLíder, porcentaje de reclamos, cancelaciones y demoras de envío.

Inteligencia de mercado y competencia

Herramienta

Qué devuelve

ml_competidores

Los vendedores que estás monitoreando, con su reputación, cantidad de publicaciones, ventas estimadas y precio promedio.

ml_competitividad

Publicación por publicación: tu precio contra el del mercado, la diferencia en porcentaje y si estás compitiendo o quedaste afuera. La respuesta a "¿estoy caro?".

ml_mercado

Modo tendencias: las búsquedas que están creciendo en MercadoLibre. Modo categorias: las categorías relevantes para tu cuenta. Modo categoria: los más vendidos de una categoría puntual y su rango de precios. Sirve tanto para decidir qué publicar como para entender la estacionalidad.

ml_cambios_precio

Los movimientos de precio detectados, propios y de los competidores que seguís, con el antes, el después y la variación. Para reaccionar el mismo día a una baja de la competencia.

ml_publicidad

Product Ads: inversión, impresiones, clics, ACOS y ventas atribuidas por campaña. La pregunta que contesta es si la pauta te deja plata o te la come.

ml_promociones

Las promociones que MercadoLibre te ofrece —Hot Sale, ofertas del día, descuentos por campaña— y, si le pasás un ID, qué publicaciones tuyas son elegibles.

ml_catalogo

Para un producto de catálogo: quiénes compiten por la caja de compra, a qué precio, con qué envío, cuánto vendieron y quién la está ganando. La respuesta a "¿por qué no gano el catálogo?".

ml_alertas

Las alertas automáticas del sistema: quiebres de stock, bajas de precio de competidores, reclamos nuevos, publicaciones pausadas. Buen segundo paso después de ml_panel.

Las tres marcadas con ✍️ escriben de verdad en MercadoLibre. Están anotadas con destructiveHint, así que Claude te muestra qué va a hacer y espera confirmación. Se pueden apagar por completo con ALLOW_WRITE=0, dejando el conector en modo solo lectura.


Qué NO hace

Vale la pena ser explícito:

  • No crea publicaciones nuevas ni las elimina.

  • No despacha envíos ni imprime etiquetas.

  • No emite facturas (lee la configuración de factura electrónica, no factura).

  • No mueve plata: no retira, no transfiere, no cancela ventas.

  • No cambia la configuración de la cuenta de MercadoLibre.

  • No cierra reclamos ni negocia devoluciones.

Lo que escribe se limita a tres acciones acotadas: precio/stock/título/estado de una publicación, la respuesta a una pregunta, y disparar una sincronización.


Instalación

Cómo conectar MercadoLibre con Claude, en dos modos.

Opción A — local (stdio)

Para vos o tu equipo, corriendo en la máquina de cada uno.

Claude Desktop — claude_desktop_config.json:

{
  "mcpServers": {
    "mercadolibre": {
      "command": "npx",
      "args": ["-y", "github:kokesaurio/mercadolibre-algoritmodigital"],
      "env": {
        "CRM_BASE_URL": "https://tu-crm.ejemplo.com",
        "CRM_USERNAME": "tu-usuario",
        "CRM_PASSWORD": "tu-clave"
      }
    }
  }
}

Claude Code:

claude mcp add mercadolibre \
  -e CRM_BASE_URL=https://tu-crm.ejemplo.com \
  -e CRM_USERNAME=tu-usuario -e CRM_PASSWORD=tu-clave \
  -- npx -y github:kokesaurio/mercadolibre-algoritmodigital

Si la cuenta tiene 2FA, generá un JWT desde el panel y usá CRM_TOKEN en lugar de usuario y clave. Con ML_CUENTA fijás una cuenta de ML por defecto y te ahorrás pasarla en cada consulta.

Opción B — remoto (conector con OAuth)

Un solo servidor para todos tus clientes: cada uno lo agrega en Claude y se loguea con su propia cuenta de MercadoLibre (a través de la aplicación de ML de Algoritmo Digital). Nadie configura nada.

git clone https://github.com/kokesaurio/mercadolibre-algoritmodigital.git
cd mercadolibre-algoritmodigital
npm install
cp .env.example .env    # completar CRM_BASE_URL, PUBLIC_URL y OAUTH_SIGNING_SECRET
npm run start:http

Publicalo detrás de HTTPS (nginx, Caddy, Railway, Fly.io) y en Claude entrá a Configuración → Conectores → Agregar conector personalizado con la URL https://tu-dominio/mcp. Claude descubre solo el servidor de autorización, se registra, y redirige al usuario a MercadoLibre para autorizar con su cuenta.

Cómo funciona el login con MercadoLibre: cuando Claude manda al usuario a /authorize, el conector le pide al CRM la URL de autorización de ML y lo redirige ahí. El usuario aprueba con su cuenta de ML, MercadoLibre vuelve a {PUBLIC_URL}/ml/callback, y el conector le pasa el code al CRM, que lo canjea (guarda los tokens de ML de esa cuenta) y devuelve un JWT del panel limitado a esa cuenta. Si el CRM todavía no expone estos endpoints, el conector cae automáticamente al formulario clásico de usuario y clave.

Endpoints que debe exponer el CRM (públicos, con rate limit):

  • GET /api/auth/ml/url?redirect_uri=...&state=... → { "url": "https://auth.mercadolibre.com.ar/authorization?..." }. Validar que redirect_uri sea la del conector propio (allow-list).

  • POST /api/auth/ml con { "code", "redirect_uri" } → canjea el code contra https://api.mercadolibre.com/oauth/token con el app id/secret, hace upsert de la cuenta por user_id de ML, y responde { "token": "<JWT>", "nombre": "<nickname>" }. Importante: el JWT emitido tiene que quedar limitado a esa cuenta de ML (aislamiento multi-tenant), y en el DevCenter de MercadoLibre hay que agregar {PUBLIC_URL}/ml/callback a las redirect URIs de la aplicación.

Skills incluidas

En skills/ hay cinco skills listas para instalar en Claude (Configuración → Capacidades → Skills), pensadas para usarse con este conector:

Skill

Qué hace

mejorar-publicaciones-ml

Audita publicaciones con datos reales y propone mejoras de título, precio y stock

responder-preguntas-ml

Despacha preguntas de compradores con respuestas listas para aprobar

reporte-ventas-ml

Reporte ejecutivo del día/semana/mes con alertas urgentes primero

competencia-ml

Semáforo de posición de precios y recomendaciones validadas por margen

publicidad-ml

Analiza Product Ads (ACOS vs margen) y evalúa promociones

Panel de promociones

En panel/promociones.html hay una interfaz web autocontenida (un solo archivo, sin dependencias) para aceptar promociones de MercadoLibre en bloque sin regalar margen: lista las campañas ofrecidas, muestra por publicación cuánto pone el vendedor y cuánto co-fondea ML, filtra por una regla propia (descuento máximo, aporte mínimo de ML, precio mínimo) y acepta las seleccionadas con confirmación. Incluye modo demo con datos de ejemplo y modo oscuro. Se sirve como archivo estático (nginx) desde el mismo dominio del panel y se conecta siempre a través de la API de Algoritmo Digital.

Para la aceptación real y el modo automático, el CRM debe exponer:

  • POST /api/ml/promociones/:id/aceptar con { "cuenta", "tipo"?, "items": [{ "id", "precio" }] } → activa cada ítem en la promoción vía la API de ML y responde { "aceptados": [ids], "errores": [{ "id", "error" }] }.

  • GET y PUT /api/ml/promociones/regla?cuenta= con { "activa", "max_desc_vendedor", "min_aporte_meli", "precio_minimo" } — la regla que un cron del CRM ejecuta a diario para aceptar automáticamente lo que cumple.

Implementa OAuth 2.1 completo: registro dinámico de clientes (RFC 7591), PKCE S256 obligatorio, metadata de servidor de autorización (RFC 8414) y de recurso protegido (RFC 9728), access tokens de 1 hora y refresh tokens de 7 días.

Desarrollo en el entorno de Claude

El repo se puede desarrollar y probar completo sin CRM real ni VPS — pensado para trabajarlo con Claude o Claude Code: cloná, instalá y corré.

npm install
npm test      # suite E2E: OAuth completo, login con ML, fallback, stdio y herramientas (8 casos)
npm run dev   # CRM simulado (:9999, usuario demo/demo) + conector (:8787) para probar a mano

El CRM simulado vive en dev/entorno.js e incluye un MercadoLibre falso para el flujo de login, datos de ejemplo de las rutas principales y los endpoints de promociones. Regla para contribuir (humano o IA): cualquier cambio en src/ tiene que dejar npm test en verde, y las funcionalidades nuevas suman su caso a la suite.


Variables de entorno

Variable

Modo

Descripción

CRM_BASE_URL

ambos

Obligatoria. URL del backend, sin barra final

CRM_TOKEN

stdio

JWT del panel (alternativa a usuario/clave, necesaria con 2FA)

CRM_USERNAME / CRM_PASSWORD

stdio

Credenciales del panel

ML_CUENTA

stdio

ID de cuenta de ML por defecto

PORT

http

Puerto de escucha. Default 8787

PUBLIC_URL

http

URL pública con HTTPS. Debe coincidir con la real

OAUTH_SIGNING_SECRET

http

Secreto HMAC, mínimo 24 caracteres

STORE_FILE

http

Dónde persistir clientes y sesiones

ALLOW_WRITE

ambos

0 deja el conector en modo solo lectura


Estructura

src/
├── client.js          cliente HTTP del CRM: login, cache de JWT, reintento ante 401
├── format.js          tablas markdown, moneda ARS, fechas AR, truncado
├── server.js          arma el McpServer y registra las herramientas
├── oauth.js           servidor de autorización OAuth 2.1 (PKCE + registro dinámico)
├── stdio.js           bin: transporte stdio
├── http.js            bin: transporte Streamable HTTP + OAuth
└── tools/
    ├── sistema.js       cuentas y sincronización
    ├── ventas.js        panel, métricas, órdenes, caja, rentabilidad, geo, embudo
    ├── publicaciones.js catálogo, precios, stock, salud, rendimiento, costos
    ├── preguntas.js     preguntas, respuestas, mensajes, reclamos, reputación
    └── mercado.js       competidores, competitividad, tendencias, ads, catálogo

Desarrollo

npm install
npm run inspect      # MCP Inspector: probar las herramientas a mano
npm start            # stdio
npm run start:http   # HTTP + OAuth

Seguridad

  • Las credenciales no se guardan: en modo remoto se cambian por un JWT del CRM y solo se persiste ese token, asociado a un ID de sesión aleatorio.

  • Los access tokens se firman con HMAC-SHA256 y se comparan en tiempo constante.

  • PKCE S256 es obligatorio; sin code_verifier válido no se emite ningún token.

  • Los códigos de autorización son de un solo uso y vencen a los 5 minutos.

  • Cada request a /mcp construye un servidor y un cliente HTTP nuevos, sin estado compartido entre usuarios.

  • El health check no expone la URL del backend.

  • Las herramientas de escritura se apagan con ALLOW_WRITE=0.


Preguntas frecuentes

¿Qué es un servidor MCP?

MCP (Model Context Protocol) es el estándar abierto que usa Claude para conectarse a sistemas externos. Un servidor MCP le expone un conjunto de herramientas al modelo; Claude decide cuál usar según lo que le pidas. Es la forma oficial de darle a Claude acceso a datos privados sin subirlos a ningún lado.

¿Cómo conecto MercadoLibre con Claude?

Instalás este conector (local con npx, o remoto agregándolo como conector personalizado), le das la URL de tu backend y tus credenciales, y Claude ya puede consultar tu cuenta. La guía completa está en Instalación.

¿Necesito una app en el DevCenter de MercadoLibre?

No para este conector. El OAuth con MercadoLibre lo resuelve el CRM que está detrás, que es el que mantiene los tokens y sincroniza. Este servidor solo consulta ese CRM.

¿Funciona con Claude Desktop y con Claude Code?

Con los dos, y con cualquier cliente que hable MCP. En modo remoto también funciona desde Claude en el navegador y desde el celular.

¿Puede modificar mis publicaciones sin que yo lo sepa?

No. Las tres herramientas que escriben están marcadas como destructivas, así que Claude te muestra qué va a hacer y espera tu confirmación. Y podés dejarlo en modo solo lectura con ALLOW_WRITE=0.

¿Consume el rate limit de la API de MercadoLibre?

No. Las consultas van contra la base ya sincronizada del CRM, no contra MercadoLibre. Solo ml_sincronizar y las dos herramientas de escritura tocan la API oficial.

¿Sirve para MercadoLibre México, Brasil, Chile o Colombia?

Sí. La API de MercadoLibre es la misma para todos los sitios; lo que cambia es el site_id de la cuenta conectada. El formato de moneda y fecha está en pesos argentinos y se ajusta en src/format.js.

¿Puedo usarlo con varias cuentas de MercadoLibre?

Sí, y es el caso para el que está pensado. ml_panel y ml_metricas devuelven el consolidado de todas tus tiendas más el desglose de cada una, sin que tengas que pedirlas de a una. El resto de las herramientas acepta el parámetro cuenta cuando querés mirar una sola.

¿Cómo agrego una tienda nueva?

Le pedís a Claude que te conecte una tienda y usa ml_conectar, que te devuelve el link de autorización de MercadoLibre. Lo abrís, iniciás sesión con la cuenta manager y listo: la tienda nueva ya suma al consolidado.

¿Soporta WooCommerce o Tiendanube?

Todavía no por MCP. Este conector cubre MercadoLibre. WooCommerce está integrado en el CRM que está detrás pero no expuesto como herramientas; Tiendanube no tiene integración aún.

¿Los datos de mi cuenta pasan por algún servidor de terceros?

No. El conector corre donde vos lo pongas —tu máquina o tu servidor— y habla directo con tu backend. Claude recibe únicamente el resultado de cada consulta.


English summary

MCP server for MercadoLibre. Connect your MercadoLibre seller account to Claude AI and query sales, revenue, real profitability, inventory, listings, buyer questions, claims, seller reputation, Product Ads and competitor pricing in plain language.

33 tools across five areas: account management, sales and cash flow, listings and stock, buyer questions and after-sales, and market intelligence. Ships with two transports — stdio for local use with Claude Desktop and Claude Code, and Streamable HTTP with full OAuth 2.1 (dynamic client registration, PKCE S256) to run it as a hosted remote connector for multiple users.

Built for MercadoLibre sellers in Latin America. Documentation is in Spanish; the codebase and tool schemas are self-describing. MIT licensed.


MIT · Algoritmo Digital

Available Tools

33 tools
ml_actualizar_publicacionActualizar publicaciónA
Destructive

Modifica precio, stock, título o estado (active/paused) de una publicación EN MERCADOLIBRE. Es una escritura real y visible para los compradores: confirmá con el usuario antes de ejecutarla.

Inputs: item_id (required), stock, estado, precio, +1 more.

ml_alertasAlertas del sistemaA
Read-only

Alertas automáticas generadas por el sistema: quiebres de stock, caídas de precio de competidores, reclamos nuevos, publicaciones pausadas. Es un buen segundo paso después de ml_panel.

Inputs: cuenta.

ml_cajaCaja y acreditacionesA
Read-only

Dinero de MercadoLibre: modo "dia" = liberado y por entrar de una fecha; modo "rango" = últimos 14 días; modo "proyeccion" = plata que todavía no se acreditó, día por día. Usar cuando preguntan por plata disponible, cuándo cobran o cuánto entra esta semana.

Inputs: modo, fecha, cuenta.

ml_cambios_precioCambios de precio detectadosA
Read-only

Movimientos de precio recientes, propios y de competidores monitoreados. Sirve para reaccionar a una baja de un competidor o auditar cambios propios.

Inputs: cuenta, limite.

ml_competidoresCompetidores seguidosA
Read-only

Vendedores que se están monitoreando: reputación, cantidad de publicaciones, ventas estimadas y precio promedio. Usar cuando preguntan cómo están contra la competencia.

Inputs: cuenta.

ml_competitividadCompetitividad de preciosA
Read-only

Compara el precio de cada publicación propia contra el mercado: si está por encima, por debajo o si perdió la caja de compra. Usar cuando preguntan si están caros o por qué cayeron las ventas.

Inputs: cuenta, limite.

ml_conectarConectar una tienda de MercadoLibreA
Read-only

Genera el link de autorizacion para vincular una cuenta de MercadoLibre nueva, y muestra el estado de las que ya estan conectadas. Usar cuando el usuario dice "quiero conectar mi tienda", "agregar otra cuenta", "vincular MercadoLibre" o cuando alguna herramienta falla porque no hay cuentas. Devuelve un link que el usuario abre en el navegador: no autoriza nada por su cuenta.

Inputs: diagnostico.

ml_costos_publicacionesCostos por publicaciónA
Read-only

Comisión y costo de envío que cobra MercadoLibre por cada publicación, agrupado por categoría. Sirve para saber cuánto se lleva ML de cada venta antes de fijar precio.

Inputs: cuenta.

ml_cuentasCuentas conectadasA
Read-only

Lista las cuentas de MercadoLibre vinculadas y el estado de la conexión (app configurada, cuentas activas, webhook). Usar al principio cuando hay más de una cuenta, para saber qué ID pasar en el parámetro "cuenta" del resto de las herramientas.

Inputs: no named parameters.

ml_embudoEmbudo visitas → ventasA
Read-only

Cuántas visitas, preguntas y ventas genera cada publicación, para detectar dónde se cae la conversión.

Inputs: cuenta.

ml_facturacionFacturación por períodoA
Read-only

Evolución de facturación y comisiones en los últimos N días, con los totales necesarios para conciliar contra AFIP o para un cierre de mes.

Inputs: dias, cuenta.

ml_mensajesMensajería post-ventaB
Read-only

Mensajes intercambiados con compradores después de la compra, asociados a cada orden. Sirve para detectar reclamos incipientes o pedidos de cambio.

Inputs: cuenta, limite.

ml_mercadoTendencias y categoríasA
Read-only

Inteligencia de mercado de MercadoLibre. Modo "tendencias": búsquedas que están creciendo. Modo "categorias": categorías más relevantes para la cuenta. Modo "categoria": los más vendidos y el rango de precios de una categoría puntual (requiere categoria_id, ej. MLA1234).

Inputs: modo, cuenta, categoria_id.

ml_metricasMétricas de venta (30 días)A
Read-only

Resumen de los ultimos 30 dias SUMANDO TODAS las tiendas: cantidad de ventas, facturado, neto tras comisiones, ticket promedio, aporte de cada tienda al total, desglose por tipo de envio (full/flex/colecta) y top 12 productos por facturacion. Si le pasas una cuenta, muestra solo esa.

Inputs: cuenta.

ml_ordenesÓrdenes recientesA
Read-only

Últimas ventas con comprador, total, comisión, neto, estado del pago y fecha de acreditación del dinero. Máximo 100 órdenes, de la más reciente a la más vieja.

Inputs: cuenta, limite.

ml_panelResumen consolidado del diaA
Read-only

La foto del dia SUMANDO TODAS las tiendas conectadas: ventas de hoy, facturacion, unidades, comparacion contra ayer a la misma hora, desglose tienda por tienda y las ultimas ventas. Es la herramienta para empezar cuando el usuario pregunta "como viene el dia", "como va todo" o "como estan las tiendas". Si le pasas una cuenta, muestra solo esa.

Inputs: cuenta.

ml_preguntasPreguntas de compradoresA
Read-only

Preguntas hechas en las publicaciones, con filtros por estado (pendientes o respondidas), publicación, mes o texto. Por defecto trae las pendientes, que es lo urgente. Devuelve el ID interno que necesita ml_responder_pregunta.

Inputs: mes, buscar, cuenta, estado, +2 more.

ml_preguntas_estadisticasEstadísticas de preguntasA
Read-only

Tasa de respuesta, tiempo promedio de respuesta en minutos, cuántas preguntas terminaron en venta, publicaciones que más preguntas generan y distribución por hora del día. Sirve para dimensionar la atención y decidir horarios de cobertura.

Inputs: dias, cuenta.

ml_promocionesPromociones disponiblesA
Read-only

Campañas y promociones que MercadoLibre ofrece a la cuenta, y qué publicaciones podrían entrar. Usar cuando preguntan si conviene entrar a una promo o al Hot Sale.

Inputs: tipo, cuenta, promocion_id.

ml_publicacionesListar publicacionesA
Read-only

Publicaciones sincronizadas con título, precio, stock, vendidos, estado y link. Acepta un filtro de texto para buscar por título o MLA.

Inputs: buscar, cuenta, limite.

ml_publicidadProduct AdsA
Read-only

Campañas de publicidad de MercadoLibre: inversión, impresiones, clics, ACOS y ventas atribuidas. Usar cuando preguntan si conviene la pauta o cuánto están gastando en ads.

Inputs: dias, cuenta.

ml_reclamosReclamos y devolucionesA
Read-only

Reclamos abiertos, devoluciones en curso, cuáles afectan la reputación, cuáles tienen plazo de acción vencido y el monto en juego. Es lo primero a mirar cuando la reputación baja.

Inputs: cuenta, limite.

ml_rendimiento_publicacionesVisitas y conversión por publicaciónA
Read-only

Cruce de visitas contra ventas de los últimos 30 días con la tasa de conversión de cada publicación. Detecta las que reciben tráfico pero no venden.

Inputs: cuenta, limite.

ml_rentabilidadRentabilidad realA
Read-only

Margen real después de comisión de ML, costo de envío, costo del producto e impuestos. Modo "periodo" para un rango puntual, modo "mensual" para la serie mes a mes. Es la herramienta correcta cuando preguntan si ganan plata, cuánto margen dejan o qué producto no conviene.

Inputs: dias, modo, desde, hasta, +2 more.

ml_reputacionReputación del vendedorA
Read-only

Color de reputación, nivel MercadoLíder, porcentaje de reclamos, cancelaciones y demoras de envío. Usar cuando preguntan por el termómetro o por qué bajó la reputación.

Inputs: cuenta.

ml_responder_preguntaResponder una preguntaA
Destructive

Publica la respuesta a una pregunta EN MERCADOLIBRE, visible para todos. Es una escritura real e irreversible: mostrale el texto al usuario y esperá su confirmación antes de ejecutarla. El id es el que devuelve ml_preguntas.

Inputs: id (required), texto (required).

ml_salud_publicacionesSalud de publicacionesA
Read-only

Puntaje de calidad por publicación según MercadoLibre (fotos, ficha técnica, descripción, garantía) y las tareas concretas para subirlo. Usar cuando preguntan cómo mejorar el posicionamiento o por qué una publicación no vende.

Inputs: cuenta, limite.

ml_simular_preciosSimular cambio de preciosA
Read-only

Aplica las reglas de precio configuradas (porcentaje o monto fijo) sobre el catálogo y devuelve el precio nuevo y el delta de cada publicación, SIN tocar nada en MercadoLibre. Es una simulación.

Inputs: cuenta, limite.

ml_sincronizarSincronizar con MercadoLibreA

Fuerza una sincronización de órdenes, publicaciones y preguntas contra la API de MercadoLibre. Puede tardar. Usar solo si el usuario dice que faltan datos recientes; el sistema ya sincroniza solo.

Inputs: no named parameters.

ml_stockStock y quiebresA
Read-only

Modo "bajo": publicaciones con stock por debajo de un umbral. Modo "full": panorama de stock en Fulfillment con días de cobertura y riesgo de quiebre. Usar cuando preguntan qué se va a quedar sin stock o qué reponer.

Inputs: modo, cuenta, maximo.

ml_ventas_geoMapa de ventas por provinciaA
Read-only

Distribución de las ventas por provincia. Sirve para decidir depósitos, costos de envío o dónde pautar.

Inputs: cuenta.

ml_visitasHistorial de visitasB
Read-only

Serie de visitas por publicación en el tiempo, para ver si el tráfico sube o baja.

Inputs: cuenta.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 33 tools

    Disambiguation4/5

    The tools are grouped by clear functional areas and each description includes specific usage triggers, so most are easy to distinguish. However, a few analytics pairs like ml_embudo/ml_rendimiento_publicaciones and ml_competitividad/ml_catalogo overlap in purpose enough that an agent could occasionally hesitate between them.

    Naming Consistency4/5

    All tools use a consistent ml_ prefix, lowercase, and Spanish snake_case, with action verbs for write operations and noun phrases for reads. The pattern is highly recognizable but not perfectly uniform, since some tools are bare verbs like ml_conectar while others are noun phrases like ml_publicaciones.

    Tool Count3/5

    At 33 tools, the surface is heavy, but it covers a very broad seller platform spanning sales, listings, stock, questions, claims, reputation, ads, and market intelligence. Some analytics tools could plausibly be consolidated, so the number feels somewhat bloated rather than naturally scoped.

    Completeness3/5

    The monitoring and analytics side is quite complete, covering almost every seller-facing metric and alert. However, the set is mostly read-only: it lacks create/delete publication flows, order or shipping actions, message replies, and claim resolution, which leaves meaningful lifecycle gaps.

    Maintenance

    ActivitySlowing
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Connects Claude to your MercadoLibre seller account, enabling natural language management of listings, orders, and shipments.
      -
    • A
      license
      B
      quality
      B
      maintenance
      Enables sellers to connect one or more MercadoLibre store accounts to Claude over OAuth 2.0 with PKCE and ask about sales, orders, questions, catalog buy box, promotions, reputation, and competitor pricing in natural language, with optional write actions for pricing, stock, listings, and buyer replies. Supports consolidated multi-store reporting and requires no backend server, keeping tokens in a local file on the user's machine.
      32
      1
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables sellers to connect their MercadoLibre seller account to Claude Desktop and query sales, listings, questions, competition, and prices in natural language, with optional read-only or write operations.
      34
      MIT