Pepesto MCP Server
OfficialPepesto MCP-Server
MCP-Server für die Pepesto-API – geben Sie Ihrem Agenten die Möglichkeit, jedes Rezept (eine URL, reinen Text oder ein Foto) in einen passenden Warenkorb mit echten Supermarktprodukten und Live-Preisen bei 26 europäischen Supermärkten zu verwandeln. Das MCP deckt die Hälfte des Workflows ab: Rezept → passender Warenkorb (parsen / suchen / Zutaten auf SKUs mappen / Kataloge prüfen); das eigentliche Bestellen ist ein separater Schritt – siehe Wo der Checkout tatsächlich stattfindet.
Schnelle Installation
Claude Desktop
Fügen Sie dies zu claude_desktop_config.json hinzu:
{
"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
Einen API-Schlüssel erhalten
Beginnen Sie mit einem Pay-as-you-go-Guthabenpaket – siehe https://www.pepesto.com/pricing/.
Erstellen Sie einen API-Schlüssel, indem Sie
/linkmit der E-Mail-Adresse aufrufen, die Sie beim Checkout verwendet haben. Der Schlüssel wird nur einmal angezeigt – speichern Sie ihn sofort.curl -X POST https://s.pepesto.com/api/link \ -H "Content-Type: application/json" \ -d '{"email":"you@example.com"}'Legen Sie den Schlüssel in Ihrer Umgebung fest:
export PEPESTO_API_KEY=pep_sk_…
Tools
Tool | Endpunkt | Beschreibung |
|
| One-Shot Rezept → passender Warenkorb, inklusive |
|
| Rezept-URL/Text/Bild in strukturierte Zutaten + |
|
| Pepestos Rezept-Graph mit über 1 Mio. Einträgen durchsuchen. |
|
|
|
|
| Vollständiger SKU-Dump für einen Supermarkt. Nur bei expliziter Anforderung; Ergebnisse zwischenspeichern. |
|
| Verbleibendes Guthaben prüfen. Kostenlos. |
Das MCP endet beim „passenden Warenkorb mit Preisen“ – siehe Wo der Checkout tatsächlich stattfindet, wie Benutzer die Bestellung abschließen. /session, /checkout und /link sind absichtlich nicht eingebunden; siehe Roadmap für geplante Funktionen.
Beispielkonversationen
Schnell: Rezept-URL → passender Warenkorb
Der schnellste Weg. Ein Tool-Aufruf liefert einen passenden Warenkorb und einen Checkout-Link.
Benutzer: Verwende das BBC Good Food Pizza Margherita-Rezept, um einen Tesco-Warenkorb zu erstellen, und füge außerdem Mineralwasser und Olivenöl hinzu.
Assistent: [Verwendet
pepesto_oneshotmitcontent_urls,content_text,supermarket_domain: "tesco.com"]Assistent: Warenkorb bei Tesco zusammengestellt. Checkout-Link:
<redirect_url>.
Den Rezept-Graphen durchsuchen → auswählen → passender Warenkorb
Für „Finde mir etwas zum Kochen“-Prompts, bei denen der Agent zuerst den Rezept-Graphen von Pepesto durchsucht und passende Produkte mit Preisen zurückgibt.
Benutzer: Finde mir ein veganes Pastarezept für zwei Personen.
Assistent: [Verwendet
pepesto_suggestmitquery: "vegan pasta dinner for two"]Assistent: Drei Optionen: Creamy Cashew Penne, Lemon Garlic Spaghetti, Roasted Veg Rigatoni. Welche möchtest du?
Benutzer: Nimm die erste. Kaufe sie bei Coop (coop.ch).
Assistent: [Verwendet
pepesto_productsmit demkg_tokendes gewählten Rezepts undsupermarket_domain: "coop.ch"]Assistent: 8 Zutaten bei Coop gefunden – Cashews CHF 4.20, Penne CHF 1.95, ... – insgesamt CHF 18.40.
Ein spezifisches Rezept parsen → passender Warenkorb
Wenn der Benutzer bereits eine Rezept-URL oder einen Text im Kopf hat. Das MCP gibt die Liste der passenden Produkte zurück – was damit gemacht wird, liegt bei Ihnen.
Benutzer: Parse das hier und liste die Zutaten auf: https://www.bbcgoodfood.com/recipes/pizza-margherita-4-easy-steps
Assistent: [Verwendet
pepesto_parsemitrecipe_url]Assistent: Pizza Margherita in 4 easy steps – 8 Zutaten: Weizenmehl, Trockenhefe, ...
Benutzer: Mappe diese jetzt auf Sainsbury's-Produkte.
Assistent: [Verwendet
pepesto_productsmit dem zurückgegebenenkg_tokenundsupermarket_domain: "sainsburys.co.uk"]Assistent: 8 Zutaten bei Sainsbury's gefunden – insgesamt £6.40.
Wöchentlicher Essensplan → ein zusammengeführter Warenkorb
Mehrere kg_tokens über pepesto_products in einem einzigen Aufruf – Pepesto führt doppelte Zutaten über Rezepte hinweg zusammen.
Benutzer: Plane 5 Keto-Abendessen für die Woche und mappe sie bei Delhaize.
Assistent: [Verwendet
pepesto_suggestmitquery: "keto dinner low carb high protein", num_to_fetch: 5]Assistent: Fünf Abendessen: Steak & Grünkohl, Lachs-Avocado-Bowl, Zucchini-Lasagne, Blumenkohl-Risotto, Chicken Caesar.
Benutzer: Erstelle eine Einkaufsliste, die die ganze Woche abdeckt.
Assistent: [Verwendet
pepesto_productsmit allen fünfkg_tokensundsupermarket_domain: "delhaize.be"]Assistent: Kombinierter Treffer: 24 einzigartige Zutaten (einige werden in mehreren Rezepten verwendet), geschätzte Gesamtsumme €68.40 bei Delhaize.
Preise über zwei Supermärkte vergleichen
Führen Sie dasselbe Rezept über pepesto_products für jeden Markt aus und vergleichen Sie die Summen.
Benutzer: Parse dieses Sonntagsessen-Rezept.
Assistent: [Verwendet
pepesto_parse]Assistent: Erledigt: Italienisches Sonntagsessen, 12 Zutaten.
Benutzer: Zeig mir den Warenkorb bei Esselunga und Conad, damit ich vergleichen kann.
Assistent: [Verwendet
pepesto_productszweimal –supermarket_domain: "spesaonline.esselunga.it", dannsupermarket_domain: "spesaonline.conad.it"]Assistent: Esselunga: €34.20. Conad: €31.50. Conad ist €2.70 günstiger, hauptsächlich bei Pasta und Tomaten.
Katalog-Dump für Marktanalysen
Nur auf explizite Anfrage und bitte aggressiv zwischenspeichern – siehe Preise & Best Practices unten.
Benutzer: Ich baue ein Preisvergleichs-Dashboard. Ziehe den vollständigen Plus NL-Katalog.
Assistent: Hinweis –
pepesto_catalogist der teuerste Aufruf hier. Ich werde ihn nur einmal ausführen; du solltest das Ergebnis für mindestens einen Tag zwischenspeichern. Bestätigen?Benutzer: Ja.
Assistent: [Verwendet
pepesto_catalogmitsupermarket_domain: "plus.nl"]Assistent: Katalog geladen: 1.847 SKUs in 23 Kategorien.
Unterstützte Supermärkte
# | Land | Supermarkt | Domain / 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 |
Benötigen Sie einen Supermarkt, der nicht auf dieser Liste steht? Kontaktieren Sie Pepesto.
Wo der Checkout tatsächlich stattfindet
Dieses MCP endet beim „passenden Warenkorb mit Preisen“. Es automatisiert nicht das Aufgeben der Bestellung auf der Website des Supermarkts. Es gibt zwei Möglichkeiten, den Einkauf abzuschließen:
Pepesto-App (empfohlen). Öffnen Sie die von
pepesto_oneshotzurückgegebeneredirect_urlin einem Browser oder geben Sie dem Benutzer die Liste der passenden Produkte auspepesto_productsund fordern Sie ihn auf, diese in der Pepesto-App nachzubilden – dort befindet sich der gehostete Checkout-Prozess, inklusive Login, Warenkorbprüfung und (für einige Märkte) Bezahlung.Die Website des Supermarkts. Der Benutzer kann die Liste der passenden Produkte aus
pepesto_productsnehmen und die SKUs direkt auf tesco.com / coop.ch / etc. hinzufügen. Langsamer, aber es ist kein Pepesto-Konto erforderlich.
Preise & Best Practices
Pepesto basiert auf einfachen Pay-as-you-go-Guthaben – Sie zahlen nur für das, was Ihre Agenten tatsächlich nutzen, und Guthaben verfällt nie, sodass eine Aufladung Ihnen gehört, bis Sie sie verbrauchen. Wir bieten auch Rabatte für Studenten und Teams in der Frühphase an, also sagen Sie Hallo, falls das auf Sie zutrifft. Die vollständigen Preise pro Aufruf und Volumenstaffeln finden Sie unter https://www.pepesto.com/pricing/.
Ein paar Tipps, um das Beste aus jedem Guthaben herauszuholen:
pepesto_creditsist kostenlos – rufen Sie es jederzeit für eine schnelle Guthabenabfrage auf.pepesto_oneshot,pepesto_parse,pepesto_suggestundpepesto_productssind die täglichen Aufrufe (Rezept abgleichen, Woche planen, Warenkörbe vergleichen) und sind für die routinemäßige Agentennutzung bepreist.pepesto_catalogführt einen vollständigen SKU-Dump für einen Supermarkt durch und ist der aufwendigste Aufruf. Es ist das richtige Werkzeug für echte Marktanalysen oder Preisvergleichs-Dashboards – speichern Sie das Ergebnis einfach für mindestens einen Tag pro Supermarkt zwischen. Nicht sicher, ob Sie es brauchen? Erzählen Sie uns von Ihrem Anwendungsfall und wir zeigen Ihnen normalerweise einen günstigeren Weg.
Roadmap
Geplant sind:
pepesto_session–/sessioneinbinden, damit ein Agent eine Checkout-Sitzung auf Pepesto-Seite aus ausgewählten SKUs erstellen kann.pepesto_checkout–/checkouteinbinden, die Browser-Automatisierungsschleife, die die Website des Supermarkts steuert (Login, in den Warenkorb legen, CAPTCHA-Abfrage, etc.). Dies ist das fehlende Teil für vollautonomes Einkaufen.Übergabe an gehosteten Checkout – den Deep-Link zur Pepesto-App als strukturiertes Tool-Ergebnis ausgeben (statt als reinen Text), damit MCP-Clients ihn als Button statt als URL rendern können.
Wenn einer dieser Punkte Sie blockiert, sagen Sie uns Bescheid – das bringt sie in der Warteschlange nach vorne.
Entwicklung
git clone https://github.com/pepesto-solutions/pepesto-mcp.git
cd pepesto-mcp
npm install
npm run build
npm test
npm run test:coverageFühren Sie den Inspektor gegen den lokalen Build aus:
PEPESTO_API_KEY=pep_sk_… npm run inspectorLizenz
Der Pepesto MCP-Server in diesem Repository ist unter der MIT-Lizenz lizenziert.
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-