pepesto-solutions avatar

Pepesto Mcp

pepesto-solutions/pepesto-mcp

Connects Claude to Pepesto's grocery API across 26 European supermarkets in 10 countries. Exposes six tools: oneshot for instant recipe-to-cart, parse for extracting structured ingredients from URLs or images, suggest for searching Pepesto's recipe graph, products for matching ingredient tokens to real SKUs with live prices, catalog for full supermarket dumps, and credits for balance checks. The MCP handles everything up to checkout (parsing, matching, pricing) but stops before order placement. Useful when you need to turn recipes into shoppable carts, compare prices across Tesco vs Sainsbury's, or build meal plans with merged ingredient lists. Requires a Pepesto API key from their pay-as-you-go credit packs.

GitHub stars
7
tools
7
auth
Secret needed
transport
STDIO
env var
1
last updated
Jun 23, 2026

Tools

7 tools

Public tool metadata for what this MCP can expose to an agent.

pepesto_oneshotOne-shot recipe → matched cart, including a `redirect_url` for checkout.

One-shot recipe → matched cart, including a `redirect_url` for checkout.

No parameter schema in public metadata yet.

pepesto_predirectFree, no API key. Shopping list → deferred deep link (`redirect_url`); the end user pays when they check out in the Pepesto app.

Free, no API key. Shopping list → deferred deep link (`redirect_url`); the end user pays when they check out in the Pepesto app.

No parameter schema in public metadata yet.

pepesto_parseParse a URL/text/image recipe into structured ingredients + `KgToken`.

Parse a URL/text/image recipe into structured ingredients + `KgToken`.

No parameter schema in public metadata yet.

pepesto_suggestSearch Pepesto's 1M+ recipe graph.

Search Pepesto's 1M+ recipe graph.

No parameter schema in public metadata yet.

pepesto_productsMap `KgToken`s + supermarket to concrete products with prices.

Map `KgToken`s + supermarket to concrete products with prices.

No parameter schema in public metadata yet.

pepesto_catalogFull SKU dump for a supermarket. Only when explicitly requested; cache results.

Full SKU dump for a supermarket. Only when explicitly requested; cache results.

No parameter schema in public metadata yet.

pepesto_creditsCheck remaining credits. Free.

Check remaining credits. Free.

No parameter schema in public metadata yet.

Sponsors

Configuration

PEPESTO_API_KEY*secret

Pepesto API key. See the project README section "Getting an API key" for how to obtain one.

Readme

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

Getting an API key

Most tools need a key, but pepesto_predirect is public and free — it works with no key at all (the end user pays when they check out in the app).


View the full README on GitHub

Details

Repository
github.com/pepesto-solutions/pepesto-mcp
Package
@pepesto/pepesto-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active