关于 mcp-whoisxmlapi
mcp-whoisxmlapi 是面向安全分析人员和 AI Agent 的 WhoisXML API 官方服务,提供域名、DNS、IP、威胁情报、邮件及批量查询工具,并支持连接托管端点或本地运行。
主要功能
- 01WHOIS 与域名历史查询
- 02DNS 和基础设施查询
- 03IP 地理位置与风险检测
- 04威胁及品牌监控
- 05邮件验证
- 06批量查询与任务结果
适用场景
- 01调查可疑域名
- 02梳理域名与 IP 基础设施
- 03监控品牌仿冒
- 04验证邮件列表
MCP 相关
向 MCP 客户端提供 34 个 WhoisXML API 工具。客户端可连接托管端点,也可使用 API 密钥在本地运行。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp-hosted.whoisxmlapi.com/mcpclaude mcp add --transport http whois-api-llc-mcp-whoisxmlapi https://mcp-hosted.whoisxmlapi.com/mcp{"mcpServers":{"whois-api-llc-mcp-whoisxmlapi":{"type":"http","url":"https://mcp-hosted.whoisxmlapi.com/mcp"}}}在 Cursor 中打开{"servers":{"whois-api-llc-mcp-whoisxmlapi":{"type":"http","url":"https://mcp-hosted.whoisxmlapi.com/mcp"}}}在 VS Code 中打开{"mcpServers":{"whois-api-llc-mcp-whoisxmlapi":{"type":"http","url":"https://mcp-hosted.whoisxmlapi.com/mcp"}}}{"mcpServers":{"whois-api-llc-mcp-whoisxmlapi":{"serverUrl":"https://mcp-hosted.whoisxmlapi.com/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
32| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| date | string | 否 | 要查询的日期,格式为 YYYY-MM-DD。省略时,上游 API 将使用其默认值(通常为昨天)。 |
| mode | enum | 是 | 'preview' 仅返回计数(不消耗额度)。'purchase' 返回完整域名列表。preview | purchase |
| punycode | boolean | 否 | 如果为 true,则将域名编码为 Punycode。 |
| with_typos | boolean | 否 | 如果为 true,则包含品牌词的拼写变体(字母换位、形近字符、缺失字符等)。 |
| excluded_search_terms | string | 否 | 要排除的逗号分隔词语。最多 4 项。 |
| included_search_terms | string | 是 | 要包含的逗号分隔品牌词(AND 逻辑)。最多 4 项。不区分大小写。支持通配符 *。 |
详细介绍
WhoisXML API MCP 服务
WhoisXML API 的官方 WhoisXML API MCP 服务:提供 34 个第一方工具,涵盖 WHOIS、DNS、IP 地理定位、威胁情报、域名拼写仿冒、电子邮件验证和原生批量查询,可在 Claude、Cursor、VS Code、LobeChat 或任何 MCP 客户端中使用。
- 文档: https://mcp.whoisxmlapi.com
- npm 包:
@whoisxmlapidotcom/mcp-whoisxmlapi - Docker 镜像:
whoisxmlapidotcom/mcp-whoisxmlapi - MCP 注册表:
io.github.whois-api-llc/mcp-whoisxmlapi
此仓库是该服务的公开展示主页。服务通过托管端点、npm 和 Docker Hub 分发;实现源码由 Whois API, Inc. 私下维护。
托管端点(无需安装)
将任何支持远程连接的 MCP 客户端连接到托管服务——通过 OAuth 和你的 WhoisXML API 密钥进行身份验证:
https://mcp-hosted.whoisxmlapi.com/mcp
{
"mcpServers": {
"whoisxmlapi": {
"url": "https://mcp-hosted.whoisxmlapi.com/mcp"
}
}
}
本地运行
需要 WhoisXML API 密钥——可在 https://whoisxmlapi.com 获取。
npm:
{
"mcpServers": {
"whoisxmlapi": {
"command": "npx",
"args": ["-y", "@whoisxmlapidotcom/mcp-whoisxmlapi"],
"env": { "WHOISXMLAPI_TOKEN": "at_YOUR_KEY" }
}
}
}
Docker:
docker run -i --rm -e WHOISXMLAPI_TOKEN=at_YOUR_KEY whoisxmlapidotcom/mcp-whoisxmlapi
工具(34 个)
域名情报
| 工具 | 功能 |
|---|---|
whois | 域名当前 WHOIS/RDAP 注册数据——注册商、日期、名称服务器、状态和联系人。 |
whois_history | WHOIS 变更的完整时间线——所有权转移、注册商变更、名称服务器更换。 |
domain_info | 汇总当前和历史记录的增强型 WHOIS 档案,用于补全已隐藏的字段。 |
reverse_whois | 查找 WHOIS 记录中包含任意自由文本词条(姓名、电子邮件、组织、地址)的所有域名。 |
reverse_whois_advanced | 按特定字段搜索 WHOIS(例如 RegistrantContact.Organization),最多 4 个词条。 |
domain_reputation | 根据实时基础设施和配置检查提供 0–100 的信任评分。 |
typosquatting | 检查域名是否属于域名拼写仿冒群组,或展开查看完整群组。 |
categorization | 将域名归入 IAB Content Taxonomy v3.1 分类。 |
DNS 和基础设施
| 工具 | 功能 |
|---|---|
dns_lookup | 查询当前 DNS 记录——A、AAAA、MX、NS、SOA、TXT、CNAME、PTR、SRV、CAA、DS、DNSKEY,或全部记录。 |
dns_history | 查询历史 DNS 记录(正向),或查询历史上使用某个 IP 的域名(反向)。 |
reverse_dns | 按模式搜索 DNS 记录并返回匹配的域名。 |
reverse_ip | 查询当前指向某个 IP 的所有域名,并提供首次/最近发现日期。 |
reverse_mx | 查询使用特定 MX 服务器的所有域名。 |
reverse_ns | 查询委派给特定名称服务器的所有域名。 |
subdomain_lookup | 枚举域名的已知子域名及其发现时间戳;支持分页,突破每次请求 10,000 条的上限。 |
domain_and_subdomain_discovery | 查询包含搜索词的任意时期域名/子域名(支持通配符;since 可按首次发现日期筛选)。 |
ssl_certificates | TLS 证书详情——颁发者、有效期、SAN、证书链信任。 |
IP 情报
| 工具 | 功能 |
|---|---|
ipgeolocation | 查询 IP、域名或电子邮件的国家/地区、区域、城市、ISP 和 ASN。 |
ip_netblocks | 查询 IP/ASN/组织对应的 CIDR 范围、ASN、组织和注册日期。 |
vpn_proxy_detection | 判断某个 IP 是否为已知 VPN、代理、Tor 出口节点、中继、托管或 CDN 地址,并提供 0–100 的风险评分。 |
威胁与品牌保护
| 工具 | 功能 |
|---|---|
threat_intelligence | 根据恶意软件/网络钓鱼/垃圾邮件/僵尸网络数据源检查域名、URL、IP、CIDR 或文件哈希。 |
brand_alert | 监控新添加/删除/更新且包含品牌词的域名——域名拼写仿冒和相似域名监控。 |
registrant_alert | 查找 WHOIS 注册人字段与搜索词匹配的新域名/变更域名。 |
电子邮件
| 工具 | 功能 |
|---|---|
email_verification | 检查语法、MX 和 SMTP 可送达性;标记一次性、角色、免费和全收件地址。 |
disposable_email_check | 判断电子邮件提供商是否为一次性或临时服务。 |
屏幕截图
| 工具 | 功能 |
|---|---|
website_screenshot | 截取网页,并以原生图像内容块的形式返回。 |
原生批量处理
| 工具 | 功能 |
|---|---|
bulk_whois | 一次调用最多查询 10,000 个域名的 WHOIS(原生批量处理;长时间运行时异步返回 job_id)。 |
bulk_email_verification | 验证最多 10,000 个电子邮件地址(原生批量处理;长时间运行时异步执行)。 |
bulk_vpn_proxy_detection | 一次调用最多检测 100 个 IP 的 VPN 和代理(原生批处理,始终以内联方式返回;适用于 Starter 计划及更高级别)。 |
bulk_dns_lookup | 查询最多 200 个域名的 DNS,并发执行请求。 |
bulk_ip_geolocation | 查询最多 200 个 IP 的地理位置,并发执行请求。 |
bulk_subdomain_lookup | 发现最多 200 个主域名的子域名。 |
bulk_job_status | 查看正在运行的批量任务的进度。 |
bulk_job_results | 查看已完成批量任务中每个输入项的完整结果。 |
示例提示词
- “查询 suspicious-domain.com 的 WHOIS,并告诉我它是否可疑。”
- “查找 example.com 的所有子域名,并检查它们的 DNS 历史记录。”
- “检查 203.0.113.7 的威胁情报信誉,以及托管在该 IP 上的内容。”
© Whois API, Inc. · https://www.whoisxmlapi.com · 支持:https://whoisxmlapi.com/contact-us
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。