{"openapi":"3.1.0","info":{"title":"Anvil API","version":"0.1.0","description":"A fully local blacksmithing/metalworking hobby reference toolkit: a metal properties guide, forging temperature ranges, a technique guide, a tool glossary, a heat-treatment guide, project difficulty ratings, a safety guide, the steel color-temperature chart, and hardening troubleshooting.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://anvil.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/anvil/docs"},"termsOfService":"https://connectorbay.com/anvil/terms"},"servers":[{"url":"https://anvil.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/anvil/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/metal_guide":{"post":{"operationId":"metal_guide","summary":"General properties, hardness, workability, and typical forging suitability for a metal a hobby smith","description":"General properties, hardness, workability, and typical forging suitability for a metal a hobby smith\n    commonly works (6 metals covered). Use for \"how hard is 1084\", \"is copper easy to forge\", \"what is cast\n    iron used for\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A metal, e.g. mild steel, wrought iron, tool steel, 1084, w1, copper, brass, cast iron. Omit to list all.","title":"Name"}},"title":"metal_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/forge_temperature_guide":{"post":{"operationId":"forge_temperature_guide","summary":"The typical forging/working temperature range for a metal, in both Fahrenheit and Celsius, with a short","description":"The typical forging/working temperature range for a metal, in both Fahrenheit and Celsius, with a short\n    note on how it behaves at heat. Use for \"what temperature do I forge mild steel at\", \"can you forge cast\n    iron\", \"how hot does brass need to be\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"metal":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A metal, e.g. mild steel, wrought iron, tool steel, 1084, w1, copper, brass, cast iron. Omit to list all.","title":"Metal"}},"title":"forge_temperature_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 difficulty level for a core blacksmithing technique (6 techniques covered).","description":"A general description and difficulty level for a core blacksmithing technique (6 techniques covered).\n    Use for \"what is drawing out\", \"how hard is forge welding\", \"how do you twist a bar\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A technique, e.g. drawing out, upsetting, punching, drifting, forge welding, twisting. 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 blacksmithing shop terms and tools (anvil, hardy hole, pritchel hole, hot cut,","description":"Definitions of common blacksmithing shop terms and tools (anvil, hardy hole, pritchel hole, hot cut,\n    fuller, swage, tongs, slack tub, and more — 16 terms covered). Use for \"what's a hardy hole\", \"what's a\n    slack tub\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific shop 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/heat_treatment_guide":{"post":{"operationId":"heat_treatment_guide","summary":"A general explanation of a heat-treatment process and why it's done (annealing, normalizing, quenching,","description":"A general explanation of a heat-treatment process and why it's done (annealing, normalizing, quenching,\n    tempering). Use for \"what's the difference between annealing and normalizing\", \"why do you temper steel\n    after quenching\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"process":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A heat-treatment process, e.g. annealing, normalizing, quenching, tempering. Omit to list all.","title":"Process"}},"title":"heat_treatment_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/project_difficulty_guide":{"post":{"operationId":"project_difficulty_guide","summary":"Beginner/intermediate/advanced difficulty tier and brief reasoning for a classic first blacksmithing","description":"Beginner/intermediate/advanced difficulty tier and brief reasoning for a classic first blacksmithing\n    project (6 projects covered). Use for \"is an s-hook a good first project\", \"how hard is a knife blank\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A beginner project, e.g. s-hook, bottle opener, leaf, nail, hook, knife blank. Omit to list all.","title":"Project"}},"title":"project_difficulty_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 forge and anvil safety awareness: eye/ear/hand protection, clothing (natural fibers, avoid","description":"General forge and anvil safety awareness: eye/ear/hand protection, clothing (natural fibers, avoid\n    synthetics near forge heat), fire safety, and ventilation. Use for \"what should I wear at the forge\", \"is\n    it safe to forge in my garage\".","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}},"/v1/tools/color_temperature_chart":{"post":{"operationId":"color_temperature_chart","summary":"The standard steel color-to-approximate-temperature reference, from black heat through white","description":"The standard steel color-to-approximate-temperature reference, from black heat through white\n    (forge-welding) heat, in both Fahrenheit and Celsius. Use for \"what color is 1500 degrees F\", \"what\n    temperature is orange heat\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"color_temperature_chartArguments","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/hardening_troubleshooting":{"post":{"operationId":"hardening_troubleshooting","summary":"Likely cause and a prevention tip for a common heat-treating/quenching problem (warping, cracking, soft","description":"Likely cause and a prevention tip for a common heat-treating/quenching problem (warping, cracking, soft\n    spots, scale buildup). Use for \"why did my blade warp during the quench\", \"how do I stop scale buildup\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"issue":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A hardening/quenching problem, e.g. warping, cracking, soft spots, scale buildup. Omit to list all.","title":"Issue"}},"title":"hardening_troubleshootingArguments","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}}}}