# apogeoapi-mcp

Give an AI agent tools for country and city data, currency rates, and IP geolocation. The server needs an ApogeoAPI key to access the API.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: APOGEOAPI
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/APOGEOAPI/apogeoapi-mcp
- Updated: 2026-10-01
- HTML: https://affpapa.org/en/nevibecode/mcp/apogeoapi-mcp

## What it does

apogeoapi-mcp connects ApogeoAPI tools to an AI agent. The tools retrieve country, state, and city information, look up places, check currency rates, and locate IPv4 or IPv6 addresses. An agent can, for instance, identify a country from its code or return location details for an IP.

The tools are read-only. Claude Code can launch the server with `npx`, while the API key is passed through `APOGEOAPI_KEY`. The server cannot access the API without that key. Country and state data are available on the Free plan; city data, global search, rates, and IP geolocation require Basic+ or trial access.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `APOGEOAPI_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env APOGEOAPI_KEY=<APOGEOAPI_KEY> --transport stdio apogeoapi-mcp -- npx -y @apogeoapi/mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add apogeoapi-mcp --env APOGEOAPI_KEY=<APOGEOAPI_KEY> -- npx -y @apogeoapi/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "apogeoapi-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@apogeoapi/mcp"
            ],
            "env": {
                "APOGEOAPI_KEY": "<APOGEOAPI_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "apogeoapi-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@apogeoapi/mcp"
            ],
            "env": {
                "APOGEOAPI_KEY": "<APOGEOAPI_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e APOGEOAPI_KEY=<APOGEOAPI_KEY> apogeoapi-mcp npx -y @apogeoapi/mcp
```
Replace <…> with your own values

## When to use it
- look up a country using its ISO2 or ISO3 code
- retrieve a country's states or provinces
- check the current USD rate for a country's currency
- locate an IP address by country and region

## Example prompts
- Find the country for this ISO2 code and return its capital and currency.
- Look up the country, region, and timezone for IP address 8.8.8.8.
- Check the current USD rate for Argentina's currency.

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16730
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40459
- [OpenWork MCP Gateway](https://affpapa.org/en/nevibecode/mcp/openwork-mcp-gateway.md) — MCP server · ★ 24271
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18779
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9369
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/en/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP server · ★ 7548

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md