Skip to main content
MCP server CX Codex

IP Geolocation — Claude Code MCP server: setup and tools

IP Geolocation — Country, City, ISP, VPN Detection is an MCP server for Claude Code that checks IP location, ISP, and VPN status for access control and traffic inspection.

no license 4,543 installs updated 2026-04-12

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http ip-geolocation https://ip-geolocation--axel-belfort.run.tools
Open on GitHub

What IP Geolocation — Country, City, ISP, VPN Detection does

This remote server exposes endpoints to inspect IPv4 and IPv6 network records. Query responses yield structured JSON containing coordinates, country code, city, administrative region, timezone, ASN, service provider, alongside flags indicating Tor, proxy, or VPN infrastructure.

Two specific operations are exposed: ip_lookup_geolocation handles single lookups, whereas ip_lookup_geolocation_batch takes multiple targets up to an upper bound of 20 items per request. It does not inspect domain-level metadata; the author suggests domain_lookup_intelligence for hostnames.

You do not configure standard API keys. Instead, transactions rely on x402 micropayments priced at $0.003 per execution on Base L2.

What it helps with

  • inspect IPv4 or IPv6 records for country, city, and coordinates
  • detect incoming traffic routed through VPNs, proxies, or Tor exit nodes
  • process up to 20 client IPs simultaneously to enrich logs
  • identify ASN details and ISPs behind suspicious connections

Example prompts for the agent

  • Call ip_lookup_geolocation on IP 198.51.100.42 to check for active proxy or VPN flags
  • Retrieve the timezone, city, and ISP for the IPv6 address 2001:db8::1
  • Pass the IP list from access.log to ip_lookup_geolocation_batch

How to install IP Geolocation — Country, City, ISP, VPN Detection

Platform CLI: remote server

claude mcp add --transport http ip-geolocation https://ip-geolocation--axel-belfort.run.tools

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about IP Geolocation — Country, City, ISP, VPN Detection

How to install IP Geolocation in Claude Code?

Run claude mcp add --transport http ip-geolocation https://ip-geolocation--axel-belfort.run.tools in your CLI.

What does IP Geolocation do?

It resolves IP addresses into geographical points, ASN records, and detects proxy or VPN usage individually or in batches up to 20.

Do I need an account key to run lookups?

No API key is required. The endpoint charges $0.003 per call via x402 micropayments settled on Base L2.

Similar MCP servers

All MCP servers for Security →

Project sponsors

Companies that keep this analytics open