Apogeoapi MCP

What APOGEOAPI/apogeoapi-mcp MCP server does

APOGEOAPI/apogeoapi-mcp MCP server connects MCP-compatible assistants to ApogeoAPI's REST API. It covers country records, administrative subdivisions, cities, currency conversion data, and IP address geolocation. The available dataset includes more than 250 countries, over 5,000 states or provinces, and more than 150,000 cities, according to the supplied project description.

Country tools can return details such as a country's name, capital, region, population, currency, time zones, phone code, and live USD exchange rate. Search tools support partial country-name matching and combined searches across countries, states, and cities.

How it works

The server receives tool calls from an MCP client and forwards the relevant request to ApogeoAPI. An assistant can select the appropriate operation from the tool descriptions, such as retrieving a country by ISO2 or ISO3 code or geolocating an IPv4 or IPv6 address.

Currency rates are described as live USD rates and are updated every four hours. IP geolocation can return country, region, city, coordinates, time zone, and EU-membership information. The server uses an API key supplied through the environment, rather than requiring credentials in each tool call.

APOGEOAPI/apogeoapi-mcp MCP server is suitable for assistants that need to answer geography questions, resolve location-related identifiers, look up regional hierarchies, or retrieve exchange-rate information. The free plan covers country listing, country search, country details, and global search. States, cities, live currency rates, and IP geolocation require Basic or a higher plan.

Setup and configuration

Install the package through npm and configure it as an MCP server. For Claude Desktop, add an apogeoapi entry to claude_desktop_config.json; Cursor uses the same server configuration structure in its MCP configuration file. Restart the client after changing the configuration so the tools become available.

{
  "mcpServers": {
    "apogeoapi": {
      "command": "npx",
      "args": ["-y", "@apogeoapi/mcp"],
      "env": {
        "APOGEOAPI_KEY": "your-key"
      }
    }
  }
}

Create an account at ApogeoAPI, generate an API key from the API Keys area, and set it as APOGEOAPI_KEY. The project documents a free plan with 1,000 requests per month and no credit card requirement. APOGEOAPI_BASE_URL is optional and can replace the default https://api.apogeoapi.com endpoint.

A source-based setup is also documented: clone the repository, run npm install, run npm run build, and configure the resulting dist/index.js file with Node.js.

Tools and capabilities

• get_country: Retrieve detailed information using an ISO2 or ISO3 country code.
• list_countries: Return a paginated list of countries.
• search_countries: Find countries by partial name.
• get_states: List states or provinces for a country.
• get_cities: List cities for a state identified by numeric state ID.
• get_currency_rate: Retrieve the country's currency rate against USD.
• geolocate_ip: Resolve an IPv4 or IPv6 address to geographic and timezone data.
• global_search: Search countries, states, and cities in one request.

Limitations and notes

Access depends on the ApogeoAPI plan. The free tier supports country operations and global search, while several geographic and financial operations require Basic, Starter, or Professional access. Monthly request limits vary by plan: 1,000 on Free, 15,000 on Basic, 100,000 on Starter, and 500,000 on Professional.

APOGEOAPI/apogeoapi-mcp MCP server requires an ApogeoAPI key to run. The supplied material identifies the project license as MIT. No hosted MCP endpoint is described; the documented usage runs the package locally through an MCP client.