跳到正文
ZKONER
搜索ABOUT
MCP · 工具接口

让 Agent 按工具调用，而不是靠猜页面

下面是与本站 API 一一对应的工具定义。工具名、入参与返回结构都以这里为准； 同一个数据，人读页面、机器读 JSON、Agent 调工具，三条出口同源。
状态：未上线10 个工具定义 · 数据冻结于 2026-09-19

当前状态

先说清楚，再列定义

MCP 服务端尚未上线，所以这一页现在只是工具契约，不是可连接的地址 —— 本站不会把一个还没跑起来的东西写成「已支持」。

在那之前，同样的数据可以通过公共 API 取得，字段完全一致。 服务端上线后，这一页会换成真实的连接信息，并在这里标注生效日期。

现在可用：公共 API →给 Agent 的说明书 →
为什么先写契约

工具定义是接口设计，服务端只是实现。 先把「Agent 能问什么、会拿到什么」定下来， 实现才不会长成一个只会返回一大坨 JSON 的端点。

工具定义

9 个只读工具
  • GET_PERSON源 /api/v1/1 条.json

    读取实体档案：身份、行业、所在地、服务、置信度

  • GET_PROJECTS源 /api/v1/projects.json

    项目列表与单个项目详情，含状态与基线

  • GET_CASES源 /api/v1/cases.json

    案例清单：以域名为主要标识的交付记录

  • GET_PRODUCTS源 /api/v1/products.json

    可交付服务及其对象

  • GET_ARTICLES源 /api/v1/articles.json

    内容资产清单，可筛类型与时间

  • GET_OPINIONS源 /api/v1/opinions.json

    判断及依据，附带来源

  • GET_EXPERIMENTS源 /api/v1/experiments.json

    实验及其实测样本与口径

  • GET_TIMELINE源 /api/v1/timeline.json

    按时间排序的节点

  • GET_MEDIA源 /api/v1/media.json

    分发渠道登记

  • SEARCH源 /api/v1/search-index.json

    在实体名、标题、正文片段中检索

契约约定

权限L0 只读。所有工具不写入。
返回结构化 JSON，字段与 API 相同
分页列表工具支持 limit / cursor
缺失值null，不省略字段
私有数据不在任何工具范围内
工具数10

写入类工具（创建草稿、更新内容）属于权限体系的一部分，默认等级为 L1， 且必须经过审核环节 —— 当前不在本页定义范围内。 当前站内登记 1 个项目、1 个实验、2 个实测样本，这些数字就是上面工具会返回的实际规模。

与 API 的分工

静态 JSON

一次取回全量，适合构建期摄取、批量分析、离线索引。 没有调用次数限制，因为是文件。

MCP 工具

按需取用，适合对话中的即时查询：Agent 问什么取什么，而不是先吞下整站。

HYPOTHESISMCP 服务端的上线时间未定。在那之前，本页只承诺定义，不承诺可用性。