{"openapi":"3.1.0","info":{"title":"Climate Window API","version":"0.1.0","description":"A fully local, hand-curated reference on how to think about seasonal travel timing — a methodology/framework, Koppen-style climate-zone archetypes, a handful of verified illustrative climate-normal examples, and web-verified tropical-cyclone-season date ranges by ocean basin. Not live weather.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://climatewindow.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/climatewindow/docs"},"termsOfService":"https://connectorbay.com/climatewindow/terms"},"servers":[{"url":"https://climatewindow.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/climatewindow/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/methodology_overview":{"post":{"operationId":"methodology_overview","summary":"The general framework for thinking about seasonal travel timing: identify the climate archetype, find","description":"The general framework for thinking about seasonal travel timing: identify the climate archetype, find\n    shoulder seasons, and weigh weather vs crowds vs price for the specific trip. Use for \"how do I think about the\n    best time to visit somewhere\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"methodology_overviewArguments","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/climate_zone_archetype":{"post":{"operationId":"climate_zone_archetype","summary":"The general seasonal pattern and best-time heuristic for a standard Koppen-style climate zone — tropical","description":"The general seasonal pattern and best-time heuristic for a standard Koppen-style climate zone — tropical\n    rainforest, tropical monsoon, tropical savanna, hot desert, Mediterranean, humid subtropical, temperate oceanic,\n    continental, or polar/alpine. Use for \"what's a monsoon climate like\", \"when's the best time to visit a\n    Mediterranean climate\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"zone":{"description":"A climate-zone archetype.","examples":["tropical monsoon","mediterranean","hot desert","continental"],"minLength":1,"title":"Zone","type":"string"}},"required":["zone"],"title":"climate_zone_archetypeArguments","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/zone_list":{"post":{"operationId":"zone_list","summary":"Every climate-zone archetype Climate Window covers. Use for \"what climate zones do you cover\".","description":"Every climate-zone archetype Climate Window covers. Use for \"what climate zones do you cover\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"zone_listArguments","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/climate_normals_reference":{"post":{"operationId":"climate_normals_reference","summary":"A handful of verified, dated illustrative examples pairing a well-known region (Mumbai, Bangkok, Cairo,","description":"A handful of verified, dated illustrative examples pairing a well-known region (Mumbai, Bangkok, Cairo,\n    Rome, London, Singapore, Sydney) with its recognized climate archetype and general seasonal pattern — not a\n    live or exhaustive climate-normals database. Use for \"what's the climate pattern like in Rome\", \"list your\n    climate reference examples\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A region name to filter to; omit to list all examples.","title":"Region"}},"title":"climate_normals_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/cyclone_season_reference":{"post":{"operationId":"cyclone_season_reference","summary":"Web-verified tropical-cyclone/hurricane/typhoon season date ranges by ocean basin and the monitoring agency","description":"Web-verified tropical-cyclone/hurricane/typhoon season date ranges by ocean basin and the monitoring agency\n    that defines them. Use for \"when is hurricane season in the Atlantic\", \"when are typhoons most likely in the\n    Western Pacific\", \"cyclone season in the Bay of Bengal\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"basin":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"An ocean basin; omit to list all.","examples":["Atlantic","Western Pacific","North Indian Ocean"],"title":"Basin"}},"title":"cyclone_season_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/hemisphere_season_lookup":{"post":{"operationId":"hemisphere_season_lookup","summary":"Pure computation: given a calendar month, returns the meteorological season in the Northern and Southern","description":"Pure computation: given a calendar month, returns the meteorological season in the Northern and Southern\n    Hemisphere. Use for \"what season is it in Australia in July\", \"is it summer or winter in South Africa in\n    December\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"month":{"description":"Month number, 1-12.","maximum":12,"minimum":1,"title":"Month","type":"integer"}},"required":["month"],"title":"hemisphere_season_lookupArguments","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/best_time_framework":{"post":{"operationId":"best_time_framework","summary":"Gives the relevant guidance for whichever of weather, crowd-avoidance, or price matters most for a trip,","description":"Gives the relevant guidance for whichever of weather, crowd-avoidance, or price matters most for a trip,\n    plus how to weigh the three factors generally. Use for \"should I prioritize weather or price for a beach trip\",\n    \"how do I pick dates to avoid crowds\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"priority":{"description":"What matters most for this trip.","examples":["weather","crowds","price"],"minLength":1,"title":"Priority","type":"string"}},"required":["priority"],"title":"best_time_frameworkArguments","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/compare_zones":{"post":{"operationId":"compare_zones","summary":"Puts two climate-zone archetypes side by side. Use for \"compare a monsoon climate to a Mediterranean","description":"Puts two climate-zone archetypes side by side. Use for \"compare a monsoon climate to a Mediterranean\n    climate\", \"tropical savanna vs tropical rainforest\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"zone_a":{"description":"First climate zone.","minLength":1,"title":"Zone A","type":"string"},"zone_b":{"description":"Second climate zone.","minLength":1,"title":"Zone B","type":"string"}},"required":["zone_a","zone_b"],"title":"compare_zonesArguments","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/trip_timing_checklist":{"post":{"operationId":"trip_timing_checklist","summary":"A practical pre-trip checklist of questions to ask before picking travel dates, tying together the other","description":"A practical pre-trip checklist of questions to ask before picking travel dates, tying together the other\n    tools. Use for \"what should I think about before picking dates for a trip\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"trip_timing_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/climate_glossary":{"post":{"operationId":"climate_glossary","summary":"Definitions of common seasonal-travel-timing terms — shoulder season, high/low season, monsoon, Koppen","description":"Definitions of common seasonal-travel-timing terms — shoulder season, high/low season, monsoon, Koppen\n    classification, climate normal, dry/wet season. Use for \"what's a shoulder season\", \"what's a climate normal\".","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":"climate_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}}}}