{"openapi":"3.1.0","info":{"title":"Room Type Glossary API","version":"0.1.0","description":"A fully local, hotel-brand-agnostic glossary of hotel room-type terms (queen/king/double/twin, suite tiers, bed configurations) and rate-plan terms (BAR, refundable vs non-refundable, package rates, meal-plan acronyms), plus a general occupancy-guidance calculator. No real hotel chain names or prices are referenced.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://roomtype.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/roomtype/docs"},"termsOfService":"https://connectorbay.com/roomtype/terms"},"servers":[{"url":"https://roomtype.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/roomtype/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/room_type_lookup":{"post":{"operationId":"room_type_lookup","summary":"Defines one hotel room-type term, or lists them all if omitted. Use for \"what's the difference between a","description":"Defines one hotel room-type term, or lists them all if omitted. Use for \"what's the difference between a\n    double and a twin room\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A room-type term to look up; omit to list all.","examples":["double","twin","suite"],"title":"Term"}},"title":"room_type_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/suite_tier_ladder":{"post":{"operationId":"suite_tier_ladder","summary":"The typical suite hierarchy from entry-level junior suite up to presidential/royal suite. Use for \"what is","description":"The typical suite hierarchy from entry-level junior suite up to presidential/royal suite. Use for \"what is\n    a junior suite\", \"what's the difference between a suite and an executive suite\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"suite_tier_ladderArguments","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/bed_configuration_guide":{"post":{"operationId":"bed_configuration_guide","summary":"Common bed types/sizes (twin, full/double, queen, king, California king) with approximate dimensions and","description":"Common bed types/sizes (twin, full/double, queen, king, California king) with approximate dimensions and\n    typical occupancy. Use for \"how big is a king bed\", \"what's the difference between a queen and a king\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"bed_configuration_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/rate_plan_lookup":{"post":{"operationId":"rate_plan_lookup","summary":"Defines one hotel rate-plan term, or lists them all if omitted. Use for \"what does BAR mean in hotel","description":"Defines one hotel rate-plan term, or lists them all if omitted. Use for \"what does BAR mean in hotel\n    booking\", \"what's a non-refundable rate\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A rate-plan term to look up; omit to list all.","examples":["BAR","non-refundable","package rate"],"title":"Term"}},"title":"rate_plan_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/meal_plan_acronym_decoder":{"post":{"operationId":"meal_plan_acronym_decoder","summary":"Decodes a hotel meal-plan acronym -- EP, CP, BB, HB, FB, AI. Use for \"what does BB mean on a hotel booking","description":"Decodes a hotel meal-plan acronym -- EP, CP, BB, HB, FB, AI. Use for \"what does BB mean on a hotel booking\n    site\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"acronym":{"description":"A meal-plan acronym.","examples":["BB","HB","AI"],"title":"Acronym","type":"string"}},"required":["acronym"],"title":"meal_plan_acronym_decoderArguments","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/general_glossary":{"post":{"operationId":"general_glossary","summary":"Defines general hospitality-industry terms -- ADR, occupancy rate, rack rate, walk-in rate, no-show, upsell","description":"Defines general hospitality-industry terms -- ADR, occupancy rate, rack rate, walk-in rate, no-show, upsell\n    -- or lists them all if omitted. Use for \"what's a rack rate\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A general hospitality term to look up; omit to list all.","examples":["ADR","rack rate","no-show"],"title":"Term"}},"title":"general_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/search_glossary":{"post":{"operationId":"search_glossary","summary":"Keyword search across every category at once -- room types, rate plans, meal-plan acronyms, and general","description":"Keyword search across every category at once -- room types, rate plans, meal-plan acronyms, and general\n    terms. Use for \"search for anything about cancellation\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Keyword to search across room types, rate plans, meal plans and general terms.","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"search_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/compare_room_types":{"post":{"operationId":"compare_room_types","summary":"Side-by-side comparison of two or more named room types. Use for \"compare a studio and a junior suite\".","description":"Side-by-side comparison of two or more named room types. Use for \"compare a studio and a junior suite\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"types":{"description":"Two or more room-type terms to compare.","items":{"type":"string"},"minItems":2,"title":"Types","type":"array"}},"required":["types"],"title":"compare_room_typesArguments","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_rate_plans":{"post":{"operationId":"compare_rate_plans","summary":"Side-by-side comparison of two or more named rate plans. Use for \"compare a refundable rate and an advance","description":"Side-by-side comparison of two or more named rate plans. Use for \"compare a refundable rate and an advance\n    purchase rate\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"plans":{"description":"Two or more rate-plan terms to compare.","items":{"type":"string"},"minItems":2,"title":"Plans","type":"array"}},"required":["plans"],"title":"compare_rate_plansArguments","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/occupancy_guidance":{"post":{"operationId":"occupancy_guidance","summary":"General (property-varies) guidance on whether a stated number of adults/children likely fits one room of a","description":"General (property-varies) guidance on whether a stated number of adults/children likely fits one room of a\n    given type, and roughly how many rooms would probably be needed if not. Use for \"will a family of 5 fit in one\n    suite\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"num_adults":{"description":"Number of adults.","minimum":1,"title":"Num Adults","type":"integer"},"num_children":{"description":"Number of children.","minimum":0,"title":"Num Children","type":"integer"},"room_type":{"description":"A room-type term, e.g. 'standard queen', 'suite'.","title":"Room Type","type":"string"}},"required":["num_adults","num_children","room_type"],"title":"occupancy_guidanceArguments","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}}}}