Skip to main content
Glama
mcp-supermercados-cl

mcp-supermercados-cl

by NLACE-COM

🛒 mcp-supermercados-cl

Servidor MCP para buscar productos, comparar precios y armar la mejor lista de compra en supermercados chilenos con Claude, ChatGPT u otro cliente MCP.

npm node tests license

El foco es profundidad en la cadena donde tú ya compras — precios club, beneficios por RUT, productos frecuentes, carro — con la comparación entre cadenas como capacidad secundaria. Cubre las cinco grandes cadenas del país.

100 % local: el tráfico sale de tu máquina, a ritmo humano, y tus credenciales nunca tocan un servidor central.


Tabla de contenidos


Related MCP server: Israel Grocery MCP

🚫 ¿Se deploya en Vercel/AWS? No

Este MCP no tiene URL de producción y no se deploya en ningún servidor. Es intencional, y es la razón por la que funciona:

  • Usa transporte stdio (local), no HTTP. Corre en tu máquina, junto a tu cliente MCP (Claude Desktop, Claude Code, Cursor, ChatGPT Desktop).

  • Tottus y Lider bloquean cualquier cliente HTTP plano por su huella (TLS/JA3 + antibot), incluso desde una IP residencial. Lo que sí carga sus datos es un navegador real, y ese navegador está en tu máquina (ver el puente contra el antibot). Un deploy en la nube no tendría ese navegador.

  • El precio socio, tus frecuentes y el carro viven en tu navegador logueado. Las credenciales no deben tocar un servidor central — eso además evita el mayor riesgo legal (un servicio que scrapee cuentas ajenas).

La forma de "producción" de un MCP como este es instalarlo local (vía npx o clonando el repo) y conectarlo a tu cliente. Igual que la mayoría de los MCP servers.


📦 Instalación

Requiere Node.js ≥ 20. Probado con el SDK oficial @modelcontextprotocol/sdk 1.29 (protocolo MCP 2025-11-25). Publicado en npm: mcp-supermercados-cl.

Opción 1 — vía npx (recomendada). No instalas nada; tu cliente MCP lo ejecuta al vuelo. En Claude Desktop / Claude Code (claude_desktop_config.json o .mcp.json):

{
  "mcpServers": {
    "supermercados": {
      "command": "npx",
      "args": ["-y", "mcp-supermercados-cl"]
    }
  }
}

Opción 2 — desde el código (para desarrollar o contribuir):

git clone https://github.com/NLACE-COM/mcp-supermercados-cl.git
cd mcp-supermercados-cl
npm install
npm run build

Y apunta tu cliente al build local:

{
  "mcpServers": {
    "supermercados": {
      "command": "node",
      "args": ["/ruta/absoluta/al/repo/dist/index.js"]
    }
  }
}

Para desarrollo rápido:

npm run dev        # servidor por stdio con tsx
npm run inspector  # abre el MCP Inspector

🏬 Cobertura por cadena

Cadena

Plataforma

Búsqueda

Precio socio

Detalle

Sesión / carro

Jumbo

Cencosud (Constructor.io)

✅

✅ Prime

✅

✅ frecuentes, listas, carro

Santa Isabel

Cencosud (Constructor.io)

✅

✅

✅

carro Cencosud¹

Unimarc

VTEX (BFF propio)

✅

✅ Club Unimarc

—

—

Tottus

Falabella (Next.js SSR)

✅

—

—

—

Lider

Walmart Glass (SSR)

✅

—²

—

—

¹ El carro de Santa Isabel reutiliza el mismo BFF Cencosud que Jumbo; se activa con tu sesión en santaisabel.cl. ² Lider no expone precio socio dual como el Prime de Jumbo; sus descuentos son rebajas directas ("Precio Lider") + bundles.

