@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

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

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

Upgrade at app.apogeoapi.com/dashboard/billing.

Environment variables

License

MIT