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.
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Give your AI agent a complete email layer—sending, inbound inboxes, and sandbox testing.
Get 4K emails/month free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
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.003 | Geolocate a single IP address |
ip_lookup_geolocation_batch | POST | /api/lookup/batch | $0.01 | 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
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Give your AI agent a complete email layer—sending, inbound inboxes, and sandbox testing.
Get 4K emails/month free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →