@apogeoapi/mcp

@apogeoapi/mcp

Geographic data MCP server for ApogeoAPI — 250 countries, states, cities, live currency rates, and IP geolocation. Works with Claude Desktop, Cursor, and any MCP-compatible client.

No SDK required. Install with npx, configure once, done.

What your agent can do

• Country profiles — ISO codes, capital, currency, timezones, population, GDP, flag, translations in 18 languages, postal code regex
• States & provinces — ISO 3166-2 codes, coordinates, timezone per state
• Cities — 150,000+ cities with coordinates
• IP geolocation — IPv4/IPv6 → country, region, city, coordinates, timezone, EU membership
• Live currency rates — USD exchange rates for 161 currencies, refreshed every 4 hours
• Global search — search across countries, states, and cities in one call

Quickstart

Claude Desktop

Add to claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Restart Claude Desktop. The ApogeoAPI tools will appear automatically.

Cursor

Add the same block to ~/.cursor/mcp.json under mcpServers.

Get an API key

• Create a free account at apogeoapi.com — no credit card required
• Go to API Keys and generate a key
• Paste it as APOGEOAPI_KEY

Example

You ask Claude:

What timezone does Japan use and what does a Japanese postal code look like?

Claude calls get_country({ code: "JP" }) and responds:

Japan uses a single timezone: JST (Japan Standard Time), UTC+09:00. Japanese postal codes follow the format NNN-NNNN — three digits, a hyphen, then four digits. Example: 100-0001.

The full response includes: capital, currency (JPY / ¥), GDP, population, flag URL, 47 states, translations in 18 languages (ja, zh-CN, ar, de, es, fr, ru...), and more.

Available tools

Tool	Description	Plan
get_country	Full country profile: currency, timezones, translations (18 languages), GDP, population, postal regex, flag	Free
list_countries	All 250 countries, paginated — basic / standard / full detail	Free
search_countries	Search by partial name, paginated	Free
get_states	States/provinces with ISO 3166-2 codes, timezone, coordinates	Free
get_cities	Cities within a state (150,000+ total)	Basic
geolocate_ip	IPv4/IPv6 → country, region, city, coords, timezone, EU membership	Basic
get_currency_rate	Live exchange rate vs USD, refreshed every 4 hours	Basic
global_search	Unified search across countries, states, and cities	Basic

Plans

Plan	Price	Requests/month	Unlocks
Free	$0	1,000	get_country, list_countries, search_countries, get_states
Basic	$19/mo	15,000	+ cities, IP geo, currency rates, global search
Starter	$29/mo	100,000	+ webhooks
Professional	$79/mo	500,000	+ priority support, 5 team members, 99.5% SLA

Manage plans at app.apogeoapi.com/dashboard/billing.

Environment variables

Variable	Required	Description
APOGEOAPI_KEY	Yes	API key from the dashboard
APOGEOAPI_BASE_URL	No	Override base URL (default: https://api.apogeoapi.com)

License

MIT