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 → 장바구니 매칭

가장 빠른 경로입니다. 도구 호출 한 번으로 장바구니 매칭과 결제 링크를 반환합니다.

사용자: 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 사용]

어시스턴트: 세 가지 옵션이 있습니다: 크리미 캐슈 펜네, 레몬 갈릭 스파게티, 구운 채소 리가토니. 어떤 것을 원하시나요?

사용자: 첫 번째 걸로 할게. 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 사용]

어시스턴트: 피자 마르게리타 4단계 레시피 — 8개 재료: 강력분, 인스턴트 이스트 등.

사용자: 이제 이것들을 Sainsbury's 상품으로 매칭해 줘.

어시스턴트: [반환된 kg_token과 supermarket_domain: "sainsburys.co.uk"를 사용하여 pepesto_products 사용]

어시스턴트: Sainsbury's에서 8개 재료가 매칭되었습니다 — 총 £6.40.

주간 식단 계획 → 하나의 통합 장바구니

pepesto_products를 통해 여러 kg_token을 한 번에 호출하면 Pepesto가 레시피 간 중복 재료를 병합합니다.

사용자: 이번 주 5일치 키토 저녁 식단을 계획하고 Delhaize에서 매칭해 줘.

어시스턴트: [query: "keto dinner low carb high protein", num_to_fetch: 5와 함께 pepesto_suggest 사용]

어시스턴트: 다섯 가지 저녁 식단: 스테이크 & 케일, 연어 아보카도 볼, 주키니 라자냐, 콜리플라워 리조또, 치킨 시저.

사용자: 일주일 전체를 아우르는 하나의 쇼핑 리스트를 만들어 줘.

어시스턴트: [5개의 kg_tokens와 supermarket_domain: "delhaize.be"를 사용하여 pepesto_products 사용]

어시스턴트: 통합 매칭: 24개의 고유 재료(일부 레시피 간 공유), Delhaize 예상 총액 €68.40.

두 슈퍼마켓 간 가격 비교

각 마켓에 대해 pepesto_products를 통해 동일한 레시피를 실행하고 합계를 비교합니다.

사용자: 이 일요일 점심 레시피를 파싱해 줘.

어시스턴트: [pepesto_parse 사용]

어시스턴트: 확인했습니다: 이탈리안 일요일 점심, 12개 재료.

사용자: Esselunga와 Conad의 장바구니를 모두 보여줘서 비교할 수 있게 해 줘.

어시스턴트: [supermarket_domain: "spesaonline.esselunga.it"와 supermarket_domain: "spesaonline.conad.it"로 pepesto_products를 두 번 사용]

어시스턴트: Esselunga: €34.20. Conad: €31.50. Conad가 €2.70 더 저렴하며, 주로 파스타와 토마토에서 차이가 납니다.

시장 분석을 위한 카탈로그 덤프

명시적인 요청이 있을 때만 사용하며, 적극적으로 캐싱하세요 — 아래 가격 및 모범 사례를 참조하세요.

사용자: 가격 비교 대시보드를 만들고 있어. Plus NL 전체 카탈로그를 가져와 줘.

어시스턴트: 주의하세요 — pepesto_catalog는 여기서 가장 비용이 많이 드는 호출입니다. 한 번만 실행할 예정이니, 결과를 최소 하루 동안 캐싱해야 합니다. 진행할까요?

사용자: 응.

어시스턴트: [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는 "가격이 포함된 장바구니 매칭" 단계에서 멈춥니다. 슈퍼마켓 웹사이트에서 주문을 자동으로 완료하지는 않습니다. 쇼핑을 마무리하는 두 가지 방법:

  • 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 덤프를 수행하는 가장 무거운 호출입니다. 시장 분석이나 가격 비교 대시보드에 적합한 도구이며, 슈퍼마켓당 최소 하루 동안 결과를 캐싱하세요. 필요한지 확실하지 않으신가요? 사용 사례를 알려주시면 더 저렴한 경로를 안내해 드립니다.

로드맵

다음 기능이 계획되어 있습니다:

  • 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