{"openapi":"3.1.0","info":{"title":"Travelvax API","version":"0.1.0","description":"A hand-curated, general and point-in-time travel-vaccination/health-requirement reference: real WHO yellow fever certificate requirements by country, the real Saudi Arabia Hajj/Umrah meningococcal requirement, general regional vaccine-consideration guidance, a glossary and travel-health tips. Never diagnostic or personalized medical advice — always defer to a travel-health clinician.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://travelvax.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/travelvax/docs"},"termsOfService":"https://connectorbay.com/travelvax/terms"},"servers":[{"url":"https://travelvax.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/travelvax/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/yellow_fever_requirement":{"post":{"operationId":"yellow_fever_requirement","summary":"One country's real WHO yellow fever status: 'required' (government-mandated entry condition),","description":"One country's real WHO yellow fever status: 'required' (government-mandated entry condition),\n    'recommended' (WHO-identified transmission risk, not mandatory for entry), or 'not_listed'. Use for \"does\n    Kenya require a yellow fever certificate\". This is public health/entry-requirement information, never\n    personal medical advice.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"country":{"description":"A country name.","examples":["Kenya","Ghana"],"minLength":1,"title":"Country","type":"string"}},"required":["country"],"title":"yellow_fever_requirementArguments","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/countries_requiring_yellow_fever":{"post":{"operationId":"countries_requiring_yellow_fever","summary":"WHO's full list of countries that mandate a yellow fever vaccination certificate for entry.","description":"WHO's full list of countries that mandate a yellow fever vaccination certificate for entry.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"countries_requiring_yellow_feverArguments","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/countries_recommending_yellow_fever":{"post":{"operationId":"countries_recommending_yellow_fever","summary":"WHO's full list of countries with yellow fever transmission risk where vaccination is recommended but","description":"WHO's full list of countries with yellow fever transmission risk where vaccination is recommended but\n    not a mandatory entry condition.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"countries_recommending_yellow_feverArguments","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_yellow_fever":{"post":{"operationId":"compare_yellow_fever","summary":"Lines up several countries' yellow fever status side by side.","description":"Lines up several countries' yellow fever status side by side.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"countries":{"description":"2-15 country names to compare.","items":{"type":"string"},"maxItems":15,"minItems":2,"title":"Countries","type":"array"}},"required":["countries"],"title":"compare_yellow_feverArguments","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/region_vaccine_guide":{"post":{"operationId":"region_vaccine_guide","summary":"General, CDC/WHO-style vaccine and health considerations commonly discussed for travel to one broad","description":"General, CDC/WHO-style vaccine and health considerations commonly discussed for travel to one broad\n    region — a starting checklist for a conversation with a travel-health clinician, NOT a personal risk\n    assessment or diagnosis. Use for \"what should I generally consider for a trip to Southeast Asia\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"'Sub-Saharan Africa', 'South Asia', 'Southeast Asia', 'Latin America', or 'Middle East'.","examples":["Southeast Asia"],"title":"Region","type":"string"}},"required":["region"],"title":"region_vaccine_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/regions_list":{"post":{"operationId":"regions_list","summary":"The five broad regions this reference has general vaccine-consideration guidance for.","description":"The five broad regions this reference has general vaccine-consideration guidance for.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"regions_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/hajj_umrah_health_requirements":{"post":{"operationId":"hajj_umrah_health_requirements","summary":"The real, government-mandated meningococcal (ACWY) vaccination certificate requirement for Hajj and","description":"The real, government-mandated meningococcal (ACWY) vaccination certificate requirement for Hajj and\n    Umrah pilgrims to Saudi Arabia, plus other commonly recommended precautions. Use for \"what vaccines does\n    Saudi Arabia require for Hajj\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"hajj_umrah_health_requirementsArguments","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/vaccine_glossary":{"post":{"operationId":"vaccine_glossary","summary":"Defines travel-health terms: yellow fever, the International Certificate of Vaccination ('yellow card'),","description":"Defines travel-health terms: yellow fever, the International Certificate of Vaccination ('yellow card'),\n    Hepatitis A, Typhoid, Japanese encephalitis, rabies pre-exposure vaccination, meningococcal vaccine, and\n    routine vaccines.","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":"vaccine_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/general_travel_health_tips":{"post":{"operationId":"general_travel_health_tips","summary":"Practical, non-diagnostic advice for approaching travel vaccinations: seeing a clinician early, carrying","description":"Practical, non-diagnostic advice for approaching travel vaccinations: seeing a clinician early, carrying\n    your certificate, remembering requirements can depend on where you're arriving from, and that malaria\n    prevention is medication, not a vaccine.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"general_travel_health_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}}}}