IPIPAI — Complete Technical Documentation

1. Platform Overview

IPIPAI (ipipai.com) is a free online platform for IP address detection, network diagnostics, streaming unlock testing, and cybersecurity self-audit. All tools are free, require no registration for basic use, and are accessible via both a web UI and machine-readable JSON APIs.

What IPIPAI does

• IP Detection & Geolocation — country, region, city, ISP, ASN, coordinates, timezone, IP type (residential / datacenter / mobile / VPN / proxy / Tor), risk score, blocklist status.
• Streaming Unlock Test — check which services (Netflix, Disney+, ChatGPT, YouTube Premium, HBO Max, Bilibili, etc.) are reachable from a given IP or proxy node. Supports vmess://, vless://, ss://, trojan:// protocols.
• Network Diagnostics — Ping, Traceroute, MTR, multi-location global latency test, DNS resolve.
• Speed Test — Download and upload bandwidth measurement with server selection.
• Security Self-Audit — 130-item cybersecurity checklist, browser fingerprint check, WebRTC leak detection, IP leak detection.
• Whois / MAC / IMEI Lookup — Domain and IP WHOIS, MAC vendor OUI database, phone IMEI check.

2. Architecture & Data Flow

IPIPAI uses a three-layer architecture separating AI model access, programmer API access, and internal data backends:

Key design principles:

• AI models connect via the MCP server (JSON-RPC 2.0 over HTTP).
• Programmers call the REST API directly (HTTP GET/POST).
• The MCP server translates tool calls into internal REST API requests — it is a protocol translator, not a separate data source.
• All responses are JSON. No cookies, no sessions, no persistent query storage.

3. Online Tools (13+)

All tools are available at ipipai.com without registration. Each tool page has a localized Chinese version (-zh.html suffix).

4. MCP Server — Open Source

IPIPAI runs a production Model Context Protocol (MCP) server. AI models (Claude, ChatGPT, Gemini, Cursor, Cline) connect via JSON-RPC 2.0 and discover tools dynamically. The server is open source under MIT License.

Endpoints

16 Tools (mcp.ipipai.com)

Quick Connect (AI Client Config)

{
  "mcpServers": {
    "ipipai-mcp": {
      "url": "https://mcp.ipipai.com/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer <YOUR_AUTH_TOKEN>"
      }
    }
  }
}

Get an auth token from mcp.ipipai.com homepage. For the open endpoint (ipipai.com/mcp), no token is needed:

{
  "mcpServers": {
    "ipipai-open": {
      "url": "https://ipipai.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Health Check

curl https://mcp.ipipai.com/health
# → { "status": "ok", "tools": 16, "version": "2.1.0" }

5. REST API Reference

All endpoints return JSON. No authentication required for basic use. Add ?lang=en or ?lang=zh for localized output.

Endpoints

Example: IP Detection

GET https://ipipai.com/api/detect/8.8.8.8?lang=en

# → {
#     "success": true,
#     "ip": "8.8.8.8",
#     "country": "United States",
#     "isp": "Google LLC",
#     "as": "AS32514",
#     "ipTypeCode": "DCH",
#     "isProxy": false,
#     "isHosting": true,
#     "riskScore": 12
#   }

6. Blog & Articles

IPIPAI maintains 78 bilingual articles (English + Chinese) across 6 categories. All articles are indexed in articles-manifest.json and available as standalone HTML pages.

Article Categories

Featured Articles

Article Hubs

7. AI Agent Discovery

IPIPAI publishes machine-readable discovery files so AI agents and LLMs can auto-discover available tools and data without manual configuration.

8. Security & Privacy

• HTTPS everywhere — Cloudflare edge, HTTP/3 supported, HSTS preload
• Bearer token auth — mcp.ipipai.com requires a token; ipipai.com/mcp is open
• Security response headers — X-Content-Type-Options, X-Frame-Options, Referrer-Policy, Permissions-Policy, Content-Security-Policy
• No permanent query storage — IP detection queries are not logged or stored permanently
• Rate limiting — 60 req/min free tier; 120 req/min with API key
• WAF — Cloudflare WAF rules block automated scanners and sensitive-path probes

10. Quick Links