Pandough

Pandough Agent API

Ge din agent tillgång till Farina PrimaBETA

Pandough tillhandahåller sin bakmotor som en MCP-server — byggd på Farina Prima, mjöl-först-metoden: definiera ditt mjöl först och härled sedan receptet utifrån det (motsatsen till recept-fokuserade kalkylatorer som behandlar mjölet som en eftertanke). Anslut Claude, ChatGPT eller valfri Model Context Protocol-klient för att söka efter mjöl och ugnar, planera ett bak med exakta gramangivelser och felsöka degproblem.

Slutpunkt

En enda publik HTTP-slutpunkt utan krav på nyckel betjänar alla MCP-klienter:

MCP-slutpunkt
https://pandough.app/api/mcp
POST https://pandough.app/api/mcp

Tillståndslös JSON-RPC 2.0 över HTTP med SSE-strömning. Ingen autentisering eller API-nyckel krävs.

Verktyg

6 verktyg finns tillgängliga. Alla är skrivskyddade utom plan_bake, som utför en beräkning (ingen data sparas).

search_flours

Search the Pandough flour database. Returns flour names, protein %, W strength, hydration ranges, and types. Use this to help users find the right flour for their bake.

IndataTypObligatoriskBeskrivning
querystringnejSearch term (name, brand, or type). Max 200 chars.
tagstringnejFilter by tag (e.g. 'pizza', 'bread', 'pastry'). Max 50 chars.

Returnerar: Up to 10 matching flours, each with name, brand, slug, protein %, W strength, type, and hydration range.

get_flour_details

Get detailed information about a specific flour by its slug. Returns full profile including protein, W strength, hydration curve, maturation profiles, and description.

IndataTypObligatoriskBeskrivning
slugstringjaFlour slug from search_flours (e.g. 'caputo-pizzeria', 'manitoba-oro'). 1–120 chars.

Returnerar: A single flour profile: name, brand, type, protein %, W strength, hydration range, tags, and description.

list_recipes

List the dough recipe styles plan_bake supports. Call this when a user names a style (Neapolitan, classica, focaccia, bread, baguette) so you pass the correct recipeSlug instead of guessing — and so you never confuse a style word like 'classica' with a flour whose name contains it.

Returnerar: Every supported recipe style: slug, name, dough type, default hydration range, and a typical bulk → cold → final-proof schedule.

plan_bake

Create a bake plan with ingredient calculations. Returns exact ingredient amounts in grams, an auto-sized yeast amount, a fermentation schedule, dough warnings, and a calculator URL the user can open in Pandough with all parameters prefilled. Before calling this, gather the inputs that actually determine a good plan (skip any the user already volunteered): (1) Which flour(s) do they have? — call search_flours to resolve a flourSlug (or pass flourBlend for a 2–5 flour cut, e.g. a Pulcinella base with 30% Manitoba); this is what makes hydration and warnings flour-aware. (2) Their room temperature and fridge temperature — pass roomTempCelsius/fridgeTempCelsius; temperature is the dominant driver of yeast amount and timing. (3) How they mix/knead (by hand, stand mixer, no-knead) — plan_bake does not return technique guidance, so pair it with a troubleshoot call for method advice. Don't interrogate a user who already gave a full brief.

IndataTypObligatoriskBeskrivning
recipeSlugstringjaRecipe type slug. Supported: neapolitan-pizza, classica-pizza, focaccia, artisan-bread, baguette (call list_recipes for the canonical list). Pass the user's style here — don't substitute a flour whose name contains the style word. 1–120 chars.
flourSlugstringnejFlour slug from search_flours (e.g. 'caputo-pizzeria'). Tailors hydration + warnings to the flour. Mutually exclusive with flourBlend. Max 120 chars.
flourBlendarray of { flourSlug, percent }nejA weighted blend of 2–5 flours summing to 100%, e.g. [{flourSlug:'caputo-pizzeria',percent:70},{flourSlug:'manitoba-oro',percent:30}]. Properties are weight-averaged into a virtual flour. Mutually exclusive with flourSlug.
hydrationPercentnumbernejTarget hydration percentage (40–110).
servingsnumber (integer)nejNumber of portions/pizzas (1–50, default depends on recipe).
roomTempHoursnumbernejRoom-temperature fermentation hours (0–168).
fridgeTempHoursnumbernejCold fermentation hours (0–168).
roomTempCelsiusnumbernejThe user's real kitchen temperature in °C (2–40). The single biggest driver of yeast amount and timing — ask the user for it.
fridgeTempCelsiusnumbernejThe user's real fridge temperature in °C (0–12). Ask the user when a cold ferment is involved.
bakeTimestring (ISO 8601)nejTarget bake time as an ISO 8601 datetime (e.g. '2026-06-10T18:00:00Z'). Must be in the future.
localestringnejUI locale for the returned calculator link (e.g. 'en', 'pl', 'it'). Defaults to 'en'.

