{"openapi":"3.1.0","info":{"title":"Loungeguide API","version":"0.1.0","description":"A general, hand-written educational reference on how airport lounge access typically works: access methods, lounge types, amenities, guest policies, common misconceptions, a glossary, profile-based guidance and etiquette tips. Names no real lounge network, card product or airline program — general industry concepts only.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://loungeguide.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/loungeguide/docs"},"termsOfService":"https://connectorbay.com/loungeguide/terms"},"servers":[{"url":"https://loungeguide.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/loungeguide/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/access_methods_overview":{"post":{"operationId":"access_methods_overview","summary":"The six common ways travelers typically get airport lounge access, at a glance. Use for \"how does lounge","description":"The six common ways travelers typically get airport lounge access, at a glance. Use for \"how does lounge\n    access actually work\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"access_methods_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/access_method_detail":{"post":{"operationId":"access_method_detail","summary":"Full detail on one access method: how it typically works and its common caveats. Use for \"what's the","description":"Full detail on one access method: how it typically works and its common caveats. Use for \"what's the\n    difference between a day pass and elite status\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"method":{"description":"One access method, e.g. 'credit_card_linked', 'day_pass', 'elite_status', 'premium_ticket', 'alliance_status', 'paid_membership_program'.","examples":["elite_status"],"minLength":1,"title":"Method","type":"string"}},"required":["method"],"title":"access_method_detailArguments","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/lounge_types_overview":{"post":{"operationId":"lounge_types_overview","summary":"The general types of airport lounges: airline-operated, alliance-shared, independent pay, and","description":"The general types of airport lounges: airline-operated, alliance-shared, independent pay, and\n    card-branded.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"lounge_types_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/lounge_amenities_overview":{"post":{"operationId":"lounge_amenities_overview","summary":"What airport lounges commonly offer — seating, food and drink, wifi, restrooms, and at larger lounges","description":"What airport lounges commonly offer — seating, food and drink, wifi, restrooms, and at larger lounges\n    showers, spa services or rest areas.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"lounge_amenities_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/guest_policy_overview":{"post":{"operationId":"guest_policy_overview","summary":"How bringing a guest into a lounge typically works — there's no universal rule; it depends entirely on","description":"How bringing a guest into a lounge typically works — there's no universal rule; it depends entirely on\n    the specific access method and lounge.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"guest_policy_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/common_misconceptions":{"post":{"operationId":"common_misconceptions","summary":"Corrects frequent wrong assumptions about lounge access — a boarding pass alone isn't access, premium","description":"Corrects frequent wrong assumptions about lounge access — a boarding pass alone isn't access, premium\n    cabin doesn't always include it, elite status doesn't automatically transfer to every partner airline.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"common_misconceptionsArguments","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/lounge_glossary":{"post":{"operationId":"lounge_glossary","summary":"Defines lounge-access vocabulary: elite status, alliance, day pass, codeshare, capacity limit.","description":"Defines lounge-access vocabulary: elite status, alliance, day pass, codeshare, capacity limit.","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":"lounge_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/choose_access_method":{"post":{"operationId":"choose_access_method","summary":"General guidance on which access method tends to make sense for a traveler profile. Use for \"what's the","description":"General guidance on which access method tends to make sense for a traveler profile. Use for \"what's the\n    best way to get lounge access if I only fly twice a year\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"profile":{"description":"'frequent_business_traveler', 'occasional_traveler', 'premium_card_holder', or 'family_traveling'.","examples":["occasional_traveler"],"title":"Profile","type":"string"}},"required":["profile"],"title":"choose_access_methodArguments","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/lounge_etiquette_tips":{"post":{"operationId":"lounge_etiquette_tips","summary":"Shared-space etiquette for using an airport lounge — noise, food/drink, boarding announcements, guest","description":"Shared-space etiquette for using an airport lounge — noise, food/drink, boarding announcements, guest\n    policy, tidiness.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"lounge_etiquette_tipsArguments","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}}}}