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., "@Mercadona Skill MCP search for whole wheat pasta with NutriScore A and add to cart"
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.
Versión: 0.1.0 · Licencia MIT · ver CHANGELOG
Servidor MCP para montar pedidos de Mercadona desde lenguaje natural, con onboarding de usuarios nuevos (intake), priorización de Nutri-Score y ejecución en tu carrito real supervisada (nunca paga).
Inteligencia (catálogo, precios, Nutri-Score, alérgenos): APIs públicas de solo lectura — Mercadona + Open Food Facts.
Carrito: navegador visible con tu sesión (Playwright sobre tu Chrome/Edge).
Pago: NO existe herramienta de pago. El flujo termina en el carrito; pagas tú.
pip install -r requirements.txt # mcp + playwright (usa tu Chrome/Edge)Registra el MCP en Claude Code: copia .mcp.json a la raíz de tu proyecto (o usa
claude mcp add). Si la ruta relativa server.py no resuelve, pon la ruta
absoluta en args. Copia commands/mercadona-pedido.md a .claude/commands/
para tener el comando /mercadona-pedido.
Related MCP server: oda-mcp
Un usuario nuevo responde un breve intake (código postal, nº de personas, alergias,
dieta, umbral de Nutri-Score para avisos, marca blanca, ingredientes a evitar). Se
guarda en profile.json y personaliza el resto: avisos, alérgenos y precios.
mercadona)Capa | Herramientas |
Intake |
|
Catálogo |
|
Integración |
|
Nutri-Score |
|
Carrito (navegador) |
|
⛔ Sin checkout ni pay: por diseño no se puede pagar desde el MCP.
Tu generador de menús (p.ej. dietas diabéticas) alimenta la skill vía import_menu:
Contrato JSON (recomendado): items=[{"id": 30006, "qty": 1, "name": "...", "note": "..."}].
HTML: html_path/html de un menú con tabla Sección | ID | Producto | Cantidad | ….
Devuelve los productos con Nutri-Score y avisos, listos para add_order_to_cart.
Así tu sistema produce el menú y la skill lo ejecuta en el carrito (supervisado).
Mercadona no publica Nutri-Score; se obtiene cruzando su ean con Open Food
Facts. La skill prioriza el mejor grado entre variantes equivalentes,
avisa en el umbral del perfil o peor (nutri_warnings) y propone
alternativas más sanas (suggest_healthier) que puedes aplicar con
substitute_in_cart.
Nunca paga: el agente para en el carrito; el cobro lo confirma una persona.
Cobertura parcial: si Open Food Facts no tiene el EAN (muchos Hacendado y
todo el fresco/peso variable), el grado es ? = "sin dato". No se asume nada.
API no oficial: Mercadona puede cambiarla sin aviso. Cachea (catalog.json)
y respeta sus Términos. Apta para automatización personal, no producción crítica.
Verificación robusta: el carrito se valida leyendo su estado real, no fiándose del clic; reintenta lo que falte; lee siempre desde página válida.
server.py — el MCP (FastMCP). 14 herramientas.
mercadona_api.py — cliente del catálogo: descarga cacheada + matcher difuso.
nutriscore.py — Nutri-Score + alérgenos vía EAN→Open Food Facts (cacheado).
intake.py — perfil de usuario (onboarding) y umbral de avisos.
menu.py — ingesta de menús de tu sistema (HTML o JSON) → pedido.
commands/mercadona-pedido.md — el comando/skill para Claude Code.
requirements.txt, .mcp.json
Ficheros generados en uso (no se distribuyen): catalog.json, nutri_cache.json,
profile.json, .mcp-chrome-profile/.
This server cannot be deployed
Turn any shopping list into a ready-to-checkout grocery cart across 26 European supermarkets.
AI meal plans that fill your Kroger/Instacart cart - pantry-aware lists, all from chat.
Household-aware cooking brain: pantry, meal suggestions, dietary safety, recipes, shopping lists.
AI-powered kitchen management — pantry, recipes, meal plans, shopping lists
