HEY Research Lab

@hey-research-lab/mcp

npx -y @hey-research-lab/[email protected]          # Node 20 or newer

或者使用托管端点，无需安装任何内容： claude mcp add --transport http hey-research https://heyresearch.xyz/mcp。

HEY Research 提供助手可通过 Model Context Protocol 调用的工具。HEY 是 Robinhood Chain 的构建者发现层；它基于公开且有来源支持的记录，回答一个问题——哪些项目仍在开发、它们已发布了什么，以及哪些项目尚未受到太多市场关注？

这些工具读取的公共 API 与任何人都可以用 curl 访问的 API 相同，因此它们不会提供 API 未提供的信息。

托管版

claude mcp add --transport http hey-research https://heyresearch.xyz/mcp

采用 Streamable HTTP，无状态且只读。添加 --header "Authorization: Bearer hey_…"，即可使用密钥的额度读取。 请参阅 docs/MCP.md，了解该端点的功能和限制。

本地版（stdio）

npx -y @hey-research-lab/[email protected]

Node 20 或更高版本——这是 @modelcontextprotocol/sdk 所要求的最低版本。

Claude Code

claude mcp add hey-research -- npx -y @hey-research-lab/[email protected]

Claude Desktop — 在 claude_desktop_config.json 中：

{
  "mcpServers": {
    "hey-research": {
      "command": "npx",
      "args": ["-y", "@hey-research-lab/[email protected]"]
    }
  }
}

环境变量

变量	用途
HEY_API_URL	要读取的另一个 HEY，例如，开发时使用 http://localhost:3000。默认值为 https://heyresearch.xyz。除 localhost 外，任何非 https 地址都会被拒绝，因为每个请求都会携带密钥。
HEY_API_KEY	从 heyresearch.xyz/account 获取的 API 密钥。它会标识你的集成，并为其分配独立的每分钟请求额度，而不是与你所在地址的所有调用者共享同一个额度；此外还提供月度额度。免费密钥保留匿名用户的每分钟额度，持有者密钥则有更高额度。所有工具都无需密钥即可使用。密钥会以 bearer token 的形式发送，绝不会被记录。
HEY_MARKET_INTEGRITY	仅当你读取的 HEY 发布了 Market Integrity 时，才设置为 public；只有在此时才会提供 market_integrity。未设置时，服务会提供十三个工具。
HEY_MCP_PROFILE	research 提供研究配置（第 4 轮）：优先提供构建者情报——research_answer（仍包含其契约中标记的市场背景）、按身份查找项目的 find_projects、不含市场事件的 get_changes、get_project_timeline、explain_fact、get_evidence、get_contract、get_v4_hook。未设置时，提供完整工具集。托管端点：https://heyresearch.xyz/mcp/research。

十三个工具

