Claude MarketplacesSubmit
br0ski777 avatar

IP Geolocation API

br0ski777/ip-geolocation-x402

Connects Claude to an IP geolocation API that returns city-level location data, ISP information, ASN details, and flags for VPN, proxy, or Tor exit nodes. Runs as a remote MCP server over SSE and uses x402 USDC micropayments to meter API calls. The source repo is minimal with workflow configs and package files but light on implementation details. Reach for this when you need Claude to geolocate IPs during security analysis, fraud detection, or network diagnostics without managing your own geolocation database. The micropayment model means you pay per lookup rather than subscribing to a full geolocation service.

tools
2
transport
SSE
last updated
May 16, 2026
View on GitHub

Tools

2 tools

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

ip_lookup_geolocationUse this when you need to geolocate an IP address. Returns full location and network data in JSON. Returns: 1. country and countryCode 2. region and city 3. latitude and longitude 4. timezone 5. ISP1 params

Use this when you need to geolocate an IP address. Returns full location and network data in JSON. Returns: 1. country and countryCode 2. region and city 3. latitude and longitude 4. timezone 5. ISP

Parameters* required
ipstring
IP address to lookup (e.g. 8.8.8.8)
ip_lookup_geolocation_batchUse this when you need to geolocate multiple IP addresses at once (up to 20). Returns an array of geolocation results in JSON. Returns per IP: 1. country, region, city 2. latitude, longitude 3. timez1 params

Use this when you need to geolocate multiple IP addresses at once (up to 20). Returns an array of geolocation results in JSON. Returns per IP: 1. country, region, city 2. latitude, longitude 3. timez

Parameters* required
ipsarray
Array of IP addresses to lookup (max 20)

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Readme

IP Geolocation API

MCP Server x402 License: MIT

Geolocate any IP address -- country, city, ISP, ASN, VPN/proxy/Tor detection. IPv4 and IPv6 support. Pay-per-call via x402 (USDC on Base L2) -- no API key, no signup, no rate-limit wall.

Part of the klymax402 marketplace -- 100 x402 micropayment APIs for AI agents, one wallet, USDC on Base.

Quickstart -- MCP

Add to your MCP client config (Claude Desktop, Cursor, ElizaOS, etc.):

{
  "mcpServers": {
    "ip-geolocation": {
      "url": "https://ip-geolocation.api.klymax402.com/mcp"
    }
  }
}

Quickstart -- HTTP (x402)

curl "https://ip-geolocation.api.klymax402.com/api/lookup?ip=..."
# -> 402 Payment Required, with an x402 payment challenge in the response body

View the full README on GitHub

Details

Repository
github.com/br0ski777/ip-geolocation-x402
Website
github.com/Br0ski777/ip-geolocation-x402
Transport
SSE
Registry
MCP registry, active

More from br0ski777