{"openapi":"3.1.0","info":{"title":"Coldtherapy API","version":"0.1.0","description":"Cold-exposure, contrast-therapy, and sauna general wellness reference with a progression planner and safety screen — all local.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://coldtherapy.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/coldtherapy/docs"},"termsOfService":"https://connectorbay.com/coldtherapy/terms"},"servers":[{"url":"https://coldtherapy.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/coldtherapy/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/cold_exposure_protocol":{"post":{"operationId":"cold_exposure_protocol","summary":"Temperature (°C and °F) and duration ranges reported in general wellness literature for a cold","description":"Temperature (°C and °F) and duration ranges reported in general wellness literature for a cold\n    modality and experience level, with general safety tips. Use for \"how cold and how long for a\n    beginner cold plunge\". Always consult a physician first, especially with a cardiovascular condition.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"modality":{"description":"cold_shower | cold_plunge | ice_bath | outdoor_cold_water","title":"Modality","type":"string"},"experience_level":{"description":"beginner | intermediate | advanced","title":"Experience Level","type":"string"}},"required":["modality","experience_level"],"title":"cold_exposure_protocolArguments","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/contrast_therapy_protocol":{"post":{"operationId":"contrast_therapy_protocol","summary":"Hot/cold contrast-therapy cycle structure (minutes per phase, number of rounds, which","description":"Hot/cold contrast-therapy cycle structure (minutes per phase, number of rounds, which\n    temperature to end on) by session goal. Use for \"what's a good hot/cold contrast routine\". Always\n    consult a physician first, especially with a cardiovascular condition.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"session_goal":{"default":"general","description":"invigorate | reduce_soreness | relax_before_sleep | general","title":"Session Goal","type":"string"}},"title":"contrast_therapy_protocolArguments","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/sauna_protocol":{"post":{"operationId":"sauna_protocol","summary":"Temperature (°C and °F) and duration ranges for traditional (Finnish-style) versus infrared","description":"Temperature (°C and °F) and duration ranges for traditional (Finnish-style) versus infrared\n    sauna, with general safety tips. Use for \"traditional vs infrared sauna temperature and time\".\n    Always consult a physician first, especially with a cardiovascular condition.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"sauna_type":{"description":"traditional | infrared","title":"Sauna Type","type":"string"}},"required":["sauna_type"],"title":"sauna_protocolArguments","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/cold_exposure_progression":{"post":{"operationId":"cold_exposure_progression","summary":"A gradual week-by-week cold-exposure duration ramp, starting at 30 seconds and capped at a","description":"A gradual week-by-week cold-exposure duration ramp, starting at 30 seconds and capped at a\n    general safety ceiling. Use for \"how do I build up my cold exposure over time\". Always consult a\n    physician first, especially with a cardiovascular condition.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"weeks_practicing":{"description":"Weeks of consistent cold-exposure practice so far.","maximum":104,"minimum":0,"title":"Weeks Practicing","type":"integer"}},"required":["weeks_practicing"],"title":"cold_exposure_progressionArguments","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_screening":{"post":{"operationId":"safety_screening","summary":"Match self-reported conditions or situations (e.g. \"heart condition\", \"pregnant\", \"alone\") to","description":"Match self-reported conditions or situations (e.g. \"heart condition\", \"pregnant\", \"alone\") to\n    relevant safety-caution notes for cold exposure, contrast therapy, and sauna use. Use for \"is cold\n    plunging safe with high blood pressure\". Always consult a physician first.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"conditions":{"description":"Conditions or situations to check, in your own words.","examples":[["high blood pressure"],["pregnant","new to this"]],"items":{"type":"string"},"maxItems":10,"minItems":1,"title":"Conditions","type":"array"}},"required":["conditions"],"title":"safety_screeningArguments","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}}}}