Returnerar: Total dough weight, auto-sized yeast (grams + baker's %), per-ingredient amounts (grams + %), a warm/cold/final-proof schedule, dough warnings, and an 'Open in Pandough' calculator link with every parameter prefilled.

troubleshoot

Search the Pandough baking knowledge base for troubleshooting advice, technique guides, and flour science. Returns curated expert content about common baking issues.

IndataTypObligatoriskBeskrivning
issuestringjaThe baking issue or question (e.g. 'sticky dough', 'no oven spring', 'cold proof technique'). 1–300 chars.

Returnerar: Up to 3 curated knowledge-base articles, each with a title, category, and full body content.

search_ovens

Search the Pandough oven database. Returns oven specs (max temperature, type, fuel) plus recommended bake settings — top/deck heat, bake time, and deck material — computed for a Neapolitan pizza by the same heat engine the site uses.

IndataTypObligatoriskBeskrivning
querystringnejSearch term (oven name, brand). Max 200 chars.
typestringnejOven type filter (e.g. 'pizza-oven', 'home-oven', 'outdoor'). Max 50 chars.

Returnerar: Up to 10 matching ovens, each with name, brand, slug, type, max temperature, fuel type, and tags.

Anslut Claude Desktop (stdio)

Lägg till Pandough i din claude_desktop_config.json med hjälp av mcp-remote-bryggan (den vidarebefordrar HTTP-slutpunkten till Claude Desktops stdio-transport):

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

Starta om Claude Desktop. Pandough-verktygen kommer att visas i verktygsmenyn.

Anslut ChatGPT & HTTP-klienter

Peka valfri HTTP-baserad MCP-klient (anpassade ChatGPT-anslutningar, din egen agentmiljö etc.) mot slutpunkten och kommunicera via JSON-RPC 2.0. Lista de tillgängliga verktygen med:

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

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

Exempel: plan_bake

Planera fyra napolitanska pizzor med 65 % hydrering baserat på en mjölblandning (70 % Caputo Pizzeria + 30 % Manitoba Oro), med bagarens faktiska köks- och kylskåpstemperaturer, en kort varm bulkjäsning, en kalljäsning över natten och en länk till en italiensk kalkylator:

Anrop

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

Exempelsvar

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

Jästmängden, schemat och varningarna beräknas av samma motor som driver Pandough-kalkylatorn — och de är mjölmedvetna: genom att skicka med en flourSlug eller flourBlend anpassas det rekommenderade hydreringsintervallet, och en varning visas om din målydrering hamnar utanför detta. Rums- och kylskåpstemperaturer (roomTempCelsius / fridgeTempCelsius) är de helt avgörande faktorerna för jästmängd och tidsåtgång, så skicka med dem så snart användaren känner till dem. Länken Öppna i Pandough fyller i alla parametrar i förväg — inklusive blandningen via blendInline — så att användaren kan fortsätta redigera i appen, även utan att vara inloggad.

Anropsbegränsningar

Den publika slutpunkten tillämpar en IP-baserad begränsning efter bästa förmåga:

  • 30 anrop / minut per IP
  • 300 anrop / timme per IP

Om en gräns överskrids returneras HTTP 429 med ett Retry-After-huvud och ett JSON-RPC-fel (kod -32029). Avvakta och försök igen efter det angivna antalet sekunder.

Pandough

Pandough.app — pizzadegskalkylatorn som bygger på metoden Farina Prima: receptet utgår från mjölet.

Pandough fungerar bättre på en dator
Pandough fungerar bättre på en datorMer utrymme för schema, grafer och mjöldetaljer. Skicka länken till dig själv och öppna den på en större skärm.
© 2026 Pandough.app·VillkorIntegritet·r/PandoughApp