Apogeoapi Mcp

com.apogeoapiPublished by apogeoapi.comv1.0.2Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyLocation & LifestyleFinance

Overview

AI-generated overview

Local MCP server exposing ApogeoAPI geographic data: country, state and city lookups, IP geolocation and live USD exchange rates.

What you can do
  • Look up and list countries by ISO code or partial name, including capital, region, population, currency and timezones
  • Retrieve states and provinces for a country, and cities for a state
  • Search across countries, states and cities in a single query
  • Get the live USD exchange rate for a country's currency, refreshed every four hours
  • Geolocate an IPv4 or IPv6 address to country, region, city, coordinates and timezone
When to use it
Useful when an assistant needs reference geography or currency data while answering questions, for example resolving a country code, listing cities in a region, or looking up an IP address's location. Worth adding if you already use or plan to subscribe to ApogeoAPI.
Requirements
Runs locally via npx from the npm package @apogeoapi/mcp, or from a manual build with Node.js. Requires an ApogeoAPI account and an API key supplied in the APOGEOAPI_KEY environment variable; an optional APOGEOAPI_BASE_URL overrides the API endpoint. Network access to the ApogeoAPI service is needed.
Before you install
The API key in APOGEOAPI_KEY is a billable credential and should be kept out of shared configs. Several tools (cities, global search, currency rates, IP geolocation) need a paid Basic plan or higher after the 14-day trial; plans run from $19 to $79 per month with request quotas. Queries, including IP addresses, are sent to ApogeoAPI's servers. All tools are read-only.

Installation

In SourceWeft

  1. Open Apogeoapi Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

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
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

bash
git clone https://github.com/APOGEOAPI/apogeoapi-mcp.git
cd apogeoapi-mcp
npm install
npm run build

Then reference the built file directly:

json
{
  "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):

bash
APOGEOAPI_KEY=your_key npm test

License

MIT

Source: README.md at commit b897f20

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts