# pepesto-mcp

This MCP server turns recipes or shopping lists into priced supermarket baskets across Europe. It fits agents that need recipe parsing and product matching.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7
- Author: pepesto-solutions
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/pepesto-solutions/pepesto-mcp
- Updated: 2026-06-23
- HTML: https://affpapa.org/en/nevibecode/mcp/pepesto-mcp

## What it does

pepesto-mcp connects an agent to the Pepesto API. Its tools can read a recipe from a URL, text, or image, search the recipe graph, match ingredients to products at a chosen supermarket, and inspect catalog data. Separate calls handle parsing, suggestions, product lookup, and credit checks.

\`pepesto_oneshot` builds a matched basket up front, while `pepesto_predirect` creates a free handoff link for a shopping list. With the latter, matching happens when the recipient opens the link and the end user pays in the Pepesto app. The server runs through `npx` and uses `PEPESTO_API_KEY` for most tools. Checkout itself happens outside the MCP server.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `PEPESTO_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add pepesto-mcp -e PEPESTO_API_KEY=<PEPESTO_API_KEY> -- npx -y @pepesto/pepesto-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add pepesto-mcp --env PEPESTO_API_KEY=<PEPESTO_API_KEY> -- npx -y @pepesto/pepesto-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "pepesto-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@pepesto/pepesto-mcp"
            ],
            "env": {
                "PEPESTO_API_KEY": "<PEPESTO_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "pepesto-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@pepesto/pepesto-mcp"
            ],
            "env": {
                "PEPESTO_API_KEY": "<PEPESTO_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e PEPESTO_API_KEY=<PEPESTO_API_KEY> pepesto-mcp npx -y @pepesto/pepesto-mcp
```
Replace <…> with your own values

## When to use it
- turn a recipe URL into a supermarket basket
- match ingredients with store products and prices
- search the recipe graph for meal ideas
- hand a shopping list to the Pepesto app

## Example prompts
- Build a Tesco basket from this recipe URL and add olive oil.
- Find a vegan pasta recipe, then match its ingredients at `coop.ch`.
- Create a free Pepesto handoff link for my shopping list.

## Similar
- [pp-recipe-goat](https://affpapa.org/en/nevibecode/skills/pp-recipe-goat.md) — skill · 3300 installs
- [configuring-connections](https://affpapa.org/en/nevibecode/skills/configuring-connections.md) — skill · 2900 installs
- [building-tools](https://affpapa.org/en/nevibecode/skills/building-tools.md) — skill · 2900 installs
- [QVeris](https://affpapa.org/en/nevibecode/mcp/qveris.md) — MCP server · ★ 263
- [marketplace-catalog-sync](https://affpapa.org/en/nevibecode/skills/marketplace-catalog-sync.md) — skill · 1000 installs
- [letzai-api](https://affpapa.org/en/nevibecode/skills/letzai-api.md) — skill · 913 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md