工具	解答的问题
find_projects	按名称、代币代码或合约查找项目，或浏览某个类别——still-building、under-the-radar（符合 Under the Radar 规则，且 Discovery Gap 为正值）、back-from-dormancy、shipping-in-silence、accelerating、builder-radar 等——并应用目录筛选条件。0x… 地址用于查询合约：是否有人在构建、该合约近 30 天内的上线记录、最近一次上线记录及其来源。
get_project_snapshot	一次读取一个项目：身份、开发情况、市场信息及其估值类型或未披露原因、链上数据、验证情况、锁仓、最新变化、数据新鲜度，以及 HEY 不知道的内容。
get_changes	变更账本：全链或单个项目有哪些变化；每项变化对应一个事件，包含各自的时间和精度、HEY 得知该变化的时间及其证据；并提供用于继续获取的游标。
get_project_timeline	沿单一时间轴查看一个项目的证据，并通过游标分页。
explain_fact	解释 HEY 为何显示某个数值：规则、来源、输入、溯源信息和证据 ID。
get_evidence	将一个带类型的证据 ID（ship:、signal:、abi:、impl:、lock:、source:、claim:、state:、integrity:（仅在 Market Integrity 公开时）、narrative:、method:、sourcechange:、security:、v4hook:）作为凭据查看。
get_token_market	从 HEY 的每日指数查看单个代币的市场信息、生命周期、资金池、供应集中度（仅份额）、合约检查；include: ["moves"] 会附加估值变动及每次变动前的上线记录。
get_contract	将合约作为研究实体查看——创建信息、部署者、已验证源码、代理与实现历史、接口计数、活动情况；对于 Uniswap v4 钩子，HEY 还会存储其回调及归属信息。
get_v4_hook	谁构建了 Robinhood Chain 上的 Uniswap v4 钩子：HEY 将其关联到的项目及依据（仅在 HEY 列出该钩子时命名；绝不指向创建者账户）、其地址声明的回调（绝不作出安全判定）、读取到的源码和代理、作为背景信息的 Uniswap 钩子列表条目、按周统计的受追踪代币资金池，以及 HEY 不知道的内容。
project_diff	比较一个项目在两个日期之间的变化，不说明原因。
ask_hey	针对一个项目提出自由文本问题，答案仅基于 HEY 的记录。
chain_overview	查看链上每日情况、本周情况、已归档的每周报告、计划中的 HoodLock 解锁，或与市场关注度并列查看 Build Momentum。
research_answer	针对六种能力之一返回 HEY 的 Agent 合约（AgentIntelligenceResponse v1）——research_project、what_changed、builder_status、verify_project、compare_builders、unknowns；先给出答案，再列出标记为 FACT、DERIVED 或 UNKNOWN 的声明、HEY 不知道的内容、数据新鲜度和证据 ID。research_project、builder_status 和 unknowns 接受 project（slug）、q（名称或 $TICKER）或 address（0x 合约）——必须且只能提供其中一项；如果多个项目共用一个名称，则会列出候选 slug，不选择任何一个。默认文本为精简摘要（detail: "full" 可显示数据、数据新鲜度和证据行；完整 JSON 始终可通过资源链接和 structuredContent 获取），并以引用行结尾："Source: HEY Research Lab, builder research for Robinhood Chain — , as of , rules "。来源原文作为数据引用。

此外还有网站发布的 market_integrity。

lookup_token（使用地址调用 find_projects）、compare_projects（使用 compare_builders 调用 research_answer）和 get_project_coverage（使用 unknowns 调用 research_answer）于 2026-09-30 下线，但仍可调用且不再列出，直至 2026-12-31。它们仍按原方式作答，并额外提供一行说明替代工具。 每个工具都会在文本旁返回类型化的 structuredContent，并声明 outputSchema： research_answer 返回 AgentIntelligenceResponse v1 本身；其他每个工具都返回 { schema: "hey.mcp-api-answer", api, data, notice }，即它呈现的公开 API 对象。它们还提供资源 （hey://project/{slug}、hey://project/{slug}/timeline、 hey://project/{slug}/coverage、hey://contract/{chainId}/{address}、 hey://changes/latest）和八个提示词（deep_research_project、 what_changed_since、explain_metric、investigate_contract、what_changed_today、 compare_project_usage、explain_project_evidence、monitor_project）。

每个回答都会引用来源中的原文 «…»（名称、代号或发布标题），将其作为数据；为各行标记 FACT、DERIVED 或 UNKNOWN；说明展示了多少条、总共有多少条以及如何继续查看；注明估值类型；附上来源；并链接到生成该回答所依据的 JSON。HEY 没有数据时，不会将其呈现为零或“n/a”。

它不会说什么

HEY 记录公开的开发活动。它不提供投资建议，不预测或按价格排名，也不持有任何钱包数据。工具提及的唯一账户是合约的部署者：get_token_market 会在一个代币的供应集中度摘要旁注明部署者（仅提供占比），get_contract 会注明该账户还部署了多少个其他受追踪项目的代币——这是一个数量，绝非档案；只有符合 HEY 自身的共享部署者规则时，才会称其为发行服务。Still Building 是一项范围有限的说法——指 HEY 追踪到的市场下跌期间，经过验证的活动仍在持续——服务端绝不会在不说明其含义的情况下使用这一说法。

源码

这些工具位于公开的 HEY Research 仓库中的 packages/mcp-core；此软件包是它们的 stdio 入口点，并将它们与 @hey-research-lab/sdk打包为一个文件。

pnpm --filter @hey-research-lab/mcp build && node apps/mcp/dist/index.js

许可证

MIT © HEY Research Lab