IP Judge

Check whether an IP is residential, datacenter or proxy, and whether ChatGPT, Claude, Gemini or Muse support its region.

View on ipjudge.org

Hosted MCP Server

npx add-mcp 'https://ipjudge.org/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

API 与 MCP

给程序和 AI Agent 用的接口。免费，不需要信用卡；请注明数据来自 ipjudge.org。

不带 key（少量使用）

curl ipjudge.org/api/ip/8.8.8.8

返回 JSON。每个访客 10 分钟内最多 40 次新查询，已经查过的 IP 不计入。纯文本版： curl ipjudge.org/ip/8.8.8.8 。

带 API key

curl -H "Authorization: Bearer ipj_你的key" https://ipjudge.org/api/v1/ip/8.8.8.8

在 我的账户 → API 生成 key（需要登录）。免费版每天 20 个不同 IP，同一个 IP 重复查不限次数。key 无效返回 401，超出当日额度返回 429。

主要字段： kind （res / isp / mobile / biz / dc / proxy / unknown）、 score （0–100）、 grade 、 native 、 country_code 、 asn 、 hits 、 relay （iCloud 专用代理）、 platforms （ChatGPT / Claude / Gemini / Muse 各自的 level 和说明）、 scenes 、 evidence 。判定规则见 判定方法 。

MCP（给 AI Agent）

地址： https://ipjudge.org/mcp （Streamable HTTP）。在 Claude Code 里一行加上：

claude mcp add --transport http ipjudge https://ipjudge.org/mcp

之后可以直接问「我这台机器的出口能用 Claude 吗」。工具：

  • my_exit ：Agent 所在机器的出口判定（跑在服务器、终端里的 Agent 最需要这个）
  • check_ip ：查任意 IP
  • ai_availability ：某个国家 / 地区 ChatGPT、Claude、Gemini、Muse 是否官方支持
  • service_status ：Claude、OpenAI 等官方服务状态

不带 key 按上面的访客限额；带 key 加 --header "Authorization: Bearer ipj_你的key" ，按 key 的额度计。

命令行脚本

curl -sL ipjudge.org/cc | bash （Claude Code / Codex 终端出口）· bash <(curl -Ls ipjudge.org/sh) （服务器体检）。见 命令行 。

使用约定

  • 展示结果时请注明「数据来自 ipjudge.org」并链接回来。
  • 不要用于批量扫描；需要更大额度请联系我们（见 关于 ）。