What it does
geodata is a thin MCP client for the ApogeoAPI REST API. It provides eight tools: full country details by ISO2 or ISO3 code, a paginated catalogue of more than 250 countries, country name search, the states of a country, the cities of a state, the live USD exchange rate for a country's currency (updated every 4 hours), IP geolocation for IPv4 and IPv6 addresses, and a single search across countries, states and cities. Successful calls return the upstream JSON unchanged.
It suits applications or assistants that need geographic reference data, currency rates or IP location lookups through one API key. An optional base parameter, such as EUR, changes the currency base for rates. Invalid arguments are rejected with specific messages before any request is sent.
Running it requires an ApogeoAPI key, read from the APOGEOAPI_KEY environment variable and sent as the X-API-Key header. The base URL can be set with APOGEOAPI_BASE_URL and defaults to the public API. It can be used as a command-line tool, where each tool is a subcommand that takes one JSON argument string, or as an MCP server configured in an MCP client. The project is released under the MIT license.
Limitations and requirements
An ApogeoAPI key is required; without APOGEOAPI_KEY every tool fails and no request is made. Upstream non-2xx responses and unreachable API conditions are returned as errors. Four request paths (country search, states, cities and global search) are reconstructions that are not confirmed by the vendor's worked examples, and the page, limit and base parameter names for list_countries are also reconstructed.
Safety
Our team has not reviewed this resource. Only automated rules checked it; resources with high-risk signals are not published. These are signals, not a guarantee that installing it is safe. Try it in a sandbox project first.
- Runs code or changes an assistant's behaviour
Sources
- Official MCP Registry first seen 13 Nov 2026 · last seen 13 Nov 2026 · its page on the source
io.github.CloudCorpRecords/geodata
Geographic data by API key: countries, states, cities, currency rates and IP geolocation.
v0.1.0As shown on registry.modelcontextprotocol.io when we last read it