MCP MercadoLibre
Connect MercadoLibre seller accounts to Claude AI and query/act on sales, money, listings, stock, buyer questions, claims, reputation, ads, and competitor data in natural language.
Account & sync: list connected stores (
ml_cuentas), generate authorization links to add new stores (ml_conectar), and force a manual sync with MercadoLibre (ml_sincronizar).Sales & money: consolidated daily summary across all stores (
ml_panel), 30-day metrics (ml_metricas), recent orders with commissions and payout dates (ml_ordenes), cash flow/available funds/projections (ml_caja), invoicing by period (ml_facturacion), real profitability after fees/costs/taxes (ml_rentabilidad), sales by province (ml_ventas_geo), and visit-to-sale funnel (ml_embudo).Listings, pricing & stock: search listings (
ml_publicaciones), update price/stock/title/status directly on MercadoLibre (ml_actualizar_publicacion), low-stock and Fulfillment coverage alerts (ml_stock), listing quality scores (ml_salud_publicaciones), traffic-to-conversion performance (ml_rendimiento_publicaciones), visit history (ml_visitas), per-listing fees (ml_costos_publicaciones), and dry-run price simulations (ml_simular_precios).Questions, messages & after-sales: list buyer questions (
ml_preguntas), publish answers (ml_responder_pregunta), question statistics (ml_preguntas_estadisticas), post-sale messages (ml_mensajes), open claims/returns (ml_reclamos), and seller reputation (ml_reputacion).Market intelligence & competition: monitored competitors (
ml_competidores), price competitiveness per listing (ml_competitividad), market trends/categories (ml_mercado), detected price changes (ml_cambios_precio), Product Ads performance (ml_publicidad), available promotions (ml_promociones), catalog buy-box analysis (ml_catalogo), and system alerts (ml_alertas).Write actions are limited and destructive-flagged: only update listing fields, answer questions, and trigger syncs; can be disabled with
ALLOW_WRITE=0for read-only mode.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP MercadoLibre ¿Cuánto facturamos hoy sumando todas mis tiendas?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP MercadoLibre — conectá MercadoLibre con Claude AI
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 realEl 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 |
| 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. |
| Genera el link de autorización para vincular una tienda nueva y muestra las que ya están conectadas. Con |
| 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 |
| 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. |
| 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. |
| 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. |
| Tres modos. |
| 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. |
| 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 |
| Ventas y monto por provincia. Sirve para decidir dónde conviene un depósito, cómo negociar envíos o dónde pautar. |
| 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 |
| El catálogo con precio, stock, unidades vendidas, estado y link. Acepta una búsqueda por título o por código MLA. |
| ✍️ 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. |
| Modo |
| 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. |
| 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. |
| La serie histórica de visitas por publicación, para ver si el tráfico viene subiendo o cayendo. |
| 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. |
| 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 |
| 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. |
| ✍️ Escribe en MercadoLibre. Publica la respuesta, visible para cualquiera que entre a la publicación. |
| 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. |
| La mensajería post-venta atada a cada orden, para detectar un reclamo antes de que se convierta en reclamo formal. |
| 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. |
| Color de reputación, nivel MercadoLíder, porcentaje de reclamos, cancelaciones y demoras de envío. |
Inteligencia de mercado y competencia
Herramienta | Qué devuelve |
| Los vendedores que estás monitoreando, con su reputación, cantidad de publicaciones, ventas estimadas y precio promedio. |
| 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?". |
| Modo |
| 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. |
| 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. |
| 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. |
| 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?". |
| Las alertas automáticas del sistema: quiebres de stock, bajas de precio de competidores, reclamos nuevos, publicaciones pausadas. Buen segundo paso después de |
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-algoritmodigitalSi 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:httpPublicalo 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 queredirect_urisea la del conector propio (allow-list).POST /api/auth/mlcon{ "code", "redirect_uri" }→ canjea el code contrahttps://api.mercadolibre.com/oauth/tokencon el app id/secret, hace upsert de la cuenta poruser_idde 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/callbacka 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 |
| Audita publicaciones con datos reales y propone mejoras de título, precio y stock |
| Despacha preguntas de compradores con respuestas listas para aprobar |
| Reporte ejecutivo del día/semana/mes con alertas urgentes primero |
| Semáforo de posición de precios y recomendaciones validadas por margen |
| 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/aceptarcon{ "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" }] }.GETyPUT /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 manoEl 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 |
| ambos | Obligatoria. URL del backend, sin barra final |
| stdio | JWT del panel (alternativa a usuario/clave, necesaria con 2FA) |
| stdio | Credenciales del panel |
| stdio | ID de cuenta de ML por defecto |
| http | Puerto de escucha. Default |
| http | URL pública con HTTPS. Debe coincidir con la real |
| http | Secreto HMAC, mínimo 24 caracteres |
| http | Dónde persistir clientes y sesiones |
| ambos |
|
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álogoDesarrollo
npm install
npm run inspect # MCP Inspector: probar las herramientas a mano
npm start # stdio
npm run start:http # HTTP + OAuthSeguridad
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_verifiervá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
/mcpconstruye 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 toolsml_actualizar_publicacionActualizar publicaciónADestructive
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 sistemaARead-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 acreditacionesARead-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 detectadosARead-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_catalogoCatálogo de MercadoLibreARead-only
Busca un producto de catálogo y muestra quiénes compiten por la caja de compra, a qué precio y quién la está ganando. Usar cuando preguntan por qué no ganan el catálogo.
Inputs: buscar (required), cuenta.
ml_competidoresCompetidores seguidosARead-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 preciosARead-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 MercadoLibreARead-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ónARead-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 conectadasARead-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 → ventasARead-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íodoARead-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-ventaBRead-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íasARead-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)ARead-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 recientesARead-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 diaARead-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 compradoresARead-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 preguntasARead-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 disponiblesARead-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 publicacionesARead-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 AdsARead-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 devolucionesARead-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ónARead-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 realARead-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 vendedorARead-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 preguntaADestructive
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 publicacionesARead-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 preciosARead-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 quiebresARead-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 provinciaARead-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 visitasBRead-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
Scored across 33 tools
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.
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.
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.
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
Related MCP Connectors
Connect Claude or ChatGPT to your Shopee and TikTok Shop stores: orders, ads, stock and profit.
Connect Amazon Seller Central to Claude or ChatGPT via MCP. Orders, inventory, pricing, fees, FBA.
Amazon Seller Central and Ads inside Claude, ChatGPT or Grok. Fees from your own settlements.
Amazon Seller Central and Ads inside Claude, ChatGPT or Grok. Fees from your own settlements.
Related MCP Servers
- AlicenseBqualityDmaintenanceIntegrates with the Mercado Livre API to enable management of sales, shipments, and shipping labels directly through Claude.71MIT
- FlicenseNot gradedqualityDmaintenanceConnects Claude to your MercadoLibre seller account, enabling natural language management of listings, orders, and shipments.-
- AlicenseBqualityBmaintenanceEnables 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.321MIT
- AlicenseBqualityCmaintenanceEnables 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.34MIT