A state lookup that returns nothing because of a plan limit looks identical to a country with no states, and an agent will report the second. Saying 'requires Starter plan or above' in the description means the failure is interpretable before it happens. global_search is the other genuinely useful piece: a place name arrives without a level attached — nobody says 'the city of' — and searching all three at once matches how the question is actually asked. Returning basic fields by default with more on request is the right shape for a reference API where most callers want a name and a code.
A geographic reference client covering the country-state-city hierarchy, currency rates and IP geolocation, with plan tiers gating the deeper levels.
- get_country takes an ISO2 or ISO3 code and returns the full record; search_countries matches partial names, so a fragment finds the country.
- global_search spans countries, states and cities in one query rather than requiring you to know which level the place sits at.
- get_states and get_cities walk the hierarchy, and both state plainly that they need the Starter plan or above — the gate is named in the tool rather than discovered on a failure.
- get_currency_rate returns the live USD rate for a country's currency, with the four-hour update interval stated.
- geolocate_ip handles IPv4 and IPv6, returning country, region, city and coordinates.
- list_countries paginates and returns basic fields by default, with more available on request rather than by default.
APOGEOAPI_KEY. Some tools require a paid tier, which they name in their own descriptions.
One command plus a key — npx -y @apogeoapi/mcp, then supply credentials