Servidor MCP de Pepesto

Servidor MCP para la API de Pepesto: dota a tu agente de la capacidad de convertir cualquier receta (una URL, texto plano o una foto) en una cesta de productos reales de supermercado con precios en tiempo real, en 26 supermercados europeos. El MCP cubre la mitad del flujo de trabajo correspondiente a receta → cesta coincidente (analizar / buscar / asignar ingredientes a SKU / consultar catálogos); realizar el pedido real es un paso independiente; consulta Dónde se realiza el pago realmente.

Instalación rápida

Claude Desktop

Añádelo 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

Obtención de una clave API

1. Empieza con un paquete de crédito de pago por uso; consulta https://www.pepesto.com/pricing/.

2. Genera una clave API llamando a /link con el correo electrónico que utilizaste al finalizar la compra. La clave se devuelve solo una vez; guárdala inmediatamente.

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

3. Configura la clave en tu entorno:

   export PEPESTO_API_KEY=pep_sk_…

Herramientas

El MCP se detiene en "cesta coincidente con precios"; consulta Dónde se realiza el pago realmente para saber cómo los usuarios finalizan el pedido. /session, /checkout y /link no están envueltos intencionadamente; consulta Hoja de ruta para conocer lo que está planeado.

Ejemplos de conversaciones

Rápido: URL de receta → cesta coincidente

El camino más rápido. Una llamada a la herramienta devuelve una cesta coincidente y un enlace de pago.

Usuario: Usa la receta de pizza margherita de BBC Good Food para crear una cesta de Tesco, y añade también agua con gas y aceite de oliva.

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

Asistente: Cesta coincidente en Tesco. Enlace de pago: <redirect_url>.

Navegar por el grafo de recetas → elegir → cesta coincidente

Para prompts del tipo "encuéntrame algo para cocinar", donde el agente busca primero en el grafo de recetas de Pepesto y devuelve productos coincidentes con precios.

Usuario: Encuéntrame una receta de pasta vegana para dos.

Asistente: [Usa pepesto_suggest con query: "vegan pasta dinner for two"]

Asistente: Tres opciones: Penne cremosos de anacardos, Espaguetis de limón y ajo, Rigatoni de verduras asadas. ¿Cuál te gustaría?

Usuario: Quédate con la primera. Cómprala en Coop (coop.ch).

Asistente: [Usa pepesto_products con el kg_token de la receta elegida y supermarket_domain: "coop.ch"]

Asistente: 8 ingredientes coincidentes en Coop: anacardos CHF 4.20, penne CHF 1.95, ... — total CHF 18.40.

Analizar una receta específica → cesta coincidente

Cuando el usuario ya tiene en mente una URL o texto de receta. El MCP devuelve la lista de productos coincidentes; qué hacer con ella depende de ti.

Usuario: Analiza esto y desglosa los ingredientes: https://www.bbcgoodfood.com/recipes/pizza-margherita-4-easy-steps

Asistente: [Usa pepesto_parse con recipe_url]

Asistente: Pizza Margherita en 4 sencillos pasos — 8 ingredientes: harina de fuerza, levadura de acción rápida, ...

Usuario: Ahora asígnalos a productos de Sainsbury's.

Asistente: [Usa pepesto_products con el kg_token devuelto y supermarket_domain: "sainsburys.co.uk"]

Asistente: 8 ingredientes coincidentes en Sainsbury's — total £6.40.

Plan de comidas semanal → una cesta coincidente fusionada

Varios kg_tokens a través de pepesto_products en una sola llamada: Pepesto fusiona los ingredientes duplicados entre recetas.

Usuario: Planifica 5 cenas keto para la semana y asígnalas en Delhaize.

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

Asistente: Cinco cenas: Filete y col rizada, Bol de salmón y aguacate, Lasaña de calabacín, Risotto de coliflor, César de pollo.

Usuario: Crea una lista de la compra que cubra toda la semana.

Asistente: [Usa pepesto_products con los cinco kg_tokens y supermarket_domain: "delhaize.be"]

Asistente: Coincidencia combinada: 24 ingredientes únicos (algunos compartidos entre recetas), total estimado €68.40 en Delhaize.

Comparar precios entre dos supermercados

Ejecuta la misma receta a través de pepesto_products para cada mercado y compara los totales.

Usuario: Analiza esta receta de almuerzo de domingo.

