Pepesto MCP

Servidor Pepesto MCP

Servidor MCP para a API Pepesto — dê ao seu agente a capacidade de transformar qualquer receita (uma URL, texto simples ou foto) em uma cesta de produtos reais de supermercado com preços ao vivo, em 26 supermercados europeus. O MCP cobre a metade receita → carrinho correspondente do fluxo de trabalho (parsear / buscar / mapear ingredientes para SKUs / verificar catálogos); fazer o pedido em si é uma etapa separada — veja Onde o checkout realmente acontece.

Instalação rápida

Claude Desktop

Adicione a 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

Obtendo uma chave de API

A maioria das ferramentas precisa de uma chave, mas pepesto_predirect é pública e gratuita — funciona sem nenhuma chave (o usuário final paga quando faz o checkout no aplicativo).

1. Comece com um pacote de créditos pré-pagos — veja https://www.pepesto.com/pricing/.

2. Gere uma chave de API chamando /link com o e-mail usado no checkout. A chave é retornada apenas uma vez — guarde-a imediatamente.

   curl -X POST https://s.pepesto.com/api/link \
     -H "Content-Type: application/json" \
     -d '{"email":"you@example.com"}'
   

3. Defina a chave no seu ambiente:

   export PEPESTO_API_KEY=pep_sk_…
   

Ferramentas

Ferramenta	Endpoint	Descrição
pepesto_oneshot	POST /oneshot	Receita única → carrinho correspondente, incluindo um redirect_url para checkout.
pepesto_predirect	POST /predirect	Gratuito, sem chave de API. Lista de compras → deep link adiado (redirect_url); o usuário final paga quando faz o checkout no aplicativo Pepesto.
pepesto_parse	POST /parse	Parseia uma receita de URL/texto/imagem em ingredientes estruturados + KgToken.
pepesto_suggest	POST /suggest	Busca no grafo de receitas de 1M+ do Pepesto.
pepesto_products	POST /products	Mapeia KgTokens + supermercado para produtos concretos com preços.
pepesto_catalog	POST /catalog	Dump completo de SKUs para um supermercado. Somente quando solicitado explicitamente; armazene os resultados em cache.
pepesto_credits	POST /credits	Verifica créditos restantes. Gratuito.

O MCP para em "carrinho correspondente com preços" — veja Onde o checkout realmente acontece para saber como os usuários concluem o pedido. /session, /checkout e /link não são intencionalmente envolvidos; veja Roadmap para o que está planejado.

Exemplos de conversas

Rápido: URL de receita → carrinho correspondente

O caminho mais rápido. Uma única chamada de ferramenta retorna um carrinho correspondente e um link de checkout.

Usuário: Use a receita de pizza margherita do BBC Good Food para montar um carrinho na Tesco e adicione também água com gás e azeite de oliva.

Assistente: [Usa pepesto_oneshot com content_urls, content_text, supermarket_domain: "tesco.com"]

Assistente: Carrinho correspondente na Tesco. Link de checkout: <redirect_url>.

Transferência gratuita e adiada → o usuário final paga (pepesto_predirect)

Quando o cliente da API não quer pagar pela correspondência e um deep link adiado é aceitável. pepesto_predirect é gratuito e não precisa de chave de API: retorna instantaneamente com um link, e o parseamento + a correspondência de produtos acontecem de forma preguiçosa quando o usuário o abre. O usuário é cobrado ao prosseguir para o checkout no aplicativo Pepesto (se o aplicativo não estiver instalado, ele é enviado primeiro à loja de aplicativos e a lista é preservada).

Para quem é isso: pepesto_predirect é uma ferramenta voltada ao usuário final / agente, não um endpoint de integração para desenvolvedores. É a opção certa quando uma pessoa está conversando com um assistente (Claude Desktop, ChatGPT, etc.) e quer enviar sua lista de compras para o próprio celular — o agente retorna um link, o usuário conclui (e paga) no aplicativo. Se você é um desenvolvedor criando um produto sobre o Pepesto, normalmente vai preferir pepesto_oneshot (carrinho correspondente antecipado, você paga). Mesmo assim tem um caso de uso de desenvolvedor para predirect? Conte para nós — adoraríamos saber.

