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
claude mcp add --transport http ip-geolocation https://ip-geolocation--axel-belfort.run.toolsWhat 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_geolocationon IP198.51.100.42to 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.logtoip_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.toolsPlatform CLI: remote server
codex mcp add ip-geolocation-country-city-isp-vpn-detection --url https://ip-geolocation--axel-belfort.run.toolsConfig file
{
"mcpServers": {
"ip-geolocation-country-city-isp-vpn-detection": {
"url": "https://ip-geolocation--axel-belfort.run.tools"
}
}
}Config file
{
"servers": {
"ip-geolocation-country-city-isp-vpn-detection": {
"type": "http",
"url": "https://ip-geolocation--axel-belfort.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http ip-geolocation-country-city-isp-vpn-detection https://ip-geolocation--axel-belfort.run.toolsStep 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.