{"openapi":"3.1.0","info":{"title":"Atlas API","version":"0.1.0","description":"Countries, places, distances, elevation, reverse geocoding, airports and World Bank indicators — keyless world geography.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://atlas.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/atlas/docs"},"termsOfService":"https://connectorbay.com/atlas/terms"},"servers":[{"url":"https://atlas.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/atlas/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/country":{"post":{"operationId":"country","summary":"A country's facts: official name, capital, region, currencies, languages, calling code, TLD, area, neighbours, flag,","description":"A country's facts: official name, capital, region, currencies, languages, calling code, TLD, area, neighbours, flag,\n    demonym, native and translated names, plus the latest World Bank figures (population, GDP, GDP per capita, life\n    expectancy by default; ask for others). Use for \"tell me about Ghana\", \"what currency does Vietnam use\", \"GDP of Brazil\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"Country name (any common language), ISO2 or ISO3 code.","examples":["Ghana","DE","BRA"],"title":"Name","type":"string"},"indicators":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"World Bank indicators to include; default population, gdp_usd, gdp_per_capita_usd, life_expectancy. Any of: population, gdp_usd, gdp_per_capita_usd, gdp_growth_pct, life_expectancy, inflation_pct, unemployment_pct, urban_pct, internet_users_pct, literacy_pct, co2_tonnes_per_capita, fertility_rate, population_growth_pct, land_area_km2, forest_pct, electricity_access_pct, gini, military_pct_gdp, health_pct_gdp, mobile_subscriptions_per_100, poverty_pct_2_15, renewable_energy_pct.","title":"Indicators"}},"required":["name"],"title":"countryArguments","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/country_indicator":{"post":{"operationId":"country_indicator","summary":"A World Bank indicator for a country over recent years — population, GDP, growth, inflation, life expectancy, CO₂,","description":"A World Bank indicator for a country over recent years — population, GDP, growth, inflation, life expectancy, CO₂,\n    internet use and 15 more — as a year-by-year series with the change over the period. Use for \"how has India's\n    population grown in 10 years\", \"Brazil's inflation history\", \"Kenya's internet use over time\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"Country name (any common language), ISO2 or ISO3 code.","examples":["Ghana","DE","BRA"],"title":"Name","type":"string"},"indicator":{"description":"One of: population, gdp_usd, gdp_per_capita_usd, gdp_growth_pct, life_expectancy, inflation_pct, unemployment_pct, urban_pct, internet_users_pct, literacy_pct, co2_tonnes_per_capita, fertility_rate, population_growth_pct, land_area_km2, forest_pct, electricity_access_pct, gini, military_pct_gdp, health_pct_gdp, mobile_subscriptions_per_100, poverty_pct_2_15, renewable_energy_pct, or a raw World Bank code like SP.POP.TOTL.","examples":["population","gdp_per_capita_usd"],"title":"Indicator","type":"string"},"years":{"default":10,"description":"How many most-recent years (1–60).","maximum":60,"minimum":1,"title":"Years","type":"integer"}},"required":["name","indicator"],"title":"country_indicatorArguments","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":{"post":{"operationId":"countries","summary":"Countries matching filters — by region/subregion, currency, language, neighbour, landlocked or dialing code — with","description":"Countries matching filters — by region/subregion, currency, language, neighbour, landlocked or dialing code — with\n    capital, ISO codes and flag. Use for \"which countries use the euro\", \"Portuguese-speaking countries\", \"who borders\n    Germany\", \"landlocked countries in Africa\", \"whose dialing code is +44\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Region or subregion: 'Africa', 'Western Europe', 'South-Eastern Asia', 'Caribbean'.","title":"Region"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Currency code: 'EUR', 'USD', 'XOF'.","title":"Currency"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Language: 'Portuguese', 'Arabic'.","title":"Language"},"borders":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Countries bordering this one.","title":"Borders"},"landlocked":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Only landlocked (true) or coastal (false).","title":"Landlocked"},"calling_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Dialing code like '+44' or '44'.","title":"Calling Code"}},"title":"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/place":{"post":{"operationId":"place","summary":"Locate a place: coordinates (decimal and DMS), country and region, time zone with current local time, population","description":"Locate a place: coordinates (decimal and DMS), country and region, time zone with current local time, population\n    (for cities), nearest big city (for coordinates or airports), and optionally elevation. Use for \"where is Timbuktu\",\n    \"coordinates of Denver\", \"what time zone is Perth in\", \"how high is Lhasa\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"A city ('Denver', 'Leeds, UK'), an airport code ('LHR'), or coordinates ('27.98, 86.92').","examples":["Denver","Leeds, UK","27.98, 86.92"],"title":"Query","type":"string"},"elevation":{"default":false,"description":"Also fetch elevation (Open-Meteo DEM).","title":"Elevation","type":"boolean"}},"required":["query"],"title":"placeArguments","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/distance":{"post":{"operationId":"distance","summary":"Great-circle distance between two places (km, miles, nautical miles), initial bearing and compass direction, the","description":"Great-circle distance between two places (km, miles, nautical miles), initial bearing and compass direction, the\n    midpoint, a rough non-stop flight time, and the time-zone difference. Use for \"how far is Denver from Tokyo\", \"which\n    direction is Mecca from here\", \"flight time London to Singapore\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"from_place":{"description":"A city ('Denver', 'Leeds, UK'), an airport code ('LHR'), or coordinates ('27.98, 86.92').","examples":["Denver","Leeds, UK","27.98, 86.92"],"title":"From Place","type":"string"},"to_place":{"description":"A city ('Denver', 'Leeds, UK'), an airport code ('LHR'), or coordinates ('27.98, 86.92').","examples":["Denver","Leeds, UK","27.98, 86.92"],"title":"To Place","type":"string"}},"required":["from_place","to_place"],"title":"distanceArguments","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/whats_here":{"post":{"operationId":"whats_here","summary":"What is at a coordinate: the nearest address/town/region/country (OpenStreetMap reverse geocoding), the nearest big","description":"What is at a coordinate: the nearest address/town/region/country (OpenStreetMap reverse geocoding), the nearest big\n    city with distance, elevation, and the time zone. Use for \"what's at 27.98, 86.92\", \"which country is this point in\",\n    \"reverse geocode these coordinates\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"coordinates":{"description":"Latitude, longitude in decimal or DMS.","examples":["27.9881, 86.9250","40°42′46″N 74°00′22″W"],"title":"Coordinates","type":"string"}},"required":["coordinates"],"title":"whats_hereArguments","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/airports":{"post":{"operationId":"airports","summary":"Airports: look one up by IATA/ICAO code or name (with coordinates, elevation, country/region, city, scheduled","description":"Airports: look one up by IATA/ICAO code or name (with coordinates, elevation, country/region, city, scheduled\n    service, Wikipedia), or list the nearest airports to a place with distance and direction. 6,000 airports with\n    scheduled service or of medium/large size. Use for \"what airport is LHR\", \"airports near Munich\", \"nearest major\n    airport to Santa Fe\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Airport code (IATA 'LHR' / ICAO 'EGLL') or part of a name/city ('Heathrow', 'Munich').","title":"Query"},"near":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A place or coordinates to find the nearest airports to.","title":"Near"},"large_only":{"default":false,"description":"For 'near': only major (large) airports.","title":"Large Only","type":"boolean"},"limit":{"default":5,"description":"Max airports (1–20).","maximum":20,"minimum":1,"title":"Limit","type":"integer"}},"title":"airportsArguments","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/convert_coordinates":{"post":{"operationId":"convert_coordinates","summary":"Convert coordinates between decimal degrees and degrees-minutes-seconds, with hemisphere, a map link and the nearest","description":"Convert coordinates between decimal degrees and degrees-minutes-seconds, with hemisphere, a map link and the nearest\n    city. Local, instant. Use for \"what is 40°42′N 74°00′W in decimal\", \"DMS for 51.5, -0.12\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"coordinates":{"description":"Coordinates in decimal ('40.7128, -74.0060') or DMS ('40°42′46″N 74°00′22″W').","examples":["40°42′46″N 74°00′22″W"],"title":"Coordinates","type":"string"}},"required":["coordinates"],"title":"convert_coordinatesArguments","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}}}}