# APOGEOAPI/apogeoapi-mcp [Health: Active]

**Category:** 🗺️ Location Services  
**Repository:** https://github.com/APOGEOAPI/apogeoapi-mcp  
**GitHub Stars:** 1  
**npm Downloads (last month):** 320  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/apogeoapi-apogeoapi-mcp

## Description
Geographic data and live exchange rates: 250+ countries, 5K+ states, 150K+ cities, IP geolocation, and 161 currency rates in one MCP server. Requires APOGEOAPIKEY.

## Tools
Capabilities this server exposes over MCP:

- **get_country** — Full country data by ISO2/ISO3 code — name, capital, region, population, currency, live USD rate, timezones, phone code
- **list_countries** — Paginated list of all 250+ countries
- **search_countries** — Search countries by partial name
- **get_states** — All states/provinces for a country
- **get_cities** — All cities for a state by numeric state ID
- **get_currency_rate** — Live USD exchange rate for a country's currency (updated every 4 hours)
- **geolocate_ip** — Country, region, city, coordinates, timezone, and EU membership for any IPv4/IPv6
- **global_search** — Search across countries, states, and cities in one query

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

**Requires environment variables:** `APOGEOAPI_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## 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.

```json
{
  "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.

_Full upstream README: https://allmcps.com/mcp/apogeoapi-apogeoapi-mcp/readme_