MCP · REST · OpenAPI 3.1

Domain evidence for your Agent workflow.

NamePico 提供三项只读 MCP 工具，把候选初筛、真实核价和深度证据调查拆成可控步骤。无需 API key，未知、超时和覆盖不足保留为一等状态。

Quickstart OpenAPI contract

Remote MCP endpointRead only

https://namepico.com/mcp

No API key

Stateless

Schema 1.3

兼容说明：MCP server identity 暂时保留为 domainsense；工具名称和已有字段不改名。

Quickstart

Start with the MCP endpoint.

把当前站点的 /mcp 地址添加为 Remote MCP。服务使用 Streamable HTTP、无会话状态，并通过同一个端点处理初始化、工具列表和调用。

Endpoint

https://namepico.com/mcp

支持 GET、POST、DELETE 与 CORS；无需 Authorization header。

Recommended flow

先生成 10–20 个候选，再筛选、核价，最后只深查 1–3 个。不要对整批候选直接运行昂贵报告。

MCP tools

Three tools, one deliberate sequence.

工具都声明为只读，但会访问公开互联网数据源。单个来源失败不会让整批结果被包装成成功。

Screen candidates

screen_domain_candidates

批量核验注册局状态，并用后缀标准成本做第一轮预算初筛。viable 仍不代表注册商可下单。

20 names × 3 TLDs

Verify registrar quotes

verify_domain_prices

只对入围候选核验域名特定报价、溢价和疑似保留状态，同时返回来源、时间与缓存状态。

Up to 10 domains

Inspect final evidence

get_domain_report

深查注册、网站、历史、安全、品牌线索和近似域名；正式商标与法律结论始终保持未覆盖。

Final 1–3 domains

Evidence contract

Facts, decisions and unknowns stay separate.

读取响应时优先使用规范字段；旧客户端可以继续读取已有字段并忽略新增字段。

Layer	Canonical field	Meaning
Registry	`registryStatus`	公开注册状态：available / registered / reserved / unknown
Orderability	`registrarOrderability`	注册商是否给出域名特定报价，与 RDAP 状态分开
Risk	`verdict.score`	只评价已取得证据，不是商标或安全认证
Coverage	`riskCoverage`	完成数量、失败来源和未核验事项
Brand	`brandEvidence`	带来源与时间的观察证据；按 evidenceId 去重
Conclusion	`brandEvidenceStatus.conclusion`	当前保持 not_determined，不制造法律结论

Important: exact_string 只表示某字段出现了相同字符串；必须同时读取 matchedField、isStandaloneEntity 和 isBrandNameMatch。来源返回 no_match 也不等于没有冲突。

REST & machine-readable files

Use the same evidence without MCP.

REST、纯文本与网页报告共享同一套事实层。以下地址根据当前部署环境生成，不预设尚未上线的新域名。

Single-domain JSON

curl https://namepico.com/report/namepico.com.json

Batch registry screening

curl -X POST https://namepico.com/api/v1/domains/check \
  -H 'content-type: application/json' \
  -d '{"names":["namepico","namelens"],"tlds":["com","dev"]}'

/openapi.jsonOpenAPI 3.1 →/llms.txtAgent guidance →/docs/apiComplete REST reference →

Limits & privacy

Bounded by design.

限制既保护免费上游，也避免把候选调查变成可被重建的查询历史。

8 / minute

单域名查询按来源限流；每小时最多 30 份详情报告。

300 / hour

批量额度按域名数量计算，不按 HTTP 请求次数计算。

No candidate log

候选名称不写入业务数据库；仅保存聚合运行指标。

接口返回 429 时读取 retry-after。状态为 unknown、报价为 unverified 或 coverage 为 partial 时，调用方必须保留不确定性。