Skip to main content
Glama
Pepesto MCP Server

Pepesto MCP Server

Official

Pepesto MCPサーバー

Pepesto API用MCPサーバー — レシピ(URL、プレーンテキスト、写真)を、欧州26のスーパーマーケットのリアルタイム価格に基づいた買い物かごに変換する機能をエージェントに提供します。このMCPは、ワークフローの**「レシピ → マッチング済みカート」**の工程(解析、検索、材料のSKUへのマッピング、カタログ確認)をカバーします。実際の注文確定は別のステップとなります。詳細はチェックアウトの仕組みを参照してください。

クイックインストール

Claude Desktop

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

Related MCP server: Swissgroceries MCP

APIキーの取得

  1. 従量課金制のクレジットパックから開始してください — https://www.pepesto.com/pricing/ を参照。

  2. チェックアウト時に使用したメールアドレスで /link を呼び出し、APIキーを発行します。キーは一度しか表示されないため、すぐに保存してください。

    curl -X POST https://s.pepesto.com/api/link \
      -H "Content-Type: application/json" \
      -d '{"email":"you@example.com"}'
  3. 環境変数にキーを設定します:

    export PEPESTO_API_KEY=pep_sk_…

ツール

ツール

エンドポイント

説明

pepesto_oneshot

POST /oneshot

レシピからマッチング済みカートへの一括変換。チェックアウト用の redirect_url を含みます。

pepesto_parse

POST /parse

URL/テキスト/画像のレシピを構造化された材料 + KgToken に解析します。

pepesto_suggest

POST /suggest

Pepestoの100万件以上のレシピグラフを検索します。

pepesto_products

POST /products

KgToken とスーパーマーケットをマッピングし、価格付きの具体的な商品を取得します。

pepesto_catalog

POST /catalog

スーパーマーケットの全SKUダンプ。明示的に要求された場合のみ使用し、結果をキャッシュしてください。

pepesto_credits

POST /credits

残りクレジットを確認します。無料です。

このMCPは「価格付きマッチング済みカート」までを対象としています。ユーザーが注文を完了する方法についてはチェックアウトの仕組みを参照してください。/session、/checkout、/link は意図的にラップされていません。今後の計画についてはロードマップを参照してください。

会話例

クイック:レシピURL → マッチング済みカート

最速のパスです。1回のツール呼び出しで、マッチング済みカートとチェックアウトリンクが返されます。

ユーザー: BBC Good Foodのピザ・マルゲリータのレシピを使ってTescoのカートを作成し、さらに炭酸水とオリーブオイルを追加して。

アシスタント: [ content_urls、content_text、supermarket_domain: "tesco.com" を指定して pepesto_oneshot を使用]

アシスタント: Tescoでカートがマッチングされました。チェックアウトリンク: <redirect_url>

レシピグラフの閲覧 → 選択 → マッチング済みカート

「何か作るものを探して」というプロンプトに対し、エージェントがまずPepestoのレシピグラフを検索し、価格付きのマッチング済み商品を返す場合です。

ユーザー: 2人用のヴィーガンパスタのレシピを探して。

アシスタント: [ query: "vegan pasta dinner for two" を指定して pepesto_suggest を使用]

アシスタント: 3つの選択肢があります:Creamy Cashew Penne、Lemon Garlic Spaghetti、Roasted Veg Rigatoni。どれにしますか?

ユーザー: 最初のやつで。Coop (coop.ch) で買い物して。

アシスタント: [選択したレシピの kg_token と supermarket_domain: "coop.ch" を指定して pepesto_products を使用]

アシスタント: Coopで8つの材料がマッチングされました — カシューナッツ CHF 4.20、ペンネ CHF 1.95、... — 合計 CHF 18.40。

特定のレシピの解析 → マッチング済みカート

ユーザーがすでにレシピURLやテキストを持っている場合です。MCPはマッチング済み商品リストを返します。その後の処理はユーザー次第です。

ユーザー: これを解析して材料を抽出して: https://www.bbcgoodfood.com/recipes/pizza-margherita-4-easy-steps

アシスタント: [ recipe_url を指定して pepesto_parse を使用]

アシスタント: Pizza Margherita in 4 easy steps — 8つの材料:強力粉、インスタントドライイースト、...

ユーザー: それらをSainsbury'sの商品とマッチングして。

アシスタント: [返された kg_token と supermarket_domain: "sainsburys.co.uk" を指定して pepesto_products を使用]

アシスタント: Sainsbury'sで8つの材料がマッチングされました — 合計 £6.40。

週間の献立 → 1つの統合されたマッチング済みカート

pepesto_products を通じて複数の kg_token を一度に呼び出すと、Pepestoがレシピ間で重複する材料を統合します。

ユーザー: 今週のケトディナーを5つ計画して、Delhaizeでマッチングして。

アシスタント: [ query: "keto dinner low carb high protein"、num_to_fetch: 5 を指定して pepesto_suggest を使用]

アシスタント: 5つのディナー:Steak & Kale、Salmon Avocado Bowl、Zucchini Lasagna、Cauliflower Risotto、Chicken Caesar。

ユーザー: 1週間分をカバーする買い物リストを1つ作って。