⚠️ Tottus y Lider bloquean el fetch del servidor por huella del cliente, no por IP: desde tu equipo también responden 403 / 307 → /blocked. Se leen a través de un navegador real, manual o automatizado (ver el puente contra el antibot). Jumbo, Santa Isabel y Unimarc responden al fetch directo (verificado 2026-10-16, también desde GitHub Actions).

Todos los resultados vienen enriquecidos: nombre, marca, descripción, foto, precio vigente, precio normal, precio socio, precio por unidad normalizado (por kg/lt para comparar formatos) y bundles ("2 x $2.000", "Lleva 8 por $X").


🧰 Tools disponibles

Núcleo — armar la mejor lista con tu sesión:

Tool

Qué hace

build_list

Convierte una lista en lenguaje natural en productos concretos. Prioriza tus frecuentes, mejor precio por unidad y ofertas. Flags onlyOffers / onlyInStock y maxBudget (ajusta a alternativas más baratas para caber). Incluye resumen formateado.

suggest_swaps

Reemplazos convenientes por precio por unidad. Con preferNatural: alternativas de precio similar con menos ingredientes.

get_frequent_purchases

Tus productos habituales, con precio Prime (requiere sesión).

get_saved_lists

Tus listas guardadas (requiere sesión).

add_to_cart / get_cart

Prepara el cambio en el carro de Jumbo (browserSnippet) y normaliza el carro que devuelve tu navegador: total, ahorro y ahorro Prime. Ver qué significa executed.

Lectura de catálogo:

Tool

Qué hace

search_products

Busca en cualquier cadena. Filtros maxPrice/minPrice/inStockOnly, orden sortBy (price / unitPrice).

get_product

Detalle por URL/slug: precio socio, EAN, ingredientes y sellos nutricionales.

get_offers

Ofertas vigentes de Jumbo; primeOnly, filtro por categoría.

find_opportunities

Mayores descuentos con stock, ordenados por discountPct. excludeIds para destacar lo que no tienes.

Comparación y diagnóstico:

Tool

Qué hace

compare_stores

Total de una lista en varias cadenas; marca la más barata y advierte si compara formatos distintos.

discover_branch

Descubre tu sucursal (branchId) leyéndola del navegador, para no pedírtela a mano.

adapter_status

Qué cadenas responden ahora y con qué latencia.

💬 Prompts guiados

Para no adivinar qué pedir, el servidor expone plantillas que tu cliente MCP muestra como sugerencias: armar_lista (con presupuesto opcional), conectar_sesion, comparar_carro y ofertas_frecuentes. El servidor además trae instructions para que el modelo te guíe en el primer uso (qué cadena, cuándo pedir sesión, cómo leer los errores).

Los errores vienen accionables: cada uno trae un campo action con el siguiente paso concreto (re-loguearte, reintentar, leer la búsqueda desde tu navegador…) en vez de un mensaje técnico.


🔐 Cómo funciona la sesión (sin credenciales en el servidor)

El precio socio, los frecuentes y el carro viven detrás del login. En Jumbo, el token vive en el localStorage del navegador, así que el servidor nunca ve credenciales: el cliente (junto a tu navegador logueado) extrae los datos del DOM o ejecuta las llamadas autenticadas, y el MCP solo normaliza el resultado.

Ver src/adapters/session.ts y docs/captura-cencosud-2026-07-06.md.

¿Y esas API keys que aparecen en el código?

Verás claves como key_JopvNXKS61kwGkBe (Jumbo) o be-reg-groceries-sisa-catalog-wdhhq5a2fken (Santa Isabel) en los adaptadores. No son secretos. Son las claves públicas del frontend de Constructor.io y del BFF de catálogo: van embebidas en el JavaScript de jumbo.cl y santaisabel.cl, y son visibles en las DevTools de cualquier visitante. Solo identifican el índice de búsqueda del lado cliente — no dan acceso a ninguna cuenta ni permiten escribir. Sin ellas, el buscador no responde.

