ApogeoAPI
About
Geographic data for AI agents — 250+ countries, states, cities, IP geolocation, and live exchange rates (161 currencies) updated every 4 hours.
Details
- Author
- APOGEOAPI
- Downloads
- 292
- Categories
- Cloud Service, Other, API
Jump to
- Country data by ISO2/ISO3 code
- Paginated list of 250+ countries
-
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
ApogeoAPICommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install the package via npx -y @apogeoapi/mcp and configure it in your MCP client’s JSON config file (e.g., claude_desktop_config.json). Set the APOGEOAPI_KEY environment variable with your API key. After the client restarts, the tools appear automatically.
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 / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"apogeoapi": {
"apogeoapi": {
"command": "npx",
"args": [
"-y",
"@apogeoapi/mcp"
],
"env": {
"APOGEOAPI_KEY": "<YOUR_API_KEY>"
}
}
}
}
}McpServers
{
"apogeoapi": {
"command": "npx",
"args": [
"-y",
"@apogeoapi/mcp"
],
"env": {
"APOGEOAPI_KEY": "<YOUR_API_KEY>"
}
}
}@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 yourclaude_desktop_config.json:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
``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
`bash
git clone https://github.com/APOGEOAPI/apogeoapi-mcp.git
cd apogeoapi-mcp
npm install
npm run build
`
Then reference the built file directly:
`json
{
"mcpServers": {
"apogeoapi": {
"command": "node",
"args": ["/absolute/path/to/mcp-server/dist/index.js"],
"env": {
"APOGEOAPI_KEY": "apogeoapi_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}
}
`
Getting an API key
1. Create a free account at app.apogeoapi.com
2. Go to API Keys and generate a new key
3. Paste the key into the APOGEOAPI_KEY environment 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
MITSign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