アシスタント: [5つすべての kg_tokens と supermarket_domain: "delhaize.be" を指定して pepesto_products を使用]

アシスタント: 統合マッチング:24種類のユニークな材料(レシピ間で共有されているものあり)、Delhaizeでの合計見積もり €68.40。

2つのスーパーマーケット間の価格比較

同じレシピを各マーケットで pepesto_products にかけ、合計を比較します。

ユーザー: この日曜ランチのレシピを解析して。

アシスタント: [ pepesto_parse を使用]

アシスタント: 了解:Italian Sunday Lunch、12種類の材料。

ユーザー: EsselungaとConadの両方のカートを見せて、比較したいから。

アシスタント: [ pepesto_products を2回使用 — supermarket_domain: "spesaonline.esselunga.it" と supermarket_domain: "spesaonline.conad.it"]

アシスタント: Esselunga: €34.20。Conad: €31.50。Conadの方が €2.70 安く、主にパスタとトマトで差が出ています。

市場分析のためのカタログダンプ

明示的な要求があった場合のみ実行し、積極的にキャッシュしてください — 以下の価格とベストプラクティスを参照。

ユーザー: 価格比較ダッシュボードを作っているんだ。Plus NLの全カタログを引っ張ってきて。

アシスタント: 注意 — pepesto_catalog はここで最も高価な呼び出しです。1回だけ実行します。結果は少なくとも1日はキャッシュしてください。実行しますか?

ユーザー: はい。

アシスタント: [ supermarket_domain: "plus.nl" を指定して pepesto_catalog を使用]

アシスタント: カタログをダンプしました:23カテゴリー、1,847 SKU。

対応スーパーマーケット

#

国

スーパーマーケット

ドメイン / 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

リストにないスーパーマーケットが必要ですか?Pepestoまでご連絡ください。

チェックアウトの仕組み

このMCPは「価格付きマッチング済みカート」までを対象としています。スーパーマーケットのウェブサイトでの注文確定を自動化するものではありません。完了までの2つの方法:

  • Pepestoアプリ(推奨)。 pepesto_oneshot が返す redirect_url をブラウザで開くか、pepesto_products からのマッチング済み商品リストをユーザーに渡し、Pepestoアプリで再現するよう伝えてください。ログイン、バスケット確認、支払い(一部の市場)を含むホスト型チェックアウトフローが利用可能です。

  • スーパーマーケットの自社サイト。 ユーザーは pepesto_products からのマッチング済み商品リストを使い、tesco.comやcoop.chなどで直接SKUを追加できます。手間はかかりますが、Pepestoアカウントは不要です。

価格とベストプラクティス

Pepestoはシンプルな従量課金制です。実際に使用した分のみ支払い、クレジットに有効期限はありません。学生や初期段階のチーム向けの割引も提供していますので、該当する場合はご連絡ください。呼び出しごとの詳細な価格とボリュームティアは https://www.pepesto.com/pricing/ を参照してください。

クレジットを最大限に活用するためのヒント:

  • pepesto_credits は無料です — いつでも残高を確認できます。

  • pepesto_oneshot、pepesto_parse、pepesto_suggest、pepesto_products は日常的な呼び出し(レシピマッチング、週間計画、バスケット比較)であり、日常的なエージェント利用に適した価格設定です。

  • pepesto_catalog はスーパーマーケットの全SKUをダンプするため、最も負荷の高い呼び出しです。市場分析や価格比較ダッシュボードには最適ですが、スーパーマーケットごとに少なくとも1日は結果をキャッシュしてください。必要かどうかわからない場合は、ユースケースをお知らせください。より安価な方法をご案内します。

ロードマップ

以下を予定しています:

  • pepesto_session — /session をラップし、エージェントが選択したSKUからPepesto側のチェックアウトセッションを構築できるようにします。

  • pepesto_checkout — /checkout をラップし、スーパーマーケットの自社サイトを操作するブラウザ自動化ループ(ログイン、バスケット追加、CAPTCHA対応など)を実現します。これが完全自律型ショッピングの最後のピースです。

  • ホスト型チェックアウトへの引き継ぎ — Pepestoアプリのディープリンクを構造化されたツール結果として表示し、MCPクライアントがURLではなくボタンとしてレンダリングできるようにします。

これらが必要な場合はお知らせください — 優先順位を上げます。

開発

git clone https://github.com/pepesto-solutions/pepesto-mcp.git
cd pepesto-mcp
npm install
npm run build
npm test
npm run test:coverage

ローカルビルドに対してインスペクターを実行します:

PEPESTO_API_KEY=pep_sk_… npm run inspector

ライセンス

このリポジトリのPepesto MCPサーバーは MITライセンス の下でライセンスされています。

Available Tools

7 tools
pepesto_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

    A3.8/5.0

    Scored across 7 tools

    Disambiguation4/5

    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.

    Naming Consistency3/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      A 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.
      31
      74 PyPI
      84
      MIT
    • F
      license
      A
      quality
      B
      maintenance
      A 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.
      7
      215 npm
      46
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for Frisco.pl — lets Claude add groceries to your cart, search products, get nutritional info, and manage recipes, all via natural language.
      8
      MIT