Lleva Farina Prima a tu agenteBETA

Endpoint

Un único endpoint HTTP público y sin clave sirve a todos los clientes MCP:

POST https://pandough.app/api/mcp

JSON-RPC 2.0 sin estado sobre HTTP con transmisión SSE. No se requiere autenticación ni clave de API.

Herramientas

Hay 6 herramientas disponibles. Todas son de solo lectura excepto plan_bake, que realiza un cálculo (no se escriben datos).

Conectar Claude Desktop (stdio)

Añade Pandough a tu archivo `claude_desktop_config.json` usando el puente mcp-remote (este redirige el endpoint HTTP al transporte stdio de Claude Desktop):

{
  "mcpServers": {
    "pandough": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://pandough.app/api/mcp"]
    }
  }
}

Reinicia Claude Desktop. Las herramientas de Pandough aparecerán en el menú de herramientas.

Conectar ChatGPT y clientes HTTP

Apunta cualquier cliente MCP HTTP (conectores personalizados de ChatGPT, tu propio entorno de ejecución de agentes, etc.) al endpoint e interactúa mediante JSON-RPC 2.0. Enumera las herramientas disponibles con:

POST https://pandough.app/api/mcp
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list",
  "params": {}
}

Ejemplo: plan_bake

Planifica cuatro pizzas napolitanas al 65% de hidratación con una mezcla de harinas (70% Caputo Pizzeria + 30% Manitoba Oro), con las temperaturas reales de la cocina y la nevera del panadero, una fermentación en bloque corta a temperatura ambiente, una fermentación en frío en nevera durante la noche y un enlace de la calculadora italiana:

Petición

POST https://pandough.app/api/mcp
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "plan_bake",
    "arguments": {
      "recipeSlug": "neapolitan-pizza",
      "flourBlend": [
        { "flourSlug": "caputo-pizzeria", "percent": 70 },
        { "flourSlug": "manitoba-oro", "percent": 30 }
      ],
      "hydrationPercent": 65,
      "servings": 4,
      "roomTempCelsius": 22,
      "fridgeTempCelsius": 4,
      "roomTempHours": 4,
      "fridgeTempHours": 20,
      "locale": "it"
    }
  }
}

Ejemplo de respuesta

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "# Bake Plan\n\n**Total dough:** 1120g\n**Yeast:** 0.4g (0.06%) instant-dry\n\n## Ingredients\n  Pizzeria-ORO: 671g (100%)\n  Water: 436g (65%)\n  Salt: 19g (2.8%)\n  Yeast: 0.4g (0.06%)\n\n## Schedule\n  Warm bulk fermentation: 4h at 22°C\n  Cold fermentation (fridge): 20h at 4°C\n  Final proof: 2h at 22°C\n\n## Warnings\n  - 65% hydration is above Pizzeria-ORO's recommended range (57–64%) — expect a slack, hard-to-handle dough.\n\n## Open in Pandough\nOpen this calculator link to continue editing the bake:\nhttps://pandough.app/it/calculator?recipe=neapolitan-pizza&n=4&w=280&h=65&rt=4&ft=20&y=0.06&blendInline=caputo-pizzeria:70,manitoba-oro:30&source=mcp&aid=1a2b3c4d"
      }
    ]
  }
}

La cantidad de levadura, el programa y las advertencias se calculan con el mismo motor que impulsa la calculadora de Pandough, y tienen en cuenta la harina utilizada: al pasar un `flourSlug` o `flourBlend` se adapta el rango de hidratación recomendado y se muestra una advertencia si la hidratación objetivo queda fuera de este. Las temperaturas ambiente y de la nevera (`roomTempCelsius` / `fridgeTempCelsius`) son el factor determinante para la cantidad de levadura y los tiempos, así que pásalas siempre que el usuario las conozca. El enlace «Abrir en Pandough» precarga todos los parámetros —incluida la mezcla a través de `blendInline`— para que el usuario pueda seguir editando en la aplicación, incluso sin haber iniciado sesión.

Límites de tarifa

El endpoint público aplica un límite de tarifa por IP bajo el principio de mejor esfuerzo:

• •30 peticiones / minuto por IP
• •300 peticiones / hora por IP

Superar un límite devuelve un error HTTP 429 con una cabecera Retry-After y un error JSON-RPC (código -32029). Espera y vuelve a intentarlo tras el número de segundos indicado.