Agents guide
Explore Barbaro pizzas, ingredients and flours with an assistant, or calculate your next dough batch.
Public facts and calculations, no sign-in required.
Try the dough calculatorThe search opens a JSON response. Follow each pizza's url back to Barbaro, and keep its source and attribution when sharing what you find.
GET /api/v1/pizzas?q=mushroom&limit=3
OpenAPI reference
These examples use the API on the site you are visiting. Read what is sent to an assistant.
Connect to the public catalog
For an MCP client, use this site's /mcp endpoint with Streamable HTTP and no sign-in. It provides eleven read-only tools for pizza search and detail, menu sections, ingredient search and detail, flour search and detail, dough calculation, ingredient balance, bake timing and shopping lists.
calculate_dough returns gram quantities and warnings. Supporting MCP Apps hosts can also show the calculator panel. Other clients receive complete text and structured results with a link to the normal calculator page. calculate_balance returns contribution scores, not nutrition or ingredient weights.
The endpoint supports protocol 2025-11-25 with JSON responses. It does not offer event streams, sessions, tasks, private Library access or write tools. Request cancellation across separate server instances is unavailable. Reads have bounded deadlines.
A separate Muse custom connector provides key-protected public catalog reads. It does not provide the calculator or planning tools. There is no public key signup; use the anonymous API or MCP endpoint for open access.
Each adapter has a platform limit of 60 requests per IP address and domain per 60 seconds. This is not a per-key quota or spending cap. Reduce requests when refused. Barbaro makes no model calls for these reads.
Plan bake timing and a shopping list
plan_bake works backward from the first pizza entering the oven. Supply your time zone, when you can start, and your own stages with minimum and maximum durations. It checks whether those stages fit. It does not predict fermentation readiness.
The time windows depend on one another. You cannot mix arbitrary endpoints or choose every longest duration independently. Selected stage durations must fit together within the available time.
shopping_list combines your already-sized dough batches, keeping ready starter separate from fresh flour and water. Batch warnings and actual preferment flour allocations remain visible. Optional pizza counts identify topping needs; they do not multiply dough batches or establish how many pizzas the dough covers. Topping weights remain unknown because the public catalog does not provide them.
Use the OpenAPI reference for the input schemas and limits. Bake planning and shopping lists passed production checks in Claude and ChatGPT on September 22, 2026.
Read a build in a supporting browser
read_current_build
Open a scratch build and choose your ingredients. In a browser that supports page tools, ask your assistant to call read_current_build with no arguments.
The experimental tool reads an eligible scratch build or published house pizza, including your current edits. It cannot edit or save. Private Library, lineup and share contexts are excluded.
If your browser does not support the tool, you can still use Build normally.
What we have tested
- Claude and ChatGPT
- Production checks passed for all eleven public tools, including bake planning and shopping lists. The in-chat dough calculator rendered and recalculated, and its Continue in Dough link preserved the formula after reload. Invalid inputs and unavailable items returned errors with recovery paths.
- Codex desktop in-app browser
- Tool discovery and invocation worked for the read-only Build experiment. The exact app version was unavailable.
- Muse
- The separate installed production catalog connector passed pizza search and detail reads, plus the expected invalid-input error, on September 22. That connection remains active. Earlier preview testing also passed key revocation; its retired key is separate. Remote MCP and calculator panels in Muse have not been verified.
- Private Dough in Claude
- On September 22, the installed production connection completed authorization with no existing recipes selected. Claude created one test recipe and appended one version after separate reviews in Barbaro. Both saved results reopened correctly in the normal Dough page after reload, and the original version remained unchanged. The seven-day connection remains active. Separate production service checks also passed permission enforcement and revocation.
- Official JavaScript MCP SDK 1.30.0
- September 21 testing of the initial catalog package negotiated protocol 2025-11-25 and found its seven catalog tools. A mushroom search returned Forest Floor and Golden Oldie, followed by a pizza detail read. Ingredient and flour search and detail, menu reading, and rejection of an invalid limit also passed.
- Official Python MCP SDK 1.30.0
- The same September 21 hosted catalog task passed with protocol 2025-11-25 and the initial seven catalog tools. For both clients, text and structured results agreed, and returned items matched the public REST API.
Watch the 43-second ChatGPT demo of the actual public tools and calculator.
Barbaro 1.0.0 was approved and published in OpenAI's directory on September 24. Install Barbaro in ChatGPT for the public catalog and calculation tools. Claude and Muse directory submissions still await provider decisions.
Current limits
The public tools and Muse catalog connector have no private Library access or write permission. The separate production Dough connection at https://barbaropizza.com/mcp/dough requires sign-in and recipe permissions. Its verified Claude setup uses OAuth client ID barbaro-claude-dough with no client secret. Private Dough connections in other assistants have not been verified.
You choose which existing recipes to share and which actions to allow. New recipes and versions saved through this connection with your approval join it under the permissions you chose. Each save requires a separate review in Barbaro. Access lasts up to seven days and ends when you remove the connection in Account or sign out of the Barbaro session that granted it.
Bake plans check the timing you supply; neither a timing plan nor calculator quantities predict fermentation readiness. Calculator panels are tested in Claude and ChatGPT; other hosts can use the text result or normal calculator page.
Build journal
The initial development package covered public pizza, ingredient and flour facts and the read-only Build browser experiment. The September 21 continuation adds dough and balance calculations using the same shared arithmetic as the normal pages, plus explicit bake timing and shopping lists from caller-provided batches.