Ipgeolocation Io MCP Server

Official MCP server for IP geolocation, IP security, abuse contacts, ASN, timezone, astronomy, and user-agent parsing.

Local serverstdio

What is the Ipgeolocation Io MCP Server?

Official MCP server for IP geolocation, IP security, abuse contacts, ASN, timezone, astronomy, and user-agent parsing.

The short version

Official MCP server for IPGeolocation.io. Includes 16 MCP tools: IP geolocation, threat/VPN/proxy detection, timezone lookups and conversions, sunrise/sunset/moon data, ASN details, abuse contacts, and user-agent parsing. Seven tools work on the free plan (1,000 credits/day). Paid plans unlock all 16 plus bulk endpoints (up to 50,000 items per call; default 1,000, configurable via IPGEOLOCATION_MCP_MAX_BULK_ITEMS).

The tools it exposes

The server publishes 14 tools. What each one is for:

  • Requirements — get_my_ip works without an API key. Everything else requires one
  • Cline — Open MCP Servers panel > Configure > Advanced MCP Settings. Add to cline_mcp_settings.json:
  • Cursor — The Cursor tool exposed by this server
  • Windsurf — The Windsurf tool exposed by this server
  • Glama — You can try the server on Glama directly. Only IPGEOLOCATION_API_KEY is required
  • lookup_ip — Use this when you need location, timezone, currency, or ASN for one IP address. On paid plans you can add include modules to pull security, abuse, or
  • bulk_lookup_ip — Takes an array of IPs or domains (up to 1,000 by default, configurable with IPGEOLOCATION_MCP_MAX_BULK_ITEMS). Supports the same include, fields, and
  • get_my_ip — Returns the public IP of the machine running the server. Free. 0 credits. No API key needed.
  • check_security — Returns threat score, VPN/proxy/Tor flags, provider names, confidence scores, bot/spam indicators, anonymity flags, and cloud-provider status
  • bulk_security_check — Batch version of check_security. Paid. 2 credits per IP.
  • get_timezone — Current time and timezone details for a location. Free and paid. 1 credit.
  • convert_timezone — Converts a time between two locations. Free and paid. 1 credit.

What it needs from you

  • Node.js 22 or later - npx available in your terminal - An IPGeolocation.io API key for most tools get_my_ip works without an API key. Everything else requires one. Sign up for a free IPGeolocation API key

Recorded tools

  • lookup_ip — Use this when you need location, timezone, currency, or ASN for one IP address. On paid plans you can add include modules to pull security, abuse, or hostname data in the same call, which avoids extra requests.
  • bulk_lookup_ip — Takes an array of IPs or domains (up to 1,000 by default, configurable with IPGEOLOCATION_MCP_MAX_BULK_ITEMS). Supports the same include, fields, and excludes options as lookup_ip.
  • get_my_ip — Returns the public IP of the machine running the server. Free. 0 credits. No API key needed.
  • check_security — Returns threat score, VPN/proxy/Tor flags, provider names, confidence scores, bot/spam indicators, anonymity flags, and cloud-provider status.
  • bulk_security_check — Batch version of check_security. Paid. 2 credits per IP.
  • get_timezone — Current time and timezone details for a location. Free and paid. 1 credit.
  • convert_timezone — Converts a time between two locations. Free and paid. 1 credit.
  • get_astronomy — Sun and moon data for one location on one date. Free and paid. 1 credit.
  • get_astronomy_time_series — Astronomy data for a date range, up to 90 days. Free and paid. 1 credit per request.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
lookup_ip
get_my_ip
lookup_currency
get_timezone
convert_timezone
get_astronomy
get_astronomy_time_series
bulk_lookup_ip
check_security
bulk_security_check
lookup_company
lookup_network
parse_user_agent
bulk_parse_user_agent
lookup_asn
get_abuse_contact
CombinationTotal credits
ipNo
langNo
includeNo
fieldsNo
excludesNo
force_refreshNo
ipsYes
tzNo
locationNo
iata_codeNo
icao_codeNo
lo_codeNo
timeNo
dateNo
elevationNo
time_zoneNo
dateStartYes
dateEndYes
uaStringYes
uaStringsYes
asnNo

How to install the Ipgeolocation Io MCP Server

{
  "mcpServers": {
    "ipgeolocation": {
      "command": "npx",
      "args": [
        "-y",
        "ipgeolocation-io-mcp"
      ],
      "env": {
        "IPGEOLOCATION_API_KEY": "YOUR_IPGEOLOCATION_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Node.js 22 or later - npx available in your terminal - An IPGeolocation.io API key for most tools get_my_ip works without an API key. Everything else requires one. Sign up for a free IPGeolocation API key
VariableDescriptionRequired
IPGEOLOCATION_API_KEYDeclared in the maintainer’s client configuration.Yes

Example prompts to try

  • “Use Ipgeolocation Io MCP to Requirements.”
  • “Use Ipgeolocation Io MCP to Cline.”
  • “Use Ipgeolocation Io MCP to Cursor.”

Frequently asked questions

Official MCP server for IP geolocation, IP security, abuse contacts, ASN, timezone, astronomy, and user-agent parsing. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.