{"openapi":"3.1.0","info":{"title":"Kiln API","version":"0.1.0","description":"A fully local pottery and ceramics reference toolkit: clay body profiles, a verified Orton cone temperature chart, glaze basics and food-safety awareness, firing schedule guidance, technique guides, a studio glossary, a shrinkage calculator, a defect troubleshooting guide, and studio safety basics.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://kiln.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/kiln/docs"},"termsOfService":"https://connectorbay.com/kiln/terms"},"servers":[{"url":"https://kiln.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/kiln/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/clay_body_guide":{"post":{"operationId":"clay_body_guide","summary":"Typical firing cone range, workability, common use, and typical total shrinkage percentage for a","description":"Typical firing cone range, workability, common use, and typical total shrinkage percentage for a\n    clay body (earthenware, stoneware, porcelain, raku clay covered). Use for \"what's stoneware good\n    for\", \"how workable is porcelain\", \"what temperature does earthenware fire to\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A clay body, e.g. earthenware, stoneware, porcelain, raku. Omit to list all.","title":"Name"}},"title":"clay_body_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/cone_temperature_converter":{"post":{"operationId":"cone_temperature_converter","summary":"Converts an Orton pyrometric cone number to its approximate Fahrenheit and Celsius equivalent at","description":"Converts an Orton pyrometric cone number to its approximate Fahrenheit and Celsius equivalent at\n    the standard medium heating rate (108F/hr, 60C/hr), straight from the Orton Ceramic Foundation's own\n    published cone chart. Use for \"what temperature is cone 6\", \"how hot is cone 04 in celsius\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"cone_number":{"description":"An Orton pyrometric cone number, e.g. 06, 04, 6, 8, 10. Low-fire cones need their leading zero (06, not 6 -- 6 and 06 are different cones).","examples":["06","6","10"],"title":"Cone Number","type":"string"}},"required":["cone_number"],"title":"cone_temperature_converterArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/glaze_basics_guide":{"post":{"operationId":"glaze_basics_guide","summary":"Explains glaze fundamentals: glaze vs. slip, general food-safety awareness for glazed foodware","description":"Explains glaze fundamentals: glaze vs. slip, general food-safety awareness for glazed foodware\n    (avoiding raw/unfired or unfritted heavy-metal glaze materials on food-contact surfaces), and 4 common\n    glaze types (clear, matte, celadon, shino). Use for \"what's the difference between glaze and slip\",\n    \"is my glaze food safe\", \"what's a celadon glaze\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"glaze_basics_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/firing_schedule_guide":{"post":{"operationId":"firing_schedule_guide","summary":"The typical bisque-fire and glaze-fire cone range and general approach for a given clay type. Use","description":"The typical bisque-fire and glaze-fire cone range and general approach for a given clay type. Use\n    for \"what cone do I bisque fire stoneware to\", \"how is raku fired differently from stoneware\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"clay_type":{"description":"A clay body, e.g. earthenware, stoneware, porcelain, raku.","title":"Clay Type","type":"string"}},"required":["clay_type"],"title":"firing_schedule_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/technique_guide":{"post":{"operationId":"technique_guide","summary":"A general description and beginner-friendliness note for a pottery forming technique (5 techniques","description":"A general description and beginner-friendliness note for a pottery forming technique (5 techniques\n    covered: wheel-throwing, hand-building, coil, slab, pinch). Use for \"should I hand-build or throw\n    first as a beginner\", \"what's coil building\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A forming technique, e.g. wheel-throwing, hand-building, coil, slab, pinch. Omit to list all.","title":"Name"}},"title":"technique_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/tool_glossary":{"post":{"operationId":"tool_glossary","summary":"Definitions of common pottery studio terms (bisque, greenware, leather-hard, wedging, kiln wash,","description":"Definitions of common pottery studio terms (bisque, greenware, leather-hard, wedging, kiln wash,\n    cone pack, grog, sgraffito, ...). Use for \"what does leather-hard mean\", \"what's a cone pack\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific studio term to look up; omit to list all.","title":"Term"}},"title":"tool_glossaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/shrinkage_calculator":{"post":{"operationId":"shrinkage_calculator","summary":"Estimates a piece's fired size from its wet size and clay type, using that body's typical total","description":"Estimates a piece's fired size from its wet size and clay type, using that body's typical total\n    (drying + firing combined) shrinkage percentage. Genuinely computed, not a lookup; includes a min/max\n    range since real shrinkage varies by specific clay formulation. Use for \"how big will a 10 inch wide\n    stoneware bowl be after firing\", \"how much should I throw a piece to end up 8 inches wide in\n    porcelain\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"wet_size_inches":{"description":"The piece's size while wet (freshly formed), in inches.","exclusiveMinimum":0,"maximum":200,"title":"Wet Size Inches","type":"number"},"clay_type":{"description":"A clay body, e.g. earthenware, stoneware, porcelain, raku.","title":"Clay Type","type":"string"}},"required":["wet_size_inches","clay_type"],"title":"shrinkage_calculatorArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/troubleshooting_guide":{"post":{"operationId":"troubleshooting_guide","summary":"Likely cause and a prevention tip for a common pottery defect (5 defects covered: cracking,","description":"Likely cause and a prevention tip for a common pottery defect (5 defects covered: cracking,\n    warping, glaze crawling, pinholing, S-cracks). Use for \"why did my pot crack\", \"what causes glaze\n    crawling\", \"how do I prevent S-cracks\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"defect":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A defect, e.g. cracking, warping, glaze crawling, pinholing, S-cracks. Omit to list all.","title":"Defect"}},"title":"troubleshooting_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/safety_guide":{"post":{"operationId":"safety_guide","summary":"General studio safety basics: kiln ventilation, silica dust awareness, and glaze ingredient safety.","description":"General studio safety basics: kiln ventilation, silica dust awareness, and glaze ingredient safety.\n    General awareness only, not exhaustive industrial-hygiene advice. Use for \"do I need to vent my kiln\",\n    \"is clay dust dangerous\", \"are raw glaze materials safe to handle\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"safety_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}