Breng Farina Prima naar je agentBETA

Endpoint

Eén sleutelloos, openbaar Streamable HTTP-endpoint bedient elke MCP-client:

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

Stateless JSON-RPC 2.0 over HTTP met SSE-streaming. Geen authenticatie of API-sleutel vereist.

Tools

Er zijn 6 tools beschikbaar. Alle tools zijn alleen-lezen, behalve `plan_bake`, die een berekening uitvoert (er worden geen gegevens opgeslagen).

Claude Desktop koppelen (stdio)

Voeg Pandough toe aan je `claude_desktop_config.json` met behulp van de `mcp-remote`-bridge (deze stuurt het HTTP-endpoint door naar het stdio-transport van Claude Desktop):

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

Herstart Claude Desktop. De Pandough-tools verschijnen in het tools-menu.

ChatGPT & HTTP-clients koppelen

Verwijs elke HTTP MCP-client (zoals aangepaste ChatGPT-connectors of je eigen agent-runtime) naar het endpoint en communiceer via JSON-RPC 2.0. Vraag de beschikbare tools op met:

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

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

Voorbeeld: plan_bake

Plan vier Napolitaanse pizza's met een hydratatie van 65% op basis van een bloemmengsel (70% Caputo Pizzeria + 30% Manitoba Oro), rekening houdend met de werkelijke keuken- en koelkasttemperatuur van de bakker, een korte warme bulkrijs, een koude rijs van een nacht in de koelkast, en een Italiaanse calculatorlink:

Verzoek

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

Voorbeeld van respons

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

De hoeveelheid gist, het schema en de waarschuwingen worden berekend door dezelfde engine die de Pandough-calculator aandrijft — en ze houden rekening met de gebruikte bloem: door een `flourSlug` of `flourBlend` mee te geven, wordt de aanbevolen hydratatiemarge aangepast en verschijnt er een waarschuwing als je doelhydratatie daarbuiten valt. De kamer- en koelkasttemperatuur (`roomTempCelsius` / `fridgeTempCelsius`) zijn de belangrijkste factoren voor de hoeveelheid gist en de timing, dus geef deze altijd mee als de gebruiker ze weet. De link 'Openen in Pandough' vult alle parameters vooraf in — inclusief de blend via `blendInline` — zodat de gebruiker kan blijven bewerken in de app, zelfs zonder ingelogd te zijn.

Limieten (rate limits)

Het openbare endpoint hanteert een best-effort limiet per IP-adres:

• •30 verzoeken / minuut per IP
• •300 verzoeken / uur per IP

Bij het overschrijden van een limiet wordt HTTP 429 geretourneerd met een `Retry-After`-header en een JSON-RPC-fout (code -32029). Wacht even en probeer het opnieuw na het aangegeven aantal seconden.