Pepesto MCP Server
OfficialThe Pepesto MCP Server enables AI agents to turn recipes into matched supermarket shopping carts with live prices across 26 European supermarkets (Tesco, Sainsbury's, Albert Heijn, Rewe, Coop, and more).
One-shot recipe to cart (
pepesto_oneshot): Convert a recipe URL, text, or image into a ready-to-checkout cart for a chosen supermarket, returning aredirect_urlto complete the purchase via the Pepesto app.Parse recipes (
pepesto_parse): Extract structured data (ingredients, nutrition, instructions, allergens) from a recipe URL, text, or image, generating aKgTokenfor product matching.Search recipes (
pepesto_suggest): Search 1M+ recipes by free-text query with filters for cuisine, diet, time, and servings — each result includes aKgToken.Map ingredients to products (
pepesto_products): Convert one or moreKgTokens (plus optional manual items) into real supermarket SKUs with live prices, images, and promotion info. Supports merging multiple recipes into a single unified cart.Full catalog dump (
pepesto_catalog): Retrieve a complete indexed catalog (~1–2k SKUs) for a specific supermarket, useful for market analysis or price-comparison dashboards (caching recommended).Check API credits (
pepesto_credits): Check your remaining API credit balance — this call is free.Price comparison: Run the same recipe through
pepesto_productsfor multiple supermarkets to find the best deal.Weekly meal planning: Fetch multiple recipes and merge their ingredients into one consolidated shopping cart.
Allows AI agents to search recipes and match ingredients to products available at Albert Heijn with live prices and checkout links.
Allows AI agents to search recipes and match ingredients to products available at ASDA with live prices and checkout links.
Allows AI agents to search recipes and match ingredients to products available at Auchan (Poland) with live prices and checkout links.
Allows AI agents to search recipes and match ingredients to products available at Morrisons with live prices and checkout links.
Allows AI agents to search recipes and match ingredients to products available at REWE with live prices and checkout links.
Allows AI agents to search recipes and match ingredients to products available at Tesco (UK and Ireland) with live prices and checkout links.
Pepesto MCP Server
MCP server for the Pepesto API — give your agent the ability to turn any recipe (a URL, plain text, or a photo) into a matched basket of real supermarket products with live prices, across 26 European supermarkets. The MCP covers the recipe → matched cart half of the workflow (parse / search / map ingredients to SKUs / check catalogs); placing the actual order is a separate step — see Where checkout actually happens.
Quick install
Claude Desktop
Add to 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
Getting an API key
Most tools need a key, but
pepesto_predirectis public and free — it works with no key at all (the end user pays when they check out in the app).
Start with a pay-as-you-go credit pack — see https://www.pepesto.com/pricing/.
Mint an API key by calling
/linkwith the email you used at checkout. The key is returned only once — store it immediately.curl -X POST https://s.pepesto.com/api/link \ -H "Content-Type: application/json" \ -d '{"email":"you@example.com"}'Set the key in your environment:
export PEPESTO_API_KEY=pep_sk_…
Tools
Tool | Endpoint | Description |
|
| One-shot recipe → matched cart, including a |
|
| Free, no API key. Shopping list → deferred deep link ( |
|
| Parse a URL/text/image recipe into structured ingredients + |
|
| Search Pepesto's 1M+ recipe graph. |
|
| Map |
|
| Full SKU dump for a supermarket. Only when explicitly requested; cache results. |
|
| Check remaining credits. Free. |
The MCP stops at "matched cart with prices" — see Where checkout actually happens for how users finish the order. /session, /checkout, and /link are intentionally not wrapped; see Roadmap for what's planned.
Example conversations
Quick: recipe URL → matched cart
The fastest path. One tool call returns a matched cart and a checkout link.
User: Use the BBC Good Food pizza margherita recipe to build a Tesco cart, and also add sparkling water and olive oil.
Assistant: [Uses
pepesto_oneshotwithcontent_urls,content_text,supermarket_domain: "tesco.com"]Assistant: Cart matched at Tesco. Checkout link:
<redirect_url>.
Free, deferred handoff → end user pays (pepesto_predirect)
When the API client doesn't want to pay for matching and a deferred deep link is acceptable. pepesto_predirect is free and needs no API key: it returns instantly with a link, and parsing + product matching happen lazily once the user opens it. The user is charged when they proceed to checkout in the Pepesto app (if the app isn't installed, they're sent to the app store first and the list is preserved).
Who this is for:
pepesto_predirectis an end-user / agent-facing tool, not a developer-integration endpoint. It's the right fit when a person is chatting with an assistant (Claude Desktop, ChatGPT, etc.) and wants to hand their shopping list off to their own phone — the agent returns a link, the user finishes (and pays) in the app. If you're a developer building a product on top of Pepesto, you'll usually wantpepesto_oneshot(matched cart up front, you pay) instead. Got a developer use case forpredirectanyway? Tell us — we'd love to hear it.
Use pepesto_predirect when the cost should fall on the end user; use pepesto_oneshot when the client wants the basket matched up front (with prices) and is willing to pay for it.
User: Here's my weekly shopping list — just give me a link I can open on my phone to finish in the Pepesto app.
Assistant: [Uses
pepesto_predirectwithshopping_list: "2 avocados\n1 loaf of bread\n500 g tomatoes\n..."]Assistant: Done — 🛒 Open your shopping list in Pepesto → Free to open · 3 items ready · you only pay at checkout in the app. Open it on your phone (on a computer it'll show a QR code to scan).
The tool returns this as ready-to-show Markdown — one tappable, labeled link plus a short caption — so the long redirect_url is never dumped as raw text.
Browse the recipe graph → pick → matched cart
For "find me something to cook" prompts, where the agent searches Pepesto's recipe graph first and returns matched products with prices.
User: Find me a vegan pasta recipe for two.
Assistant: [Uses
pepesto_suggestwithquery: "vegan pasta dinner for two"]Assistant: Three options: Creamy Cashew Penne, Lemon Garlic Spaghetti, Roasted Veg Rigatoni. Which would you like?
User: Go with the first one. Shop it at Coop (coop.ch).
Assistant: [Uses
pepesto_productswith the chosen recipe'skg_tokenandsupermarket_domain: "coop.ch"]Assistant: Matched 8 ingredients at Coop — cashews CHF 4.20, penne CHF 1.95, ... — total CHF 18.40.
Parse a specific recipe → matched cart
When the user already has a recipe URL or text in mind. The MCP returns the matched product list — what to do with it is up to you.
User: Parse this and break out the ingredients: https://www.bbcgoodfood.com/recipes/pizza-margherita-4-easy-steps
Assistant: [Uses
pepesto_parsewithrecipe_url]Assistant: Pizza Margherita in 4 easy steps — 8 ingredients: strong bread flour, fast-action yeast, ...
User: Now match those to Sainsbury's products.
Assistant: [Uses
pepesto_productswith the returnedkg_tokenandsupermarket_domain: "sainsburys.co.uk"]Assistant: Matched 8 ingredients at Sainsbury's — total £6.40.
Weekly meal plan → one merged matched cart
Multiple kg_tokens through pepesto_products in a single call — Pepesto merges duplicated ingredients across recipes.
User: Plan 5 keto dinners for the week and match them at Delhaize.
Assistant: [Uses
pepesto_suggestwithquery: "keto dinner low carb high protein", num_to_fetch: 5]Assistant: Five dinners: Steak & Kale, Salmon Avocado Bowl, Zucchini Lasagna, Cauliflower Risotto, Chicken Caesar.
User: Build one shopping list that covers the whole week.
Assistant: [Uses
pepesto_productswith all fivekg_tokensandsupermarket_domain: "delhaize.be"]Assistant: Combined match: 24 unique ingredients (some shared across recipes), estimated total €68.40 at Delhaize.
Compare prices across two supermarkets
Run the same recipe through pepesto_products for each market and compare totals.
User: Parse this Sunday lunch recipe.
Assistant: [Uses
pepesto_parse]Assistant: Got it: Italian Sunday Lunch, 12 ingredients.
User: Show me the cart at both Esselunga and Conad so I can compare.
Assistant: [Uses
pepesto_productstwice —supermarket_domain: "spesaonline.esselunga.it", thensupermarket_domain: "spesaonline.conad.it"]Assistant: Esselunga: €34.20. Conad: €31.50. Conad is €2.70 cheaper, mostly on pasta and tomatoes.
Catalog dump for market analysis
Only on explicit request, and cache aggressively — see Pricing & best practices below.
User: I'm building a price-comparison dashboard. Pull the full Plus NL catalog.
Assistant: Heads up —
pepesto_catalogis the most expensive call here. I'll only run it once; you should cache the result for at least a day. Confirm?User: Yes.
Assistant: [Uses
pepesto_catalogwithsupermarket_domain: "plus.nl"]Assistant: Catalog dumped: 1,847 SKUs across 23 categories.
Supported supermarkets
# | Country | Supermarket | 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 |
Need a supermarket that isn't on this list? Contact Pepesto.
Where checkout actually happens
This MCP stops at "matched cart with prices." It does not automate placing the order on the supermarket's website. Two ways to finish the trip:
Pepesto app (recommended). Open the
redirect_urlreturned bypepesto_oneshotin a browser, or hand the user the matched-product list frompepesto_productsand tell them to recreate it in the Pepesto app — that's where the hosted checkout flow lives, including login, basket review, and (for some markets) payment.The supermarket's own site. The user can take the matched product list from
pepesto_productsand add the SKUs directly on tesco.com / coop.ch / etc. Slower, but no Pepesto account needed.
Pricing & best practices
Pepesto runs on simple pay-as-you-go credits — you only pay for what your agents actually use, and credits never expire, so a top-up is yours until you spend it. We also offer discounts for students and early-stage teams, so say hi if that sounds like you. Full per-call pricing and volume tiers live at https://www.pepesto.com/pricing/.
A few tips to get the most out of every credit:
pepesto_creditsis free — call it any time for a quick balance read-out.pepesto_predirectis free and needs no API key — it defers matching and bills the end user at checkout, so it costs the API client nothing.pepesto_oneshot,pepesto_parse,pepesto_suggest, andpepesto_productsare the everyday calls (match a recipe, plan a week, compare baskets) and are priced for routine agent use.pepesto_catalogdoes a full SKU dump for a supermarket and is the heaviest call. It's the right tool for genuine market analysis or price-comparison dashboards — just cache the result for at least a day per supermarket. Not sure you need it? Tell us about your use case and we'll usually point you to a cheaper path.
Roadmap
Planned to follow:
pepesto_session— wrap/sessionso an agent can build a Pepesto-side checkout session from selected SKUs.pepesto_checkout— wrap/checkout, the turn-by-turn browser-automation loop that drives the supermarket's own site (login, add-to-basket, prompt-for-CAPTCHA, etc.). This is the missing piece for fully autonomous shopping.Hosted-checkout handoff — surface the Pepesto-app deep link as a structured tool result (instead of free text), so MCP clients can render it as a button instead of a URL.
If any of these would unblock you, tell us — it'll move them up the queue.
Development
git clone https://github.com/pepesto-solutions/pepesto-mcp.git
cd pepesto-mcp
npm install
npm run build
npm test
npm run test:coverageRun the inspector against the local build:
PEPESTO_API_KEY=pep_sk_… npm run inspectorLicense
The Pepesto MCP server in this repository is licensed under the MIT License.
Deploy
Deploy the Pepesto MCP on Glama.
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-