Summary
Wraps ApogeoAPI's geographic database into Claude, giving you programmatic access to country metadata, administrative divisions, live FX rates, and IP geolocation. The free tier covers basic country lookups and search across 250+ countries. Paid plans unlock state and city data for 150K+ locations, 161 live currency rates updated every four hours, and IPv4/IPv6 geolocation with timezone info. Useful when you need structured geographic data during conversations without switching to a browser or writing one-off scripts. Runs via npx, so setup is just dropping your API key into Claude Desktop's config.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Tools
Public tool metadata for what this MCP can expose to an agent.
8 tools
list_countriesList all countries with pagination. Returns geographic data including name, capital, region, currency, and live exchange rate.3 params
List all countries with pagination. Returns geographic data including name, capital, region, currency, and live exchange rate.
Parameters* required
fieldsstringDetail levelone of
basic · standard · fulllimitnumberResults per page (default: 50, max: 100)
pagenumberPage number (default: 1)
get_countryGet full data for a country by ISO2 or ISO3 code — name, capital, region, population, currency, live USD exchange rate, timezones, and phone code.2 params
Get full data for a country by ISO2 or ISO3 code — name, capital, region, population, currency, live USD exchange rate, timezones, and phone code.
Parameters* required
codestringISO2 (e.g. AR) or ISO3 (e.g. ARG) country code
fieldsstringDetail levelone of
basic · standard · fullsearch_countriesSearch countries by name, ISO code, region, or currency code.1 params
Search countries by name, ISO code, region, or currency code.
Parameters* required
qstringSearch query (name, ISO code, region, currency)
get_statesGet all states or provinces for a country by ISO2 code.1 params
Get all states or provinces for a country by ISO2 code.
Parameters* required
countryCodestringISO2 country code (e.g. US, AR)
get_citiesGet cities for a country or specific state. Returns city name, coordinates, and timezone.4 params
Get cities for a country or specific state. Returns city name, coordinates, and timezone.
Parameters* required
countryCodestringISO2 country code
limitnumberResults per page (default: 50, max: 100)
pagenumberPage number (default: 1)
stateCodestringState code (optional)
get_currency_rateGet the live USD exchange rate for any of 161 supported currencies.1 params
Get the live USD exchange rate for any of 161 supported currencies.
Parameters* required
currencystringISO 4217 currency code (e.g. EUR, ARS, BRL)
geolocate_ipGeolocate an IPv4 or IPv6 address. Returns country, region, city, timezone, and coordinates.1 params
Geolocate an IPv4 or IPv6 address. Returns country, region, city, timezone, and coordinates.
Parameters* required
ipstringIPv4 or IPv6 address to geolocate
global_searchSearch across countries, states, and cities in a single query.2 params
Search across countries, states, and cities in a single query.
Parameters* required
limitnumberMax results per type (default: 5)
qstringSearch query
@apogeoapi/mcp
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.
What it does
This server exposes ApogeoAPI's REST endpoints as tools that AI assistants can call directly. Ask Claude "What is the current USD rate for Argentina?" or "Geolocate IP 8.8.8.8" and it will call the right tool automatically.
Available tools
| Tool | Description | Plan required |
|---|---|---|
get_country | Full country data by ISO2/ISO3 code — name, capital, region, population, currency, live USD rate, timezones, phone code | Free |
list_countries | Paginated list of all 250+ countries | Free |
search_countries | Search countries by partial name | Free |
get_states | All states/provinces for a country | Basic+ |
get_cities | All cities for a state by numeric state ID | Basic+ |
get_currency_rate | Live USD exchange rate for a country's currency (updated every 4 hours) | Basic+ |
geolocate_ip | Country, region, city, coordinates, timezone, and EU membership for any IPv4/IPv6 | Basic+ |
global_search | Search across countries, states, and cities in one query | Free |
Installation
Claude Desktop
Add the following to your 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": "apogeoapi_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}
}
Restart Claude Desktop after saving the file. The ApogeoAPI tools will appear in Claude's tool list.
Cursor
Add the same block under mcpServers in Cursor's MCP configuration file (~/.cursor/mcp.json).
Manual build
git clone https://github.com/APOGEOAPI/apogeoapi-mcp.git
cd apogeoapi-mcp
npm install
npm run build
Then reference the built file directly:
{
"mcpServers": {
"apogeoapi": {
"command": "node",
"args": ["/absolute/path/to/mcp-server/dist/index.js"],
"env": {
"APOGEOAPI_KEY": "apogeoapi_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}
}
Getting an API key
- Create a free account at app.apogeoapi.com
- Go to API Keys and generate a new key
- Paste the key into the
APOGEOAPI_KEYenvironment variable above
No credit card required for the Free plan (1,000 req/month).
Plan requirements
| Feature | Free | Basic ($19/mo) | Starter ($29/mo) | Professional ($79/mo) |
|---|---|---|---|---|
| Countries (list, search, get) | Yes | Yes | Yes | Yes |
| Global search | Yes | Yes | Yes | Yes |
| States & cities | No | Yes | Yes | Yes |
| Live currency rates | No | Yes | Yes | Yes |
| IP geolocation | No | Yes | Yes | Yes |
| Monthly requests | 1,000 | 15,000 | 100,000 | 500,000 |
Upgrade at app.apogeoapi.com/dashboard/billing.
Environment variables
| Variable | Required | Description |
|---|---|---|
APOGEOAPI_KEY | Yes | Your API key from the dashboard |
APOGEOAPI_BASE_URL | No | Override the API base URL (default: https://api.apogeoapi.com) |
License
MIT
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Configuration
APOGEOAPI_KEYAPI key from https://app.apogeoapi.com — free: 1,000 req/mo
Categories
Registryactive
Package@apogeoapi/mcp
TransportSTDIO
UpdatedMay 11, 2026
