# APOGEOAPI/apogeoapi-mcp [Health: Active]

**Category:** 🗺️ Location Services  
**Repository:** https://github.com/APOGEOAPI/apogeoapi-mcp  
**GitHub Stars:** 1  
**npm Downloads (last month):** 169  
**Views:** 5  
**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** — Get full data for a country by ISO2 or ISO3 code — includes name, capital, region, population, currency, live USD exchange rate, timezones, and phone code.
- **list_countries** — List all countries with pagination. Returns basic info by default — add fields=full for all data.
- **search_countries** — Search countries by name (e.g. "arg" finds Argentina). Returns paginated matches.
- **get_states** — Get all states/provinces for a country. Requires Starter plan or above.
- **get_cities** — Get all cities for a state/province by state ID. Requires Starter plan or above.
- **get_currency_rate** — Get the live USD exchange rate for a country's currency. Updated every 4 hours. Requires Starter plan or above.
- **geolocate_ip** — Geolocate an IPv4 or IPv6 address — returns country, region, city, coordinates, timezone, and EU membership. Requires Starter plan or above.
- **global_search** — Search across countries, states, and cities in a single query. Returns the best matches from all geographic entity types.

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

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