Server data from the Official MCP Registry
Geographic data API: 250+ countries, 150K+ cities, IP geolocation, 161 live FX rates.
About
Geographic data API: 250+ countries, 150K+ cities, IP geolocation, 161 live FX rates.
Security Report
This is a well-structured MCP server for ApogeoAPI with proper authentication via API keys, clean code organization, and appropriate input validation using Zod. Permissions are well-scoped to API calls only with no dangerous operations. Minor quality suggestions exist around error handling and explicit base URL validation, but no security vulnerabilities were identified. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 2 high severity). Package verification found 1 issue.
7 files analyzed · 8 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: APOGEOAPI_KEY
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"com-apogeoapi-apogeoapi-mcp": {
"env": {
"APOGEOAPI_KEY": "your-apogeoapi-key-here"
},
"args": [
"-y",
"@apogeoapi/mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
@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, timezones, phone code (plus the live USD rate on Basic+) | 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 | Free |
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 | Basic+ |
Every new account gets 14 days of full access to the Basic+ tools, no credit card required.
All tools are read-only and declare the MCP tool annotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint), so clients can run them without a confirmation prompt.
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). New accounts get 14 days of full access.
Plan requirements
| Feature | Free | Basic ($19/mo) | Starter ($29/mo) | Professional ($79/mo) |
|---|---|---|---|---|
| Countries (list, search, get) | Yes | Yes | Yes | Yes |
| States & provinces | Yes | Yes | Yes | Yes |
| Cities | 14-day trial | Yes | Yes | Yes |
| Global search | 14-day trial | Yes | Yes | Yes |
| Live currency rates | 14-day trial | Yes | Yes | Yes |
| IP geolocation | 14-day trial | 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) |
Tests
npm test builds the server, starts it over stdio with a real MCP client and calls every tool against the live API. It needs a key with access to every tool (Basic+ or an account in its 14-day trial):
APOGEOAPI_KEY=your_key npm test
License
MIT
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Rea
Freeby Morluto · Developer Tools
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Paperclip
Freeby Paperclipai · Developer Tools
Trending hip-hop artist momentum scores across four cultural dimensions.
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.