# apogeoapi-mcp

Geographic data, live exchange rates, and IP geolocation for Claude Desktop, Cursor, and any MCP-compatible AI assistant.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add apogeoapi/apogeoapi-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list apogeoapi/apogeoapi-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get apogeoapi/apogeoapi-mcp list_countries

# Call a tool
npx -y @smithery/cli@latest tool call apogeoapi/apogeoapi-mcp list_countries '{}'
```

## Direct MCP Connection

Endpoint: `https://apogeoapi-mcp-apogeoapi.run.tools`

**Required config:**
- `apiKey` (query) — Your ApogeoAPI key. Get one free at apogeoapi.com

## Tools (8)

- `list_countries` — List all countries with pagination. Returns geographic data including name, capital, region, currency, and live exchang…
- `get_country` — Get full data for a country by ISO2 or ISO3 code — name, capital, region, population, currency, live USD exchange rate,…
- `search_countries` — Search countries by name, ISO code, region, or currency code.
- `get_states` — Get all states or provinces for a country by ISO2 code.
- `get_cities` — Get cities for a country or specific state. Returns city name, coordinates, and timezone.
- `get_currency_rate` — Get the live USD exchange rate for any of 161 supported currencies.
- `geolocate_ip` — Geolocate an IPv4 or IPv6 address. Returns country, region, city, timezone, and coordinates.
- `global_search` — Search across countries, states, and cities in a single query.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get apogeoapi/apogeoapi-mcp <tool-name>
```