English Français العربية

com.apogeoapi/apogeoapi-mcp

Registre officiel Autres

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

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

Variables d'environnement

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

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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

Questions fréquentes

Qu'est-ce que com.apogeoapi/apogeoapi-mcp ?

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

Comment installer com.apogeoapi/apogeoapi-mcp ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add apogeoapi-mcp -e 'APOGEOAPI_KEY=<APOGEOAPI_KEY>' -- npx -y @apogeoapi/mcp@1.0.2. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour com.apogeoapi/apogeoapi-mcp ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

com.apogeoapi/apogeoapi-mcp est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient com.apogeoapi/apogeoapi-mcp ?

Il est publié par APOGEOAPI. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.