Use pepesto_predirect quando o custo deve recair sobre o usuário final; use pepesto_oneshot quando o cliente quer a cesta correspondente antecipadamente (com preços) e está disposto a pagar por isso.

Usuário: Aqui está minha lista de compras semanal — só me dê um link que eu possa abrir no meu celular para concluir no aplicativo Pepesto.

Assistente: [Usa pepesto_predirect com shopping_list: "2 avocados\n1 loaf of bread\n500 g tomatoes\n..."]

Assistente: Pronto — 🛒 Abra sua lista de compras no Pepesto → Grátis para abrir · 3 itens prontos · você só paga no checkout do aplicativo. Abra no seu celular (no computador, aparecerá um QR code para escanear).

A ferramenta retorna isso como Markdown pronto para exibição — um link tocável e rotulado mais uma legenda curta — para que o longo redirect_url nunca seja despejado como texto bruto.

Navegue pelo grafo de receitas → escolha → carrinho correspondente

Para solicitações do tipo "encontre algo para cozinhar", em que o agente busca primeiro no grafo de receitas do Pepesto e retorna produtos correspondentes com preços.

Usuário: Encontre uma receita vegana de massa para dois.

Assistente: [Usa pepesto_suggest com query: "vegan pasta dinner for two"]

Assistente: Três opções: Creamy Cashew Penne, Lemon Garlic Spaghetti, Roasted Veg Rigatoni. Qual você prefere?

Usuário: Vá com a primeira. Compre na Coop (coop.ch).

Assistente: [Usa pepesto_products com o kg_token e o supermarket_domain: "coop.ch" da receita escolhida]

Assistente: Correspondência de 8 ingredientes na Coop — castanhas de caju CHF 4.20, penne CHF 1.95, ... — total CHF 18.40.

Parseie uma receita específica → carrinho correspondente

Quando o usuário já tem uma URL ou texto de receita em mente. O MCP retorna a lista de produtos correspondentes — o que fazer com ela fica por sua conta.

Usuário: Parseie isto e separe os ingredientes: https://www.bbcgoodfood.com/recipes/pizza-margherita-4-easy-steps

Assistente: [Usa pepesto_parse com recipe_url]

Assistente: Pizza Margherita em 4 passos fáceis — 8 ingredientes: farinha de trigo forte, fermento de ação rápida, ...

Usuário: Agora corresponda-os aos produtos da Sainsbury's.

Assistente: [Usa pepesto_products com o kg_token e o supermarket_domain: "sainsburys.co.uk" retornados]

Assistente: Correspondência de 8 ingredientes na Sainsbury's — total £6.40.

Plano de refeições semanal → um carrinho correspondente mesclado

Múltiplos kg_tokens por meio de pepesto_products em uma única chamada — o Pepesto mescla ingredientes duplicados entre receitas.

Usuário: Planeje 5 jantares keto para a semana e faça a correspondência na Delhaize.

Assistente: [Usa pepesto_suggest com query: "keto dinner low carb high protein", num_to_fetch: 5]

Assistente: Cinco jantares: Steak & Kale, Salmon Avocado Bowl, Zucchini Lasagna, Cauliflower Risotto, Chicken Caesar.

Usuário: Monte uma lista de compras que cubra a semana inteira.

Assistente: [Usa pepesto_products com todos os cinco kg_tokens e supermarket_domain: "delhaize.be"]

Assistente: Correspondência combinada: 24 ingredientes únicos (alguns compartilhados entre receitas), total estimado de €68.40 na Delhaize.

Compare preços entre dois supermercados

Execute a mesma receita por meio de pepesto_products para cada mercado e compare os totais.

Usuário: Parseie esta receita de almoço de domingo.

Assistente: [Usa pepesto_parse]

Assistente: Entendido: Italian Sunday Lunch, 12 ingredientes.

Usuário: Mostre-me o carrinho na Esselunga e na Conad para eu comparar.

Assistente: [Usa pepesto_products duas vezes — supermarket_domain: "spesaonline.esselunga.it", depois supermarket_domain: "spesaonline.conad.it"]

