Pepesto MCP server

Pepesto MCP Server

<!-- mcp-name: io.github.pepesto-solutions/pepesto-mcp -->

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 claudedesktopconfig.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 pepestopredirect is public and free** — it works with no key at all (the end user pays when they check out in the app).

1. Start with a pay-as-you-go credit pack — see .
2. Mint an API key by calling /link with 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"}'

1. Set the key in your environment:

export PEPESTO_API_KEY=pep_sk_…

Tools

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 pepestooneshot with contenturls, contenttext, supermarketdomain: "tesco.com"]

Assistant: Cart matched at Tesco. Checkout link: .

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. pepestopredirect 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).

Shortened. The full README is on GitHub.