English Français العربية

com.apogeoapi/apogeoapi-mcp

Official registry Other

Geographic data API: 250+ countries, 150K+ cities, IP geolocation, 161 live FX rates.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @apogeoapi/mcp
Claude Code 
claude mcp add apogeoapi-mcp -e 'APOGEOAPI_KEY=<APOGEOAPI_KEY>' -- npx -y @apogeoapi/mcp@1.0.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "apogeoapi-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@apogeoapi/mcp@1.0.2"
            ],
            "env": {
                "APOGEOAPI_KEY": "<APOGEOAPI_KEY>"
            }
        }
    }
}

Environment variables

  • APOGEOAPI_KEY API key from https://app.apogeoapi.com — free: 1,000 req/mo

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. @apogeoapi/mcp
  2. What it does
  3. Available tools
  4. Installation
  5. Getting an API key
  6. Plan requirements
  7. Environment variables
  8. Tests
  9. License

@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

ToolDescriptionPlan required
get_countryFull country data by ISO2/ISO3 code — name, capital, region, population, currency, timezones, phone code (plus the live USD rate on Basic+)Free
list_countriesPaginated list of all 250+ countriesFree
search_countriesSearch countries by partial nameFree
get_statesAll states/provinces for a countryFree
get_citiesAll cities for a state by numeric state IDBasic+
get_currency_rateLive USD exchange rate for a country's currency (updated every 4 hours)Basic+
geolocate_ipCountry, region, city, coordinates, timezone, and EU membership for any IPv4/IPv6Basic+
global_searchSearch across countries, states, and cities in one queryBasic+

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

  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). New accounts get 14 days of full access.

Plan requirements

FeatureFreeBasic ($19/mo)Starter ($29/mo)Professional ($79/mo)
Countries (list, search, get)YesYesYesYes
States & provincesYesYesYesYes
Cities14-day trialYesYesYes
Global search14-day trialYesYesYes
Live currency rates14-day trialYesYesYes
IP geolocation14-day trialYesYesYes
Monthly requests1,00015,000100,000500,000

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

Environment variables

VariableRequiredDescription
APOGEOAPI_KEYYesYour API key from the dashboard
APOGEOAPI_BASE_URLNoOverride 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

Frequently asked questions

What is com.apogeoapi/apogeoapi-mcp?

Geographic data API: 250+ countries, 150K+ cities, IP geolocation, 161 live FX rates.

How do I install com.apogeoapi/apogeoapi-mcp?

It runs on your machine. In Claude Code: claude mcp add apogeoapi-mcp -e 'APOGEOAPI_KEY=<APOGEOAPI_KEY>' -- npx -y @apogeoapi/mcp@1.0.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does com.apogeoapi/apogeoapi-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is com.apogeoapi/apogeoapi-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains com.apogeoapi/apogeoapi-mcp?

It is published by APOGEOAPI. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.