Traga o Farina Prima para o seu agenteBETA

Endpoint

Um único endpoint HTTP público e sem chave atende a todos os clientes MCP:

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

JSON-RPC 2.0 sem estado (stateless) sobre HTTP com streaming SSE. Nenhuma autenticação ou chave de API é necessária.

Ferramentas

6 ferramentas estão disponíveis. Todas são de leitura, exceto plan_bake, que realiza um cálculo (nenhum dado é gravado).

Conectar ao Claude Desktop (stdio)

Adicione o Pandough ao seu arquivo `claude_desktop_config.json` usando a ponte mcp-remote (ela faz o proxy do endpoint HTTP para o transporte stdio do Claude Desktop):

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

Reinicie o Claude Desktop. As ferramentas do Pandough aparecerão no menu de ferramentas.

Conectar ao ChatGPT e clientes HTTP

Aponte qualquer cliente MCP HTTP (conectores personalizados do ChatGPT, seu próprio ambiente de execução de agentes, etc.) para o endpoint e comunique-se via JSON-RPC 2.0. Liste as ferramentas disponíveis com:

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

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

Exemplo: plan_bake

Planeje quatro pizzas napolitanas com 65% de hidratação usando um blend de farinhas (70% Caputo Pizzeria + 30% Manitoba Oro), considerando as temperaturas reais da cozinha e da geladeira do padeiro, uma fermentação em bloco curta em temperatura ambiente, uma fermentação a frio sob refrigeração durante a noite e um link para a calculadora italiana:

Requisição

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

Exemplo de resposta

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

A quantidade de fermento, o cronograma e os avisos são calculados pelo mesmo motor que alimenta a calculadora do Pandough — e eles consideram as características da farinha: passar um `flourSlug` ou `flourBlend` ajusta a faixa de hidratação recomendada e exibe um aviso quando a hidratação desejada fica fora dela. As temperaturas do ambiente e da geladeira (`roomTempCelsius` / `fridgeTempCelsius`) são os principais fatores para a quantidade de fermento e o tempo, portanto, envie-as sempre que o usuário as souber. O link "Abrir no Pandough" preenche previamente todos os parâmetros — incluindo o blend via `blendInline` — para que o usuário possa continuar editando no aplicativo, mesmo sem estar logado.

Limites de requisições

O endpoint público aplica um limite de requisições por IP por melhor esforço:

• •30 requisições / minuto por IP
• •300 requisições / hora por IP

Exceder um limite retorna HTTP 429 com um cabeçalho Retry-After e um erro JSON-RPC (código -32029). Aguarde e tente novamente após o número de segundos indicado.