Summary
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.
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →
Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Tools
Public tool metadata for what this MCP can expose to an agent.
2 tools
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
ipstringIP 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
ipsarrayArray of IP addresses to lookup (max 20)
IP Geolocation API
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
Any x402-aware client (@x402/fetch, x402-agent-tools, ATXP) handles the 402 -> sign -> retry cycle automatically.
Tools
| Tool | Method | Path | Price | Description |
|---|---|---|---|---|
ip_lookup_geolocation | GET | /api/lookup | $0.008 | Geolocate a single IP address |
ip_lookup_geolocation_batch | POST | /api/lookup/batch | $0.02 | Geolocate up to 20 IP addresses in one call |
ip_lookup_geolocation
Use this when you need to geolocate an IP address. Returns full location and network data in JSON.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
ip | string | yes | IP address to lookup (e.g. 8.8.8.8) |
Example response:
{"ip":"8.8.8.8","country":"United States","countryCode":"US","region":"California","city":"Mountain View","latitude":37.386,"longitude":-122.084,"timezone":"America/Los_Angeles","isp":"Google LLC","asn":"AS15169","isVPN":false,"isProxy":false,"isTor":false}
When to use: fraud detection, content localization, access control by region, analytics enrichment, and bot detection.
Not for: domain data (use domain_lookup_intelligence), DNS records (use network_lookup_dns).
ip_lookup_geolocation_batch
Use this when you need to geolocate multiple IP addresses at once (up to 20). Returns an array of geolocation results in JSON.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
ips | array | yes | Array of IP addresses to lookup (max 20) |
Example response:
{"results":[{"ip":"8.8.8.8","country":"United States","city":"Mountain View","isp":"Google LLC","isVPN":false},{"ip":"1.1.1.1","country":"Australia","city":"Sydney","isp":"Cloudflare","isVPN":false}],"total":2}
When to use: bulk log analysis, batch fraud screening, and enriching analytics data with location info. More cost-effective than single lookups.
Not for: single IPs (use ip_lookup_geolocation), domain data (use domain_lookup_intelligence).
Example agent prompts
- "Geolocate an IP address"
- "Geolocate multiple IP addresses at once (up to 20)"
Payment
- Protocol: x402 -- HTTP-native pay-per-call, no signup, no API key
- Network: Base L2 (
eip155:8453) - Asset: USDC
- Facilitator: Coinbase CDP (primary), PayAI (fallback)
- Also reachable via ATXP (OAuth-wrapped x402, RFC 9728 protected-resource metadata)
Part of klymax402
100 x402 micropayment APIs for AI agents -- one wallet, USDC on Base, zero signup.
- Catalog: https://klymax402.com/llms.txt
- Full API reference: https://klymax402.com/llms-full.txt
- Live stats: https://klymax402.com/stats
License
MIT
Featured
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →