apogeoapi-mcp MCP Server

MCP (Model Context Protocol) server for ApogeoAPI — geographic data, live exchange rates, and IP geolocation for Claude Desktop, Cursor, and any MCP-compatible AI assistant.

Local serverstdioMIT

What is the apogeoapi-mcp Server?

apogeoapi-mcp is an MCP project maintained in the apogeoapi/apogeoapi-mcp repository. The maintainer describes its purpose as “MCP (Model Context Protocol) server for ApogeoAPI — geographic data, live exchange rates, and IP geolocation for Claude Desktop, Cursor, and any MCP-compatible AI assistant”. Read the project documentation for the complete scope.

Installation

The documented npm package is @apogeoapi/mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares APOGEOAPI_KEY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_countryFull country data by ISO2/ISO3 code — name, capital, region, population, currency, timezones, phone code (plus the live USD rate on Basic+)
list_countriesPaginated list of all 250+ countries
search_countriesSearch countries by partial name
get_statesAll states/provinces for a country
get_citiesAll cities for a state by numeric state ID
get_currency_rateLive USD exchange rate for a country's currency (updated every 4 hours)
geolocate_ipCountry, region, city, coordinates, timezone, and EU membership for any IPv4/IPv6
global_searchSearch across countries, states, and cities in one query

How to install the apogeoapi-mcp Server

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

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
APOGEOAPI_KEYDeclared in the maintainer’s client configuration.Yes