Pepesto MCP Server
OfficialServidor MCP de Pepesto
Servidor MCP para la API de Pepesto: dota a tu agente de la capacidad de convertir cualquier receta (una URL, texto plano o una foto) en una cesta de productos reales de supermercado con precios en tiempo real, en 26 supermercados europeos. El MCP cubre la mitad del flujo de trabajo correspondiente a receta → cesta coincidente (analizar / buscar / asignar ingredientes a SKU / consultar catálogos); realizar el pedido real es un paso independiente; consulta Dónde se realiza el pago realmente.
Instalación rápida
Claude Desktop
Añádelo a claude_desktop_config.json:
{
"mcpServers": {
"pepesto": {
"command": "npx",
"args": ["-y", "@pepesto/pepesto-mcp"],
"env": { "PEPESTO_API_KEY": "pep_sk_…" }
}
}
}Claude Code
claude mcp add pepesto -e PEPESTO_API_KEY=pep_sk_… -- npx -y @pepesto/pepesto-mcpRelated MCP server: Swissgroceries MCP
Obtención de una clave API
Empieza con un paquete de crédito de pago por uso; consulta https://www.pepesto.com/pricing/.
Genera una clave API llamando a
/linkcon el correo electrónico que utilizaste al finalizar la compra. La clave se devuelve solo una vez; guárdala inmediatamente.curl -X POST https://s.pepesto.com/api/link \ -H "Content-Type: application/json" \ -d '{"email":"you@example.com"}'Configura la clave en tu entorno:
export PEPESTO_API_KEY=pep_sk_…
Herramientas
Herramienta | Endpoint | Descripción |
|
| Receta única → cesta coincidente, incluyendo una |
|
| Analiza una receta de URL/texto/imagen en ingredientes estructurados + |
|
| Busca en el grafo de recetas de más de 1 millón de Pepesto. |
|
| Asigna |
|
| Volcado completo de SKU para un supermercado. Solo cuando se solicite explícitamente; almacena los resultados en caché. |
|
| Comprueba los créditos restantes. Gratuito. |
El MCP se detiene en "cesta coincidente con precios"; consulta Dónde se realiza el pago realmente para saber cómo los usuarios finalizan el pedido. /session, /checkout y /link no están envueltos intencionadamente; consulta Hoja de ruta para conocer lo que está planeado.
Ejemplos de conversaciones
Rápido: URL de receta → cesta coincidente
El camino más rápido. Una llamada a la herramienta devuelve una cesta coincidente y un enlace de pago.
Usuario: Usa la receta de pizza margherita de BBC Good Food para crear una cesta de Tesco, y añade también agua con gas y aceite de oliva.
Asistente: [Usa
pepesto_oneshotconcontent_urls,content_text,supermarket_domain: "tesco.com"]Asistente: Cesta coincidente en Tesco. Enlace de pago:
<redirect_url>.
Navegar por el grafo de recetas → elegir → cesta coincidente
Para prompts del tipo "encuéntrame algo para cocinar", donde el agente busca primero en el grafo de recetas de Pepesto y devuelve productos coincidentes con precios.
Usuario: Encuéntrame una receta de pasta vegana para dos.
Asistente: [Usa
pepesto_suggestconquery: "vegan pasta dinner for two"]Asistente: Tres opciones: Penne cremosos de anacardos, Espaguetis de limón y ajo, Rigatoni de verduras asadas. ¿Cuál te gustaría?
Usuario: Quédate con la primera. Cómprala en Coop (coop.ch).
Asistente: [Usa
pepesto_productscon elkg_tokende la receta elegida ysupermarket_domain: "coop.ch"]Asistente: 8 ingredientes coincidentes en Coop: anacardos CHF 4.20, penne CHF 1.95, ... — total CHF 18.40.
Analizar una receta específica → cesta coincidente
Cuando el usuario ya tiene en mente una URL o texto de receta. El MCP devuelve la lista de productos coincidentes; qué hacer con ella depende de ti.
Usuario: Analiza esto y desglosa los ingredientes: https://www.bbcgoodfood.com/recipes/pizza-margherita-4-easy-steps
Asistente: [Usa
pepesto_parseconrecipe_url]Asistente: Pizza Margherita en 4 sencillos pasos — 8 ingredientes: harina de fuerza, levadura de acción rápida, ...
Usuario: Ahora asígnalos a productos de Sainsbury's.
Asistente: [Usa
pepesto_productscon elkg_tokendevuelto ysupermarket_domain: "sainsburys.co.uk"]Asistente: 8 ingredientes coincidentes en Sainsbury's — total £6.40.
Plan de comidas semanal → una cesta coincidente fusionada
Varios kg_tokens a través de pepesto_products en una sola llamada: Pepesto fusiona los ingredientes duplicados entre recetas.
Usuario: Planifica 5 cenas keto para la semana y asígnalas en Delhaize.
Asistente: [Usa
pepesto_suggestconquery: "keto dinner low carb high protein", num_to_fetch: 5]Asistente: Cinco cenas: Filete y col rizada, Bol de salmón y aguacate, Lasaña de calabacín, Risotto de coliflor, César de pollo.
Usuario: Crea una lista de la compra que cubra toda la semana.
Asistente: [Usa
pepesto_productscon los cincokg_tokensysupermarket_domain: "delhaize.be"]Asistente: Coincidencia combinada: 24 ingredientes únicos (algunos compartidos entre recetas), total estimado €68.40 en Delhaize.
Comparar precios entre dos supermercados
Ejecuta la misma receta a través de pepesto_products para cada mercado y compara los totales.
Usuario: Analiza esta receta de almuerzo de domingo.
Asistente: [Usa
pepesto_parse]Asistente: Entendido: Almuerzo italiano de domingo, 12 ingredientes.
Usuario: Muéstrame la cesta tanto en Esselunga como en Conad para poder comparar.
Asistente: [Usa
pepesto_productsdos veces:supermarket_domain: "spesaonline.esselunga.it", luegosupermarket_domain: "spesaonline.conad.it"]Asistente: Esselunga: €34.20. Conad: €31.50. Conad es €2.70 más barato, principalmente en pasta y tomates.
Volcado de catálogo para análisis de mercado
Solo bajo petición explícita, y almacena en caché de forma agresiva; consulta Precios y mejores prácticas a continuación.
Usuario: Estoy creando un panel de comparación de precios. Extrae el catálogo completo de Plus NL.
Asistente: Ten en cuenta que
pepesto_cataloges la llamada más cara aquí. Solo la ejecutaré una vez; deberías almacenar el resultado en caché durante al menos un día. ¿Confirmas?Usuario: Sí.
Asistente: [Usa
pepesto_catalogconsupermarket_domain: "plus.nl"]Asistente: Catálogo volcado: 1.847 SKU en 23 categorías.
Supermercados compatibles
# | País | Supermercado | Dominio / ID |
2 | 🇬🇧 GB | Sainsbury's | sainsburys.co.uk |
3 | 🇬🇧 GB | ASDA | asda.com |
4 | 🇬🇧 GB | Morrisons | groceries.morrisons.com |
5 | 🇬🇧 GB | Waitrose | waitrose.com |
1 | 🇬🇧 GB | Tesco | tesco.com |
6 | 🇳🇱 NL | Albert Heijn | ah.nl |
7 | 🇳🇱 NL | Jumbo | jumbo.com |
8 | 🇳🇱 NL | Plus NL | plus.nl |
9 | 🇩🇪 DE | Rewe | shop.rewe.de |
10 | 🇨🇭 CH | Coop CH | coop.ch |
11 | 🇨🇭 CH | Migros | migros.ch |
12 | 🇨🇭 CH | Farmy | farmy.ch |
13 | 🇨🇭 CH | Aldi CH | aldi-now.ch |
14 | 🇧🇪 BE | Colruyt | colruyt.be |
15 | 🇧🇪 BE | Delhaize | delhaize.be |
16 | 🇮🇪 IE | Tesco IE | tesco.ie |
17 | 🇮🇪 IE | SuperValu | shop.supervalu.ie |
18 | 🇮🇪 IE | Dunnes | dunnesstoresgrocery.com |
19 | 🇮🇹 IT | Esselunga | spesaonline.esselunga.it |
20 | 🇮🇹 IT | Conad | spesaonline.conad.it |
21 | 🇩🇰 DK | Nemlig | nemlig.com |
22 | 🇳🇴 NO | Meny | meny.no |
23 | 🇵🇱 PL | Frisco | frisco.pl |
24 | 🇵🇱 PL | Auchan PL | zakupy.auchan.pl |
25 | 🇧🇬 BG | Bulmag | bulmag.org |
26 | 🇧🇬 BG | eBag | ebag.bg |
¿Necesitas un supermercado que no esté en esta lista? Contacta con Pepesto.
Dónde se realiza el pago realmente
Este MCP se detiene en "cesta coincidente con precios". No automatiza la realización del pedido en el sitio web del supermercado. Dos formas de terminar el viaje:
Aplicación Pepesto (recomendado). Abre la
redirect_urldevuelta porpepesto_oneshoten un navegador, o entrega al usuario la lista de productos coincidentes depepesto_productsy dile que la recree en la aplicación Pepesto: ahí es donde reside el flujo de pago alojado, incluyendo inicio de sesión, revisión de cesta y (para algunos mercados) pago.El propio sitio del supermercado. El usuario puede tomar la lista de productos coincidentes de
pepesto_productsy añadir los SKU directamente en tesco.com / coop.ch / etc. Más lento, pero no se necesita una cuenta de Pepesto.
Precios y mejores prácticas
Pepesto funciona con créditos simples de pago por uso: solo pagas por lo que tus agentes realmente usan, y los créditos nunca caducan, por lo que una recarga es tuya hasta que la gastes. También ofrecemos descuentos para estudiantes y equipos en fase inicial, así que salúdanos si ese es tu caso. Los precios completos por llamada y los niveles de volumen se encuentran en https://www.pepesto.com/pricing/.
Algunos consejos para aprovechar al máximo cada crédito:
pepesto_creditses gratuito: llámalo en cualquier momento para una lectura rápida del saldo.pepesto_oneshot,pepesto_parse,pepesto_suggestypepesto_productsson las llamadas cotidianas (coincidir una receta, planificar una semana, comparar cestas) y tienen un precio para el uso rutinario del agente.pepesto_catalogrealiza un volcado completo de SKU para un supermercado y es la llamada más pesada. Es la herramienta adecuada para análisis de mercado genuinos o paneles de comparación de precios; simplemente almacena el resultado en caché durante al menos un día por supermercado. ¿No estás seguro de si lo necesitas? Cuéntanos tu caso de uso y normalmente te indicaremos un camino más barato.
Hoja de ruta
Planificado a continuación:
pepesto_session: envuelve/sessionpara que un agente pueda crear una sesión de pago del lado de Pepesto a partir de los SKU seleccionados.pepesto_checkout: envuelve/checkout, el bucle de automatización del navegador paso a paso que controla el propio sitio del supermercado (inicio de sesión, añadir a la cesta, solicitar CAPTCHA, etc.). Esta es la pieza que falta para una compra totalmente autónoma.Entrega de pago alojado: muestra el enlace profundo de la aplicación Pepesto como un resultado de herramienta estructurado (en lugar de texto libre), para que los clientes de MCP puedan renderizarlo como un botón en lugar de una URL.
Si alguno de estos te desbloquearía, cuéntanoslo: los moverá hacia arriba en la cola.
Desarrollo
git clone https://github.com/pepesto-solutions/pepesto-mcp.git
cd pepesto-mcp
npm install
npm run build
npm test
npm run test:coverageEjecuta el inspector contra la compilación local:
PEPESTO_API_KEY=pep_sk_… npm run inspectorLicencia
El servidor MCP de Pepesto en este repositorio está bajo la Licencia MIT.
Available Tools
7 toolspepesto_catalogPepesto Catalog (full SKU dump)A
Dump Pepesto's full indexed catalog for a supermarket (~1-2k SKUs of common cooking ingredients, with names, prices, images, IDs). Optionally pass a webhook_url to receive incremental updates on re-index. Use only when the user has explicitly asked for a catalog dump, market analysis, or storefront build; for normal recipe-to-cart flows use pepesto_oneshot or pepesto_products instead. Cache this query aggressively, no more than one call per day per supermarket is recommended. When presenting supermarket results the user, use the product key as (external) link to the supermarket product itself. Show image if available (json property image_url, don't search for external images, skip rendering the Pepesto image if the image has webp extesion)
Inputs: supermarket_domain (required), webhook_url.
pepesto_creditsPepesto Credits (check balance)A
Return the remaining API credits on the configured Pepesto API key.
Inputs: no named parameters.
pepesto_oneshotPepesto Oneshot (recipe → cart)A
One-shot: turn recipe URLs, free-form text, and/or an image into a ready-to-checkout cart for a chosen European supermarket. Returns a redirect_url that opens the Pepesto checkout UI for the user to verify and pay. Internally runs parse + products + session (not exposed to agents) with Pepesto's heuristics. Use this when you want the simplest end-to-end flow; use pepesto_parse + pepesto_products + session (not exposed to agents) for finer control.
Inputs: content_urls, content_text, content_image, supermarket_domain.
pepesto_parsePepesto Parse (recipe → structured ingredients)B
Parse a recipe from a URL, free-form text, or image into a structured object: title, ingredients, nutrition, instructions, and a KgToken you can pass to pepesto_products to build a real cart. Once the response is returned, show recipe title, image if available (json property image_url, don't search for external images, skip rendering the Pepesto image if the image has webp extesion), ingredients, steps, nutrition summary, allergens clearly marked, and portions/servings if available. Don't show kg_token, but mark and save it for the next steps (e.g., /products call).
Inputs: recipe_url, recipe_text, recipe_image, locale, +1 more.
pepesto_predirectPepesto Predirect (free deferred shopping link)A
Turn a free-form shopping list into a deferred deep link to the Pepesto mobile app, returned as a redirect_url. This is a PUBLIC endpoint: it is FREE to the API client, needs no API key, and returns instantly. Parsing and product matching happen lazily, only after the user opens the link — and the USER (not the API client) is charged when they proceed to checkout in the app. If the app isn't installed, the user is sent to the app store first and the shopping list is preserved until the app opens. This is an end-user / agent-facing handoff (e.g. a person chatting in Claude Desktop who wants to finish shopping on their phone), not a developer-integration endpoint. Choose pepesto_predirect when the cost should fall on the end user and a deferred deep link is acceptable. Choose pepesto_oneshot instead when the client wants the basket matched up front (with prices) and is willing to pay for the matching. PRESENTATION (important): the tool's text output is ready-to-show Markdown — a single tappable, labeled link plus a one-line caption. Surface it to the user exactly as returned; do NOT also paste the long raw URL as plain text. You may add one short sentence telling them to open it on their phone (on a computer, opening it shows a QR code to scan).
Inputs: shopping_list (required), locale.
pepesto_productsPepesto Products (KgToken → real SKUs)A
Map one or more recipe KgTokens (and an optional manual shopping list) to concrete supermarket products with prices, images, or currency. Items are merged across recipes to reduce waste; multiple matches per ingredient let you (or the user) pick. Show product title, image if available (json property image_url, don't search for external images, skip rendering the Pepesto image if the image has webp extesion)product_id when available linking to an (external) supermarket page (open in a new tab), price, ProductClassification (is_bio, is_frozen, is_substitution) tags. PricePromotion shows if the item is currently on promotion and what's current promo_percentage
Inputs: recipe_kg_tokens (required), supermarket_domain (required), manual_shopping_list.
pepesto_suggestPepesto Suggest (search 1M+ recipes)A
Search Pepesto's recipe graph (1M+ recipes) by free-text query and optional filters (cuisine, dietary tags, ingredients to include/avoid, time, servings). Each result includes a KgToken you can pass to pepesto_products. Returned images are licensed for display in your app or website without attribution. Show recipe title, image if available (json property image_url, don't search for external images, skip rendering the Pepesto image if the image has webp extesion), ingredients, steps, nutrition summary, allergens clearly marked, and portions/servings if available. Don't show kg_token, but mark and save it for the next steps (e.g., /products call).
Inputs: query (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool has a distinct role in the recipe-to-cart workflow, but pepesto_oneshot and pepesto_predirect both produce redirect URLs from free-form lists, and pepesto_parse/pepesto_suggest both return KgTokens with similar recipe presentation. The descriptions differentiate them well enough, so this is only a minor ambiguity.
All tools share the pepesto_ prefix, which is helpful, but the naming convention is mixed: some are action verbs (parse, suggest), some are resource nouns (credits, products, catalog), and some are coined terms (oneshot, predirect). The names are readable but not predictable from a single pattern.
Seven tools is well-scoped for the server's purpose. Each tool covers a distinct step or entry point in the recipe-to-cart workflow, with no obvious bloat or thinness.
The surface covers recipe discovery, parsing, product mapping, catalog access, and end-to-end checkout flows. The main gap is that no separate session/checkout tool is exposed for fine-grained flows after pepesto_products, though pepesto_oneshot covers the common end-to-end path.
Maintenance
Related MCP Connectors
Hosted MCP for e-commerce: live product catalog, stock, and pricing for AI agents.
Recipe search, ingredient matching, nutrition filters and a private cookbook for any AI agent.
Unlock the power of food transparency with our Open Food Facts MCP server. Easily look up any food
Hosted MCP server to manage a restaurant menu from AI agents - 39 tools over the DuckHub API.
Related MCP Servers
- AlicenseBqualityBmaintenanceA FastMCP server that provides AI assistants like Claude with seamless access to Kroger's grocery shopping functionality through the Model Context Protocol, enabling store finding, product searching, and cart management.3174 PyPI84MIT
- FlicenseAqualityBmaintenanceA Model Context Protocol server for real-time Swiss grocery shopping that searches and compares products across 8 major Swiss retailers (Migros, Coop, Aldi, Denner, Lidl, Farmy, Volgshop, Otto’s), normalizes per-unit prices, surfaces promotions, computes optimal multi-store shopping plans, and works with any MCP-compatible client without API keys or accounts.7215 npm46-
- AlicenseNot gradedqualityDmaintenanceMCP server for Frisco.pl — lets Claude add groceries to your cart, search products, get nutritional info, and manage recipes, all via natural language.8MIT
- FlicenseAqualityDmaintenanceMCP server enabling AI assistants to manage recipes and ingredients in the WeekPlan app via its REST API.81-