{"openapi":"3.1.0","info":{"title":"Emergencyworld API","version":"0.1.0","description":"A hand-curated worldwide directory of real emergency telephone numbers (police, fire, ambulance, unified general number) for 69 countries across every populated region, cross-checked between independent public sources, with region browsing, comparison, reverse number lookup, unified-number listing and general dialing safety tips.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://emergencyworld.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/emergencyworld/docs"},"termsOfService":"https://connectorbay.com/emergencyworld/terms"},"servers":[{"url":"https://emergencyworld.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/emergencyworld/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/emergency_numbers":{"post":{"operationId":"emergency_numbers","summary":"One country's real emergency numbers — police, fire, ambulance, and a unified general number if one","description":"One country's real emergency numbers — police, fire, ambulance, and a unified general number if one\n    exists — plus any usage notes. Use for \"what's the emergency number in Japan\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"country":{"description":"A country name.","examples":["Japan","Kenya"],"minLength":1,"title":"Country","type":"string"}},"required":["country"],"title":"emergency_numbersArguments","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/numbers_by_region":{"post":{"operationId":"numbers_by_region","summary":"Every covered country's emergency numbers in one region. Use for \"list emergency numbers across","description":"Every covered country's emergency numbers in one region. Use for \"list emergency numbers across\n    Europe\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"'Europe', 'Americas', 'Asia-Pacific', 'Middle East', or 'Africa'.","examples":["Europe"],"title":"Region","type":"string"}},"required":["region"],"title":"numbers_by_regionArguments","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_countries":{"post":{"operationId":"compare_countries","summary":"Lines up several countries' emergency numbers side by side. Use for \"compare emergency numbers for","description":"Lines up several countries' emergency numbers side by side. Use for \"compare emergency numbers for\n    Kenya, Nigeria and South Africa\".","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_countriesArguments","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/which_uses_number":{"post":{"operationId":"which_uses_number","summary":"Every covered country using a given number, and which service(s) it reaches there. Use for \"does 911","description":"Every covered country using a given number, and which service(s) it reaches there. Use for \"does 911\n    mean anything in the UK\", \"which countries use 112\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"number":{"description":"An emergency number to check, e.g. '911', '112', '999'.","examples":["911"],"minLength":1,"title":"Number","type":"string"}},"required":["number"],"title":"which_uses_numberArguments","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_with_unified_number":{"post":{"operationId":"countries_with_unified_number","summary":"Countries where a single number covers police, fire and ambulance together (like 112 or 911), instead","description":"Countries where a single number covers police, fire and ambulance together (like 112 or 911), instead\n    of separate numbers per service. Use for \"which countries have just one emergency number for everything\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optionally restrict to one region.","title":"Region"}},"title":"countries_with_unified_numberArguments","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 regions this reference covers, with how many countries are in each.","description":"The regions this reference covers, with how many countries are in each.","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/countries_list":{"post":{"operationId":"countries_list","summary":"Every country this reference has emergency-number data for (69 total, not every country in the world).","description":"Every country this reference has emergency-number data for (69 total, not every country in the world).","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"countries_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/dialing_facts":{"post":{"operationId":"dialing_facts","summary":"Broader emergency-dialling patterns worth knowing: the EU's shared 112, the Americas' spread of 911, the","description":"Broader emergency-dialling patterns worth knowing: the EU's shared 112, the Americas' spread of 911, the\n    Commonwealth's 999, and the mobile-phone 112 fallback behaviour built into most handsets worldwide.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"dialing_factsArguments","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_safety_tips":{"post":{"operationId":"general_safety_tips","summary":"Practical, non-country-specific advice for calling for help while travelling abroad — not a substitute","description":"Practical, non-country-specific advice for calling for help while travelling abroad — not a substitute\n    for knowing the actual local number.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"general_safety_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}}}}