Pepesto 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-mcp

Einen API-Schlüssel erhalten

1. Beginnen Sie mit einem Pay-as-you-go-Guthabenpaket – siehe https://www.pepesto.com/pricing/.

2. Erstellen Sie einen API-Schlüssel, indem Sie /link mit 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"}'

3. Legen Sie den Schlüssel in Ihrer Umgebung fest:

   export PEPESTO_API_KEY=pep_sk_…

Tools

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_oneshot mit content_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_suggest mit query: "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_products mit dem kg_token des gewählten Rezepts und supermarket_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_parse mit recipe_url]

Assistent: Pizza Margherita in 4 easy steps – 8 Zutaten: Weizenmehl, Trockenhefe, ...

Benutzer: Mappe diese jetzt auf Sainsbury's-Produkte.

Assistent: [Verwendet pepesto_products mit dem zurückgegebenen kg_token und supermarket_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_suggest mit query: "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_products mit allen fünf kg_tokens und supermarket_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_products zweimal – supermarket_domain: "spesaonline.esselunga.it", dann supermarket_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_catalog ist 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_catalog mit supermarket_domain: "plus.nl"]

Assistent: Katalog geladen: 1.847 SKUs in 23 Kategorien.

Unterstützte Supermärkte

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_oneshot zurückgegebene redirect_url in einem Browser oder geben Sie dem Benutzer die Liste der passenden Produkte aus pepesto_products und 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_products nehmen 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_credits ist kostenlos – rufen Sie es jederzeit für eine schnelle Guthabenabfrage auf.

• pepesto_oneshot, pepesto_parse, pepesto_suggest und pepesto_products sind die täglichen Aufrufe (Rezept abgleichen, Woche planen, Warenkörbe vergleichen) und sind für die routinemäßige Agentennutzung bepreist.

• pepesto_catalog fü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 – /session einbinden, damit ein Agent eine Checkout-Sitzung auf Pepesto-Seite aus ausgewählten SKUs erstellen kann.

• pepesto_checkout – /checkout einbinden, 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:coverage

Führen Sie den Inspektor gegen den lokalen Build aus:

PEPESTO_API_KEY=pep_sk_… npm run inspector

Lizenz

Der Pepesto MCP-Server in diesem Repository ist unter der MIT-Lizenz lizenziert.