Los datos que sí son sensibles (token de sesión, precio socio, carro) viven en tu navegador logueado y nunca están en este repositorio. Un escáner automático puede marcar estas claves públicas como "token expuesto"; es un falso positivo.


🧪 Desarrollo y tests

npm test              # tests de contrato con fixtures reales (sin red) — 160 tests
npm run test:live     # smoke contra los sitios reales (opt-in, LIVE=1)
npm run test:session  # smoke de las tools de sesión de Jumbo (requiere tu navegador)
npm run typecheck     # tsc --noEmit
npm run lint          # ESLint
npm run format        # Prettier (--write); format:check para verificar

Smoke de sesión (test:session)

Las tools de sesión de Jumbo (carro, listas guardadas, frecuentes) necesitan el token que vive en el localStorage de un navegador logueado, así que ni los tests de contrato ni el smoke live las cubren. Este smoke cierra ese hueco (issue #12) con el puente de Playwright sobre un perfil dedicado:

PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1 npm install --no-save playwright  # una vez
npm run session:login   # una vez: abre Chrome, inicias sesión y eliges tienda
npm run test:session    # cada vez que quieras verificar (~30 s)

session:login abre una ventana con un perfil aparte (~/.supermercados-smoke-profile, configurable con SUPERMERCADOS_SMOKE_PROFILE), espera a que inicies sesión y se cierra sola. Tus credenciales las escribes tú en esa ventana; el proyecto solo comprueba que el token exista, nunca su valor.

Por qué un perfil aparte y no el tuyo: launchPersistentContext toma el lock exclusivo del perfil, así que usar el de tu Chrome diario obliga a cerrarlo en cada corrida — y sobre un perfil grande (7,8 GB al probarlo) el lanzamiento ni siquiera completa: muere por timeout sin llegar a conectar. Con perfil dedicado arranca en ~2 s y tu navegador ni se entera.

Qué valida: que el sitio real siga aceptando los requests que arman los snippets de producción y que los parsers entiendan la respuesta.

Vale la pena correrlo antes de publicar una versión. Sin él, un cambio de contrato de Jumbo (rotación de apiKey, cambio del DOM de frecuentes) llega a producción sin aviso: pasó en la 1.4.4, donde el carro y las listas estuvieron rotos dos días hasta que lo reportó un usuario.

Los tests de contrato usan respuestas reales grabadas en tests/fixtures/. Los live requieren red y, para Tottus/Lider, un navegador real (ver más abajo). Regraba una fixture cuando una cadena cambie su formato, anotando la fecha.

Cada push y PR corre lint + typecheck + build + test en CI (GitHub Actions, Node 20 y 22). Un smoke live semanal avisa por issue si una cadena cambia su formato. Para contribuir, revisa CONTRIBUTING.md.

Flujo de sesión: manual o automatizado

Las tools que requieren sesión (get_cart, get_frequent_purchases, get_saved_lists, add_to_cart) devuelven un browserSnippet: un fetch de una sola llamada para ejecutar en una pestaña ya logueada del sitio. Pasas el JSON de vuelta y la tool lo normaliza — el servidor nunca ve tu token.

Qué significa executed. El servidor no ejecuta nada en la tienda. Sin el resultado del navegador, add_to_cart responde executed: false con el request y el snippet: solo prepara el cambio. Con rawCartResult, responde executed: true y el carro normalizado: significa que normalizó el JSON que entregó tu navegador, no que el servidor haya verificado la operación con la tienda. La fuente de verdad es el carro que ves en el sitio. Agregar al carro es reversible y no es una compra: el pago siempre ocurre en el sitio de la tienda. Recomendado para clientes MCP: mostrar al usuario qué va a cambiar (SKU, cantidad, sucursal) y que sea él quien ejecute el snippet.

Para automatizarlo (sin copiar/pegar), existe un puente opcional con Playwright (src/adapters/playwrightBridge.ts) que reusa el perfil de Chrome donde ya tienes la sesión. Playwright no viene con el paquete (es pesado); instálalo aparte si lo quieres:

npm install playwright
npx playwright install chromium

Líder y Tottus: puente automático contra el antibot

Líder y Tottus bloquean el fetch del servidor por fingerprint del cliente (TLS/JA3 + desafío JS de PerimeterX; en Líder además F5 BIG-IP con 307 → /blocked; Tottus responde 403). No es tu IP: la misma IP en un navegador real carga los datos (issue #2). Hay dos formas de sortearlo en search_products, compare_stores y build_cheapest_basket:

  1. Manual: search_products devuelve openUrl + browserSnippet; abres esa búsqueda en tu navegador, ejecutas el snippet (lee __NEXT_DATA__ del DOM) y reintentas pasando el resultado en browserHtml.

  2. Automático: si configuras el puente Playwright por entorno, el servidor navega solo reusando tu perfil de Chrome (nunca ve tu token) y resuelve esas cadenas sin intervención. Variables (en la sección env de tu cliente MCP):

    Variable

    Requerida

    Descripción

    SUPERMERCADOS_PLAYWRIGHT_PROFILE

    sí

    Carpeta del perfil de Chrome con tu sesión (userDataDir). Activa el puente.

    SUPERMERCADOS_PLAYWRIGHT_PATH

    con npx

    Carpeta del paquete playwright cuando está instalado global (por npx el server no lo resuelve solo). Valor: salida de npm root -g + /playwright.

    SUPERMERCADOS_PLAYWRIGHT_CHANNEL

    no

    chrome o msedge para usar el navegador instalado (si no, el Chromium de Playwright).

    SUPERMERCADOS_PLAYWRIGHT_HEADLESS

    no

    1 para headless (por defecto con ventana, evita gatillar antibots/2FA).

    Requiere Playwright instalado y Chrome cerrado (para no chocar con el lock del perfil). Sin estas variables, el comportamiento es el manual de arriba.

    Con npx (Claude Desktop, etc.): el paquete corre en un cache efímero sin Playwright, así que instálalo global (npm install -g playwright) y apunta SUPERMERCADOS_PLAYWRIGHT_PATH a su carpeta. NODE_PATH no sirve: el server carga Playwright con import() (ESM) y NODE_PATH solo aplica a require() de CommonJS.

    {
      "mcpServers": {
        "supermercados-cl": {
          "command": "npx",
          "args": ["-y", "mcp-supermercados-cl@latest"],
          "env": {
            "SUPERMERCADOS_PLAYWRIGHT_PROFILE": "/Users/tu-usuario/Library/Application Support/Google/Chrome",
            "SUPERMERCADOS_PLAYWRIGHT_PATH": "/ruta/de/npm-root-g/playwright",
            "SUPERMERCADOS_PLAYWRIGHT_CHANNEL": "chrome"
          }
        }
      }
    }

🏗 Arquitectura

  • Un servidor, un adaptador por cadena (src/adapters/). Esquema normalizado con zod (src/core/types.ts): precio normal y precio socio separados, precio por unidad normalizado a base canónica.

  • HTTP a ritmo humano, por tipo de host: los endpoints de API (Constructor.io y los BFF de Cencosud/Unimarc/Santa Isabel) van a ~350 ms; los sitios que se scrapean por SSR (Tottus, Lider, PDPs www.*) mantienen ~1 s. Reintentos con backoff, user-agent realista (src/http/client.ts). Cache TTL 15 min. Ajustable por entorno: SUPERMERCADOS_MIN_DELAY_MS, SUPERMERCADOS_FAST_DELAY_MS, SUPERMERCADOS_TIMEOUT_MS, SUPERMERCADOS_MAX_RETRIES.

  • Feedback en vivo: build_list y compare_stores emiten notificaciones de progreso MCP (notifications/progress) si el cliente las soporta, para no quedar en silencio durante listas largas. compare_stores limita cada cadena a 25 s y devuelve resultado parcial en vez de bloquear a las demás.

  • Adaptadores aislados: un cambio de sitio rompe un adaptador, no todo.

  • Endpoints documentados en docs/ y en docs/PLAN-arquitectura.md.

src/
├── index.ts            # entrada MCP (stdio)
├── server.ts           # registro de tools
├── core/               # types, registry, normalize, listBuilder, compare, ...
├── adapters/           # cencosud (Jumbo+Santa Isabel), unimarc, tottus, lider
├── tools/              # una tool MCP por archivo
└── http/               # cliente HTTP con rate limit y reintentos

🤝 Cómo contribuir

¡Bienvenidas las contribuciones! Este proyecto está pensado para crecer con la comunidad. Ver CONTRIBUTING.md.

Ideas de alto impacto:

  • Carro/sesión en Unimarc, Tottus y Lider (cada una con su login propio).

  • Detalle (get_product) para Unimarc/Tottus/Lider.

  • Nuevas cadenas o farmacias.

  • Mantener las fixtures al día cuando una cadena cambie su API.

Cuando una cadena cambie su formato, npm run test:live lo detecta.


Herramienta personal, de código abierto, sin backend central. Cada usuario opera su propia cuenta desde su propia IP, a ritmo humano, sin redistribuir datos. Revisa los Términos y Condiciones de cada cadena antes de usarla. No afiliado a Cencosud, SMU, Falabella ni Walmart. Las marcas mencionadas pertenecen a sus respectivos dueños. Úsalo bajo tu propia responsabilidad.


📄 Licencia

MIT © contribuidores de mcp-supermercados-cl

Available Tools

14 tools
adapter_statusEstado de las cadenasA

Diagnóstico en vivo: qué cadenas soportadas están respondiendo ahora y con qué latencia. Úsalo si otra tool falla, para distinguir un endpoint caído de un error de uso.

Inputs: no named parameters.

add_to_cartAgregar al carroA

Agrega/actualiza productos en el carro de Jumbo del usuario. El servidor no maneja credenciales: devuelve un browserSnippet (PATCH /cart/items con su body) para ejecutar en una pestaña YA LOGUEADA de www.jumbo.cl. Si el navegador lo ejecutó y entregas el JSON del carro en rawCartResult, devuelvo el carro normalizado (total, ahorro y ahorro Prime). Acción reversible (se puede quitar del carro); no es una compra.

Inputs: items (required), branchId (required), store, rawCartResult.

build_cheapest_basketArmar la canasta más barata (repartida por cadena)A

Toma una lista de ítems y, por CADA ítem, elige la cadena donde sale más barato (por precio por unidad cuando todas lo informan), agrupando la compra por cadena (la leche en una, el pan en otra). Devuelve plan por cadena, picks por ítem con alternativas, basketTotal (comprando cada cosa donde es más barata), singleStore y splitSaving (ahorro vs comprar todo en una sola cadena), y missing. Por defecto compara jumbo, santaisabel y unimarc (las que responden desde el servidor); tottus/lider requieren el puente de navegador (browserHtml de search_products). NO agrega al carro: para eso usa add_to_cart (hoy solo Jumbo, con sesión); para el resto quedan los links (url) de cada producto.

Inputs: items (required), stores, branchId.

build_listArmar lista de compraA

Convierte una lista en lenguaje natural (ej. ["leche", "arroz 1kg", "café de grano"]) en productos concretos del catálogo, eligiendo por mejor precio por unidad y ofertas vigentes. Devuelve por ítem el producto elegido, hasta 3 alternativas para ajustar, el ahorro por ofertas, y el total estimado en CLP. Con branchId usa precios/stock de esa sucursal. Si se entregan los productos frecuentes del usuario en frequentCards (desde get_frequent_purchases con sesión iniciada), se priorizan: la lista se arma con lo que la persona realmente compra. Si el usuario prefiere marcas específicas, incluirlas en el texto del ítem (ej. "leche colun").

Inputs: items (required), store, branchId, maxBudget, +3 more.

compare_storesComparar cadenasA

Estima el total de una misma lista (ítems en texto libre) en varias cadenas chilenas y señala la más barata entre las que tienen todos los productos. Devuelve por cadena el mejor match por ítem y el total. IMPORTANTE: cada cadena resuelve el ítem por su cuenta, así que el 'más barato' puede ser un producto o formato distinto; usa el campo comparability (same/similar/mixed por ítem) y compara por precio por unidad, no solo por total. Capacidad secundaria: para el día a día conviene build_list con tu sesión. Nota: tottus/lider solo se incluyen si está configurado el puente de navegador (bloquean el fetch directo); si una cadena falla, se reporta y las demás siguen.

Inputs: items (required), stores, branchId.

discover_branchDescubrir mi sucursalA

Obtiene el código de sucursal (branchId, ej. "jumboclj512") leyéndolo del navegador, para no pedírselo al usuario. Devuelve un browserSnippet para ejecutar en www.jumbo.cl (con la comuna/tienda ya elegida). El snippet retorna { found, branchId } o, si no hay tienda elegida, { found:false, hint }. Pasa ese resultado en discovered para que la tool lo valide y te confirme el branchId a usar.

Inputs: store, discovered.

find_opportunitiesOportunidades del momentoA

Devuelve los productos con MAYOR descuento vigente y stock real, ordenados por porcentaje de descuento, para recomendar aprovechar ofertas. Cada resultado trae discountPct, saving (ahorro CLP) y memberSaving (ahorro extra socio Prime) además de nombre, precio, precio normal, unidad y foto. Filtrable por category y minDiscountPct. Pasar excludeIds (ids del carro o frecuentes) para destacar solo oportunidades que el usuario aún no tiene. primeOnly para ofertas exclusivas de socios. Hoy disponible en Jumbo (colección de ofertas verificada).

Inputs: limit, store, branchId, category, +3 more.

get_cartEstado del carroA

Normaliza el carro de Jumbo del usuario a { items, subTotal, total, savings, primeSavings }. El servidor no ve credenciales. FLUJO RÁPIDO (una sola llamada): ejecuta el browserSnippet que devuelve esta tool en una pestaña YA LOGUEADA de www.jumbo.cl y pásame el JSON en rawCart. NO extraigas el estado de React ni el DOM del carro a mano: es lento, frágil e innecesario (este fetch trae todo el carro directo). Si no pasas rawCart, devuelvo el snippet listo para ejecutar.

Inputs: store, rawCart, branchId.

get_frequent_purchasesProductos frecuentes del usuarioA

Devuelve los productos que el usuario compra habitualmente en la cadena, normalizados con su precio vigente, precio normal y precio socio Jumbo Prime cuando aplica. Base para armar la lista con lo que la persona realmente compra. Requiere sesión: entrega en cards el resultado de ejecutar el browserSnippet (una sola pasada al DOM) en www.jumbo.cl/productos-frecuentes ya logueado. NO rasques el estado de React ni improvises selectores; usa el snippet. El servidor nunca maneja credenciales.

Inputs: cards, store, branchId.

get_offersOfertas vigentesA

Lista las ofertas vigentes del supermercado (precio rebajado: price vigente vs listPrice normal). Filtrable por categoría (ej. "Despensa", "Lácteos") y por sucursal (branchId). El precio socio exacto se consulta con get_product (memberPrice). Nota: primeOnly (ofertas exclusivas socios) ya no está disponible en Jumbo — el landing dedicado fue discontinuado; devuelve un error accionable.

Inputs: page, limit, store, branchId, +2 more.

get_productDetalle de productoA

Obtiene el detalle completo de un producto: precio vigente (price), precio normal (listPrice), precio socio Jumbo Prime (memberPrice) cuando existe, precio por unidad (unitPrice/unit), EAN, stock y oferta. Es la única fuente del precio socio en fase 1. Acepta la URL del producto (campo url de search_products), el path o el slug.

Inputs: idOrUrl (required), store, branchId.

get_saved_listsListas guardadas del usuarioA

Devuelve las listas de compra guardadas del usuario en la cadena, normalizadas a { id, name, items[] }. Requiere sesión: ejecuta el browserSnippet (GET /lists) en una pestaña YA LOGUEADA de www.jumbo.cl y pásame el JSON en rawLists. Para el detalle con items, repite el fetch a /lists/{scope}/{idList}. NO rasques el DOM ni React; es una llamada JSON directa. El servidor nunca maneja credenciales.

Inputs: store, branchId, rawLists.

search_productsBuscar productosA

Busca productos en el catálogo de un supermercado chileno y devuelve resultados enriquecidos: name, brand, description, imageUrl, url. Precios en CLP: price es el precio vigente (con oferta si la hay), listPrice el normal cuando hay descuento, unitPrice/unit el precio por unidad base (kg/lt/un) para comparar formatos. Filtros opcionales: maxPrice/minPrice (CLP), inStockOnly; orden con sortBy (price = más barato primero, unitPrice = mejor precio por kg/lt). Con branchId (sucursal) los precios/stock son de esa tienda. Para el precio socio de un producto puntual, usar get_product.

Inputs: query (required), page, limit, store, +6 more.

suggest_swapsSugerir reemplazos convenientesA

Para cada ítem (nombre de producto o texto de búsqueda) sugiere reemplazos convenientes dentro del mismo catálogo. Por defecto: mejor precio por unidad (kg/lt/un) que el match actual. Con preferNatural: true cambia el criterio a 'más natural manteniendo el precio': trae alternativas de precio similar CON sus ingredientes y sellos nutricionales, para elegir la de lista de ingredientes más corta/limpia sin subir el gasto (usa la ficha; hoy Jumbo y Santa Isabel). Devuelve el producto actual y los reemplazos con su ahorro por unidad.

Inputs: items (required), store, branchId, preferNatural.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 14 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes (search, detail, cart, branch discovery), but two pairs overlap meaningfully: compare_stores vs build_cheapest_basket both compare a list across chains, and get_offers vs find_opportunities both surface discounted products. Descriptions do explain the differences, so an agent can usually pick correctly, but the boundaries require reading carefully.

    Naming Consistency4/5

    Strong, mostly consistent verb_noun pattern (get_offers, search_products, build_list, add_to_cart, get_cart, find_opportunities, discover_branch). The only notable deviation is adapter_status, which is noun-only rather than verb-prefixed, a minor inconsistency in an otherwise predictable set.

    Tool Count4/5

    14 tools is reasonably scoped for a multi-chain shopping assistant covering search, comparison, list building, offers, and cart flows. Slightly on the heavy side with some functional near-duplicates (compare_stores/build_cheapest_basket), but most tools earn their place.

    Completeness4/5

    The surface covers the shopping lifecycle well: discovery, search, product detail, offers, list building, price comparison, saved/frequent lists, and cart read/add. Minor gaps exist — add_to_cart is the only cart mutation (no explicit remove/clear or checkout), which agents must work around via browser snippets.

    Maintenance

    ActivitySlowing
    ResponsivenessUsually handled

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Enables AI assistants to search products, compare prices, and find the best deals across multiple supermarkets in Argentina through Superprecio's price comparison API. Transforms Claude into an expert shopping assistant for Latin American grocery shopping.
      15
      14 npm
      MIT
    • F
      license
      B
      quality
      D
      maintenance
      Enables cross-store price comparison and recipe-driven cart automation for Israeli grocery stores Shufersal and Tiv Taam, with an extensible architecture for additional stores.
      14
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables searching and comparing products from Woolworths and Coles supermarkets.
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables users to compare and get recommendations across multiple supermarket products, combining curated specifications with realtime price and review lookups.
      -

    Appeared in Searches