Assistente: Esselunga: €34.20. Conad: €31.50. A Conad é €2.70 mais barata, principalmente em massa e tomates.

Dump de catálogo para análise de mercado

Somente mediante solicitação explícita, e armazene em cache agressivamente — veja Preços e melhores práticas abaixo.

Usuário: Estou criando um painel de comparação de preços. Puxe o catálogo completo da Plus NL.

Assistente: Atenção — pepesto_catalog é a chamada mais cara aqui. Vou executá-la apenas uma vez; você deve armazenar o resultado em cache por pelo menos um dia. Confirma?

Usuário: Sim.

Assistente: [Usa pepesto_catalog com supermarket_domain: "plus.nl"]

Assistente: Catálogo exportado: 1,847 SKUs em 23 categorias.

Supermercados suportados

#	País	Supermercado	Domínio / 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

Precisa de um supermercado que não está nesta lista? Contate o Pepesto.

Onde o checkout realmente acontece

Este MCP para em "carrinho correspondente com preços". Ele não automatiza a realização do pedido no site do supermercado. Duas maneiras de concluir a jornada:

• Aplicativo Pepesto (recomendado). Abra o redirect_url retornado por pepesto_oneshot em um navegador, ou entregue ao usuário a lista de produtos correspondentes de pepesto_products e diga para recriá-la no aplicativo Pepesto — é lá que o fluxo de checkout hospedado acontece, incluindo login, revisão da cesta e (para alguns mercados) pagamento.
• O próprio site do supermercado. O usuário pode pegar a lista de produtos correspondentes de pepesto_products e adicionar os SKUs diretamente em tesco.com / coop.ch / etc. Mais lento, mas não precisa de conta no Pepesto.

Preços e melhores práticas

O Pepesto funciona com créditos pré-pagos simples — você paga apenas pelo que seus agentes realmente usam, e os créditos nunca expiram, então uma recarga é sua até você gastá-la. Também oferecemos descontos para estudantes e equipes em estágio inicial, então diga oi se isso parece com você. Preços completos por chamada e faixas de volume estão em https://www.pepesto.com/pricing/.

Algumas dicas para aproveitar ao máximo cada crédito:

• pepesto_credits é gratuito — chame-o a qualquer momento para uma leitura rápida do saldo.
• pepesto_predirect é gratuito e não precisa de chave de API — ele adia a correspondência e cobra do usuário final no checkout, então não custa nada ao cliente da API.
• pepesto_oneshot, pepesto_parse, pepesto_suggest e pepesto_products são as chamadas do dia a dia (corresponder uma receita, planejar uma semana, comparar cestas) e têm preços para uso rotineiro de agentes.
• pepesto_catalog faz um dump completo de SKUs para um supermercado e é a chamada mais pesada. É a ferramenta certa para análise de mercado genuína ou painéis de comparação de preços — apenas armazene o resultado em cache por pelo menos um dia por supermercado. Não tem certeza se precisa? Conte-nos sobre seu caso de uso e geralmente apontaremos um caminho mais barato.

Roadmap

Planejado para vir a seguir:

• pepesto_session — envolver /session para que um agente possa criar uma sessão de checkout no lado do Pepesto a partir de SKUs selecionados.
• pepesto_checkout — envolver /checkout, o loop de automação de navegador passo a passo que conduz o próprio site do supermercado (login, adicionar à cesta, solicitar CAPTCHA, etc.). Esta é a peça que falta para compras totalmente autônomas.
• Transferência de checkout hospedado — apresentar o deep link do aplicativo Pepesto como um resultado estruturado de ferramenta (em vez de texto livre), para que clientes MCP possam renderizá-lo como um botão em vez de uma URL.

Se algum destes destravaria você, conte-nos — isso os moverá para o topo da fila.

Desenvolvimento

git clone https://github.com/pepesto-solutions/pepesto-mcp.git
cd pepesto-mcp
npm install
npm run build
npm test
npm run test:coverage

Execute o inspetor contra a compilação local:

PEPESTO_API_KEY=pep_sk_… npm run inspector

Licença

O servidor Pepesto MCP neste repositório é licenciado sob a Licença MIT.

Deploy

• Faça o deploy do Pepesto MCP no Glama.