{"openapi":"3.1.0","info":{"title":"Ember API","version":"0.1.0","description":"A fully local campfire & fire-building reference toolkit: fire lay structures, tinder/kindling/fuel-wood classification, firewood burn-quality notes, a safety checklist, fire-starting method overviews, campfire cooking technique, the standard extinguishing method, troubleshooting and a glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://ember.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/ember/docs"},"termsOfService":"https://connectorbay.com/ember/terms"},"servers":[{"url":"https://ember.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/ember/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/fire_lay_guide":{"post":{"operationId":"fire_lay_guide","summary":"Describes one fire-lay structure — its build steps and best use case (quick blaze vs. a long-burning coal","description":"Describes one fire-lay structure — its build steps and best use case (quick blaze vs. a long-burning coal\n    bed, windy conditions, cooking, and so on) — or lists all five (teepee, log cabin, lean-to, star fire,\n    upside-down/pyramid) when no type is given. Use for \"how do I build a teepee fire\", \"what fire lay is best for\n    wind\", \"which lay lasts all night\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A fire lay to describe; omit to list all five.","examples":["teepee","log cabin","lean-to","star fire","upside-down"],"title":"Type"}},"title":"fire_lay_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/tinder_kindling_fuel_guide":{"post":{"operationId":"tinder_kindling_fuel_guide","summary":"Explains the three-stage fuel classification used to build any fire — tinder (fine, fibrous material that","description":"Explains the three-stage fuel classification used to build any fire — tinder (fine, fibrous material that\n    catches from a spark), kindling (pencil-to-thumb-thickness sticks), and fuel wood (larger logs that sustain the\n    fire) — each with examples and notes. Use for \"what's the difference between tinder and kindling\", \"what\n    counts as kindling\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"tinder_kindling_fuel_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/firewood_guide":{"post":{"operationId":"firewood_guide","summary":"General burn-quality tendencies for a common firewood species — heat output, burn time, smoke, resin/sap,","description":"General burn-quality tendencies for a common firewood species — heat output, burn time, smoke, resin/sap,\n    and ease of lighting — plus a note on seasoned (dried) vs. green wood. Omit wood_type to list every species\n    covered. Use for \"does oak or pine burn longer\", \"is cedar good firewood\", \"what's the difference between\n    seasoned and green wood\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"wood_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A firewood species; omit to list all covered species.","examples":["oak","hickory","pine","cedar","birch","ash","maple"],"title":"Wood Type"}},"title":"firewood_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/fire_safety_checklist":{"post":{"operationId":"fire_safety_checklist","summary":"The standard pre-fire and during-fire safety checklist: clearing the area, keeping water/dirt/a shovel","description":"The standard pre-fire and during-fire safety checklist: clearing the area, keeping water/dirt/a shovel\n    nearby, checking local fire restrictions and burn bans, a safe distance from tents and structures, and never\n    leaving a fire unattended. Use for \"what safety steps should I take before building a campfire\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"fire_safety_checklistArguments","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/fire_starting_method_guide":{"post":{"operationId":"fire_starting_method_guide","summary":"A how-to overview of one fire-starting method — matches, lighter, ferro rod/fire steel, bow drill, or","description":"A how-to overview of one fire-starting method — matches, lighter, ferro rod/fire steel, bow drill, or\n    magnifying glass — with its relative difficulty and reliability, or lists all five when no method is given.\n    Use for \"how do I use a ferro rod\", \"is a bow drill reliable\", \"easiest way to start a fire\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"method":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A fire-starting method; omit to list all five.","examples":["matches","lighter","ferro rod","bow drill","magnifying glass"],"title":"Method"}},"title":"fire_starting_method_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/campfire_cooking_guide":{"post":{"operationId":"campfire_cooking_guide","summary":"Compares coal-bed cooking to direct-flame cooking (timing and technique differences) and covers","description":"Compares coal-bed cooking to direct-flame cooking (timing and technique differences) and covers\n    foil-packet and stick-cooking basics. Use for \"should I cook over flame or coals\", \"how do I cook a foil\n    packet\", \"how do I cook on a stick\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"campfire_cooking_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/extinguishing_guide":{"post":{"operationId":"extinguishing_guide","summary":"The standard drown-stir-drown-feel method for fully extinguishing a fire, matching official U.S. Forest","description":"The standard drown-stir-drown-feel method for fully extinguishing a fire, matching official U.S. Forest\n    Service / Smokey Bear guidance, plus why a fire must be cold to the touch before you leave it. Use for \"how do\n    I put out a campfire\", \"how do I know my fire is really out\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"extinguishing_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/troubleshooting_guide":{"post":{"operationId":"troubleshooting_guide","summary":"Diagnoses a specific campfire problem — won't catch or stay lit, too much smoke, dies out quickly, won't","description":"Diagnoses a specific campfire problem — won't catch or stay lit, too much smoke, dies out quickly, won't\n    produce good coals — with likely causes (wet wood, insufficient airflow, tinder too coarse, ...) and fixes.\n    Use for \"why won't my fire stay lit\", \"my fire is really smoky\", \"why isn't my fire making coals\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"issue":{"description":"A fire problem, in plain language.","examples":["won't catch","too much smoke","dies out quickly","won't produce good coals"],"minLength":1,"title":"Issue","type":"string"}},"required":["issue"],"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/fire_glossary":{"post":{"operationId":"fire_glossary","summary":"Definitions of common fire-building terms — tinder, kindling, coal bed, ferro rod, bellows effect, char","description":"Definitions of common fire-building terms — tinder, kindling, coal bed, ferro rod, bellows effect, char\n    cloth, fatwood, seasoned/green wood, tinder bundle, flare-up. Use for \"what's a bellows effect\", \"what does\n    fatwood mean\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific term to look up; omit to list all.","title":"Term"}},"title":"fire_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}}}}