Apogeoapi Mcp

apogeoapi/apogeoapi-mcp

Wraps ApogeoAPI's geographic database into Claude, giving you programmatic access to country metadata, administrative divisions, live FX rates, and IP geolocation. The free tier covers basic country lookups and search across 250+ countries. Paid plans unlock state and city data for 150K+ locations, 161 live currency rates updated every four hours, and IPv4/IPv6 geolocation with timezone info. Useful when you need structured geographic data during conversations without switching to a browser or writing one-off scripts. Runs via npx, so setup is just dropping your API key into Claude Desktop's config.

tools: 8
transport: STDIO
env var: 1
last updated: May 11, 2026

View on GitHub

Tools

8 tools

Public tool metadata for what this MCP can expose to an agent.

list_countriesList all countries with pagination. Returns geographic data including name, capital, region, currency, and live exchange rate.3 params

List all countries with pagination. Returns geographic data including name, capital, region, currency, and live exchange rate.

Parameters* required

fieldsstring

Detail levelone of basic · standard · full

limitnumber

Results per page (default: 50, max: 100)

pagenumber

Page number (default: 1)

get_countryGet full data for a country by ISO2 or ISO3 code — name, capital, region, population, currency, live USD exchange rate, timezones, and phone code.2 params

Get full data for a country by ISO2 or ISO3 code — name, capital, region, population, currency, live USD exchange rate, timezones, and phone code.

Parameters* required

codestring

ISO2 (e.g. AR) or ISO3 (e.g. ARG) country code

fieldsstring

Detail levelone of basic · standard · full

search_countriesSearch countries by name, ISO code, region, or currency code.1 params

Search countries by name, ISO code, region, or currency code.

Parameters* required

qstring

Search query (name, ISO code, region, currency)

get_statesGet all states or provinces for a country by ISO2 code.1 params

Get all states or provinces for a country by ISO2 code.

Parameters* required

countryCodestring

ISO2 country code (e.g. US, AR)

get_citiesGet cities for a country or specific state. Returns city name, coordinates, and timezone.4 params

Get cities for a country or specific state. Returns city name, coordinates, and timezone.

Parameters* required

countryCodestring

ISO2 country code

limitnumber

Results per page (default: 50, max: 100)

pagenumber

Page number (default: 1)

stateCodestring

State code (optional)

get_currency_rateGet the live USD exchange rate for any of 161 supported currencies.1 params

Get the live USD exchange rate for any of 161 supported currencies.

Parameters* required

currencystring

ISO 4217 currency code (e.g. EUR, ARS, BRL)

geolocate_ipGeolocate an IPv4 or IPv6 address. Returns country, region, city, timezone, and coordinates.1 params

Geolocate an IPv4 or IPv6 address. Returns country, region, city, timezone, and coordinates.

Parameters* required

ipstring

IPv4 or IPv6 address to geolocate

global_searchSearch across countries, states, and cities in a single query.2 params

Search across countries, states, and cities in a single query.

Parameters* required

limitnumber

Max results per type (default: 5)

qstring

Search query

Configuration

APOGEOAPI_KEY

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

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

Tool	Description	Plan required
`get_country`	Full country data by ISO2/ISO3 code — name, capital, region, population, currency, timezones, phone code (plus the live USD rate on Basic+)	Free
`list_countries`	Paginated list of all 250+ countries	Free
`search_countries`	Search countries by partial name	Free
`get_states`	All states/provinces for a country	Free
`get_cities`	All cities for a state by numeric state ID	Basic+
`get_currency_rate`	Live USD exchange rate for a country's currency (updated every 4 hours)	Basic+

View the full README on GitHub

Details

Repository: github.com/apogeoapi/apogeoapi-mcp
Category: Data & Analytics
Package: @apogeoapi/mcp
Transport: STDIO
Registry: MCP registry, active

Related Data & Analytics MCP servers

View all

EuroComply — EU Regulatory Complianceapp.eurocomply/complianceEU regulatory compliance data: 17 regulations, deadlines, enforcement actions. EU-hosted.0stars

Evlek — Northern Cyprus Property MCP Serverevlek/evlek-mcpLive Northern Cyprus (KKTC/TRNC) property listings and asking-price data. Read-only, 8 tools.0stars

LION - Trend Intent MCP + Marketplace Visibility Auditapp.netlify.gleaming-cassata-d41682/lion-mcpx402-paid MCP data: trend feed + visibility audit. USDC/Base. No API key. No PII.0stars

Arcadiaarcadia-finance/mcp-serverMCP server for Arcadia Finance, a platform to manage Uniswap and Aerodrome concentrated liquidity positions with built-in leverage, automated rebalancing, and y0stars

ContaBridgearceedev/contabridge-mcpConvert journals between A3, ContaPlus/Sage 50, QuickBooks, Xero and CSV; bank files to entries.0stars

HMS x402 Data Origins (RE Data Refinery + Storefront)areshms/hms-mcpRemote MCP over two HMS x402 origins: scored Ohio RE data + car-rental rates. Tokenless x402 USDC.0stars