Porta Farina Prima sul tuo agenteBETA

Endpoint

Un unico endpoint HTTP pubblico e senza chiavi serve ogni client MCP:

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

JSON-RPC 2.0 stateless su HTTP con streaming SSE. Nessuna autenticazione o chiave API richiesta.

Strumenti

Sono disponibili 6 strumenti. Sono tutti in sola lettura tranne plan_bake, che esegue un calcolo (non viene scritto alcun dato).

Connetti Claude Desktop (stdio)

Aggiungi Pandough al tuo file `claude_desktop_config.json` usando il bridge mcp-remote (che fa da proxy dall'endpoint HTTP al trasporto stdio di Claude Desktop):

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

Riavvia Claude Desktop. Gli strumenti di Pandough appariranno nel menu degli strumenti.

Connetti ChatGPT e client HTTP

Punta qualsiasi client MCP HTTP (connettori personalizzati di ChatGPT, il runtime del tuo agente, ecc.) verso l'endpoint e comunica in JSON-RPC 2.0. Elenca gli strumenti disponibili con:

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

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

Esempio: plan_bake

Pianifica quattro pizze napoletane al 65% di idratazione con una miscela di farine (70% Caputo Pizzeria + 30% Manitoba Oro), inserendo le temperature reali della cucina e del frigorifero del panificatore, una breve puntata a temperatura ambiente, un appretto in frigo per tutta la notte e un link al calcolatore in italiano:

Richiesta

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"
    }
  }
}

Esempio di risposta

{
  "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 quantità di lievito, la tabella di marcia e gli avvisi sono calcolati dallo stesso motore che alimenta il calcolatore di Pandough — e tengono conto della farina: passando un `flourSlug` o un `flourBlend` si adatta l'intervallo di idratazione consigliato e viene mostrato un avviso se l'idratazione desiderata non rientra in tale intervallo. Le temperature dell'ambiente e del frigorifero (`roomTempCelsius` / `fridgeTempCelsius`) sono i fattori principali che determinano la quantità di lievito e le tempistiche, quindi passale ogni volta che l'utente le conosce. Il link Apri in Pandough precompila ogni parametro — inclusa la miscela tramite `blendInline` — in modo che l'utente possa continuare a modificare i dati nell'app, anche senza aver effettuato l'accesso.

Limiti di frequenza

L'endpoint pubblico applica un limite di frequenza per IP basato sul principio del "best-effort":

• •30 richieste / minuto per IP
• •300 richieste / ora per IP

Il superamento di un limite restituisce un errore HTTP 429 con un'intestazione Retry-After e un errore JSON-RPC (codice -32029). Attendi e riprova dopo il numero di secondi indicato.