REST API
Plain HTTPS, JSON in, JSON out. No auth for the free /basic lookup.
GET https://api.ipfacts.com/basic/8.8.8.8
→ { "countryCode": "US", "isPublic": true,
"addressFamily": "IPv4" } api.ipfacts.com → Country, public/private, IPv4 vs IPv6, Tor exit-node, and cloud-provider classification — for any IP address. Same data behind a REST API, an MCP server (x402-paid), and a CLI.
IP or domain — paste a URL and we'll strip it down. Pre-filled with the IP we see for your request.
Plain HTTPS, JSON in, JSON out. No auth for the free /basic lookup.
GET https://api.ipfacts.com/basic/8.8.8.8
→ { "countryCode": "US", "isPublic": true,
"addressFamily": "IPv4" } api.ipfacts.com →
Two tools for AI agents — ip_facts_basic (free) and
ip_facts_full (paid per-call). Drop into any MCP-capable
client.
mcp connect https://mcp.ipfacts.com
→ tools: ip_facts_basic, ip_facts_full mcp.ipfacts.com →
The enriched ip_facts_full tool charges per-call via the
x402 protocol
— pay only for the calls you make, no subscription.
HTTP 402 Payment Required
→ client signs & retries
→ result + receipt How it works →
Building something that needs IP classification? The free tier covers
/basic — read the Learn page for the enriched
/full shape, Tor detection, and Azure + AWS cloud classification.