MCP MercadoLibre
by kokesaurio
README.md
# MCP MercadoLibre — conectá MercadoLibre con Claude AI
[](https://modelcontextprotocol.io)
[](https://nodejs.org)
[](LICENSE)
[](#todo-lo-que-hace)
**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
- [Qué problema resuelve](#qué-problema-resuelve)
- [Cómo funciona](#cómo-funciona)
- [Todo lo que hace: las 33 herramientas](#todo-lo-que-hace)
- [Cuenta y sincronización](#cuenta-y-sincronización)
- [Ventas y plata](#ventas-y-plata)
- [Publicaciones, precios y stock](#publicaciones-precios-y-stock)
- [Preguntas, mensajes y post-venta](#preguntas-mensajes-y-post-venta)
- [Inteligencia de mercado y competencia](#inteligencia-de-mercado-y-competencia)
- [Qué NO hace](#qué-no-hace)
- [Cómo instalar el MCP de MercadoLibre en Claude](#instalación)
- [Variables de entorno](#variables-de-entorno)
- [Preguntas frecuentes](#preguntas-frecuentes)
- [English summary](#english-summary)
---
## 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`:
```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**:
```bash
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.
```bash
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/`](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`](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é.
```bash
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`](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
```bash
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](#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](https://algoritmodigital.com.ar)
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
ActivityMaintained
ResponsivenessNo issues