{"openapi":"3.1.0","info":{"title":"Bloom API","version":"0.1.0","description":"A fully local tea brewing reference and calculator: tea-type characteristics, verified brewing parameters, a leaf-to-water ratio calculator, a caffeine reference, a resteeping guide, storage and water-quality guidance, and tea-ceremony/tradition notes.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://bloom.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/bloom/docs"},"termsOfService":"https://connectorbay.com/bloom/terms"},"servers":[{"url":"https://bloom.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/bloom/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/tea_type_info":{"post":{"operationId":"tea_type_info","summary":"A tea type's oxidation level, processing, flavor profile, and typical origin — white (minimal","description":"A tea type's oxidation level, processing, flavor profile, and typical origin — white (minimal\n    oxidation), green (none), oolong (partial, 8-85%), black (full), pu-erh (post-fermented, not oxidized),\n    or herbal/tisane (not true tea at all). Use for \"what's the oxidation level of oolong\", \"where does white\n    tea come from\", \"what does pu-erh taste like\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"Tea type.","examples":["white","green","oolong","black","pu-erh","herbal"],"title":"Name","type":"string"}},"required":["name"],"title":"tea_type_infoArguments","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/brewing_parameters_guide":{"post":{"operationId":"brewing_parameters_guide","summary":"The verified water temperature range (°F and °C) and steep time for a tea type — green and white brew","description":"The verified water temperature range (°F and °C) and steep time for a tea type — green and white brew\n    coolest and shortest, oolong spans a wide middle range, black and herbal brew hottest, and pu-erh uses very\n    short gongfu-style infusions. Use for \"what water temperature for green tea\", \"how long should I steep\n    black tea\", \"is oolong brewed hotter than green tea\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"tea_type":{"description":"Tea type.","examples":["white","green","oolong","black","pu-erh","herbal"],"title":"Tea Type","type":"string"}},"required":["tea_type"],"title":"brewing_parameters_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/leaf_ratio_calculator":{"post":{"operationId":"leaf_ratio_calculator","summary":"Computes how much loose tea to use for a given amount of water: a standard ~2g-per-8oz default ratio,","description":"Computes how much loose tea to use for a given amount of water: a standard ~2g-per-8oz default ratio,\n    adjusted per type for leaf density (bulkier white, oolong, pu-erh and herbal leaf/material need a bit more\n    mass than flat green or black leaf). Use for \"how much tea for 16oz of water\", \"how much loose oolong do I\n    need for a liter\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"water_oz":{"description":"Water amount in fluid ounces.","exclusiveMinimum":0,"title":"Water Oz","type":"number"},"tea_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Tea type to adjust the ratio for; omit to use the general default (~2g per 8oz).","title":"Tea Type"}},"required":["water_oz"],"title":"leaf_ratio_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/caffeine_reference":{"post":{"operationId":"caffeine_reference","summary":"A general, approximate relative caffeine ordering by tea type (black highest of the common teas,","description":"A general, approximate relative caffeine ordering by tea type (black highest of the common teas,\n    then pu-erh, oolong, green, white, with herbal/tisane typically caffeine-free) and a rough mg-per-8oz range\n    — framed as approximate, since actual caffeine varies more with cultivar, leaf part, particle size and\n    brewing than with category alone. Use for \"is black tea more caffeinated than green tea\", \"does herbal tea\n    have caffeine\", \"how much caffeine is in oolong\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"tea_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Tea type to look up; omit to see the full relative ordering.","title":"Tea Type"}},"title":"caffeine_referenceArguments","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/resteeping_guide":{"post":{"operationId":"resteeping_guide","summary":"Which tea types are good for multiple steeps (oolong and pu-erh especially, brewed gongfu-style) and","description":"Which tea types are good for multiple steeps (oolong and pu-erh especially, brewed gongfu-style) and\n    how many infusions are typical, plus the general principle for adjusting steep time on later infusions\n    (lengthen each one rather than repeating the first steep's time). Use for \"can I resteep green tea\", \"how\n    many times can I steep pu-erh\", \"how do I brew oolong gongfu style\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"tea_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Tea type to look up; omit to see all types.","title":"Tea Type"}},"title":"resteeping_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/storage_guide":{"post":{"operationId":"storage_guide","summary":"General best practices for storing tea so it stays fresh: light, air, moisture, odor and heat exposure,","description":"General best practices for storing tea so it stays fresh: light, air, moisture, odor and heat exposure,\n    plus a rough shelf-life guide by category (pu-erh being the deliberate exception that's meant to age). Use\n    for \"how should I store my tea\", \"can I keep tea in the fridge\", \"how long does green tea stay fresh\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"storage_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/ceremony_and_tradition_info":{"post":{"operationId":"ceremony_and_tradition_info","summary":"Brief, factual notes on a tea tradition — Chinese gongfu cha, the Japanese tea ceremony (chanoyu), or","description":"Brief, factual notes on a tea tradition — Chinese gongfu cha, the Japanese tea ceremony (chanoyu), or\n    British afternoon tea — covering what it is, its key elements, and its cultural significance. Use for\n    \"what is gongfu cha\", \"what is chanoyu\", \"what's the difference between afternoon tea and high tea\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"tradition":{"description":"Tea tradition.","examples":["gongfu cha","japanese tea ceremony","british afternoon tea"],"title":"Tradition","type":"string"}},"required":["tradition"],"title":"ceremony_and_tradition_infoArguments","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/water_quality_guide":{"post":{"operationId":"water_quality_guide","summary":"General water-quality guidance for brewing tea: filtered vs. tap water, why distilled water tastes flat,","description":"General water-quality guidance for brewing tea: filtered vs. tap water, why distilled water tastes flat,\n    water hardness, and why re-boiled water is worth avoiding. Use for \"what water is best for tea\", \"should I\n    use filtered water for tea\", \"why does my tea taste flat\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"water_quality_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/tea_glossary":{"post":{"operationId":"tea_glossary","summary":"Definitions of common tea terms (oxidation, fixation/kill-green, withering, flush, gongfu, agony of the","description":"Definitions of common tea terms (oxidation, fixation/kill-green, withering, flush, gongfu, agony of the\n    leaves, tisane, CTC, muscatel, terroir, whole leaf vs. fannings/dust, umami). Use for \"what does flush mean\n    in tea\", \"what's the agony of the leaves\", \"what does CTC 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":"tea_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}}}}