Asistente: [Usa pepesto_parse]

Asistente: Entendido: Almuerzo italiano de domingo, 12 ingredientes.

Usuario: Muéstrame la cesta tanto en Esselunga como en Conad para poder comparar.

Asistente: [Usa pepesto_products dos veces: supermarket_domain: "spesaonline.esselunga.it", luego supermarket_domain: "spesaonline.conad.it"]

Asistente: Esselunga: €34.20. Conad: €31.50. Conad es €2.70 más barato, principalmente en pasta y tomates.

Volcado de catálogo para análisis de mercado

Solo bajo petición explícita, y almacena en caché de forma agresiva; consulta Precios y mejores prácticas a continuación.

Usuario: Estoy creando un panel de comparación de precios. Extrae el catálogo completo de Plus NL.

Asistente: Ten en cuenta que pepesto_catalog es la llamada más cara aquí. Solo la ejecutaré una vez; deberías almacenar el resultado en caché durante al menos un día. ¿Confirmas?

Usuario: Sí.

Asistente: [Usa pepesto_catalog con supermarket_domain: "plus.nl"]

Asistente: Catálogo volcado: 1.847 SKU en 23 categorías.

Supermercados compatibles

¿Necesitas un supermercado que no esté en esta lista? Contacta con Pepesto.

Dónde se realiza el pago realmente

Este MCP se detiene en "cesta coincidente con precios". No automatiza la realización del pedido en el sitio web del supermercado. Dos formas de terminar el viaje:

• Aplicación Pepesto (recomendado). Abre la redirect_url devuelta por pepesto_oneshot en un navegador, o entrega al usuario la lista de productos coincidentes de pepesto_products y dile que la recree en la aplicación Pepesto: ahí es donde reside el flujo de pago alojado, incluyendo inicio de sesión, revisión de cesta y (para algunos mercados) pago.

• El propio sitio del supermercado. El usuario puede tomar la lista de productos coincidentes de pepesto_products y añadir los SKU directamente en tesco.com / coop.ch / etc. Más lento, pero no se necesita una cuenta de Pepesto.

Precios y mejores prácticas

Pepesto funciona con créditos simples de pago por uso: solo pagas por lo que tus agentes realmente usan, y los créditos nunca caducan, por lo que una recarga es tuya hasta que la gastes. También ofrecemos descuentos para estudiantes y equipos en fase inicial, así que salúdanos si ese es tu caso. Los precios completos por llamada y los niveles de volumen se encuentran en https://www.pepesto.com/pricing/.

Algunos consejos para aprovechar al máximo cada crédito:

• pepesto_credits es gratuito: llámalo en cualquier momento para una lectura rápida del saldo.

• pepesto_oneshot, pepesto_parse, pepesto_suggest y pepesto_products son las llamadas cotidianas (coincidir una receta, planificar una semana, comparar cestas) y tienen un precio para el uso rutinario del agente.

• pepesto_catalog realiza un volcado completo de SKU para un supermercado y es la llamada más pesada. Es la herramienta adecuada para análisis de mercado genuinos o paneles de comparación de precios; simplemente almacena el resultado en caché durante al menos un día por supermercado. ¿No estás seguro de si lo necesitas? Cuéntanos tu caso de uso y normalmente te indicaremos un camino más barato.

Hoja de ruta

Planificado a continuación:

• pepesto_session: envuelve /session para que un agente pueda crear una sesión de pago del lado de Pepesto a partir de los SKU seleccionados.

• pepesto_checkout: envuelve /checkout, el bucle de automatización del navegador paso a paso que controla el propio sitio del supermercado (inicio de sesión, añadir a la cesta, solicitar CAPTCHA, etc.). Esta es la pieza que falta para una compra totalmente autónoma.

• Entrega de pago alojado: muestra el enlace profundo de la aplicación Pepesto como un resultado de herramienta estructurado (en lugar de texto libre), para que los clientes de MCP puedan renderizarlo como un botón en lugar de una URL.

Si alguno de estos te desbloquearía, cuéntanoslo: los moverá hacia arriba en la cola.

Desarrollo

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

Ejecuta el inspector contra la compilación local:

PEPESTO_API_KEY=pep_sk_… npm run inspector

Licencia

El servidor MCP de Pepesto en este repositorio está bajo la Licencia MIT.