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 のビルダー発見レイヤーです。公開され、情報源に裏付けられた記録に基づいて、今も開発を続けているプロジェクトはどれか、何をリリースしたか、そして市場の注目をまだあまり集めていないのはどれかという問いに答えます。

ツールは誰でも curl でアクセスできるものと同じ公開 API を読み取るため、API にない情報を返すことはありません。

ホスト型

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

ステートレスで読み取り専用のストリーミング可能な HTTP です。キーの利用枠で読み取るには、--header "Authorization: Bearer hey_…" を追加します。エンドポイントでできることとできないことについては、docs/MCP.md を参照してください。

ローカル（stdio）

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

@modelcontextprotocol/sdk が必要とする Node 20 以降。

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 キーです。連携を識別し、同じアドレスの全呼び出し元で共有する枠の代わりに、独自の分単位の利用枠と月間利用枠を提供します。無料キーでは匿名利用時の分単位の上限が維持され、保有者キーでは上限が増えます。これがないと使えないツールはありません。ベアラートークンとして送信され、ログに記録されることはありません。
HEY_MARKET_INTEGRITY	読み取る HEY が Market Integrity を公開している場合に限り、public に設定します。その場合のみ market_integrity が提供されます。未設定の場合、サーバーは 13 個のツールを提供します。
HEY_MCP_PROFILE	research を指定すると、リサーチプロファイル（ラウンド 4）が提供されます。ビルダーインテリジェンスを優先し、research_answer（契約で定義されたラベル付きの市場コンテキストも引き続き含みます）、ID による find_projects、市場イベントを除外した get_changes、get_project_timeline、explain_fact、get_evidence、get_contract、get_v4_hook を利用できます。未設定の場合は全ツールが提供されます。ホスト型の URL は https://heyresearch.xyz/mcp/research です。

13 個のツール

ツール	回答する内容
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	1 回の読み取りで 1 つのプロジェクトについて、識別情報、開発状況、市場情報（評価額の種類、または非公開の理由を含む）、オンチェーン情報、検証、ロック、最新の変更、情報の鮮度、HEY が把握していないことを確認できます。
get_changes	変更履歴です。チェーン全体または 1 つのプロジェクトで何が変わったか、各変更について固有の時刻と精度を含むイベント、HEY がその変更を把握した時期、根拠を確認できます。追跡用のカーソルもあります。
get_project_timeline	1 つのプロジェクトの根拠を 1 つの時系列で確認できます。カーソルを使ってページ分割されます。
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 の日次インデックスに基づく 1 つのトークンの市場情報、ライフサイクル、プール、供給の集中度（シェアのみ）、コントラクトのチェック結果を確認できます。include: ["moves"] を指定すると、各評価額の変動前に何がリリースされたかとともに、評価額の変動が追加されます。
get_contract	コントラクトを調査対象として確認できます。作成、デプロイヤー、検証済みソース、プロキシと実装の履歴、インターフェース数、アクティビティが含まれます。Uniswap v4 hook の場合、HEY はそのコールバックと帰属情報も保存しています。
get_v4_hook	Robinhood Chain の Uniswap v4 hook を誰が開発したかを確認できます。HEY が紐づけるプロジェクトと、その根拠（HEY がその hook を掲載している間のみ名前を表示し、作成者アカウントは表示しません）、アドレスが宣言するコールバック（安全性の判定ではありません）、読み取ったソースとプロキシ、コンテキストとしての Uniswap の hooklist エントリー、追跡対象トークンのプール（週ごと）、HEY が把握していないことを確認できます。
project_diff	原因には言及せず、2 つの日付の間に 1 つのプロジェクトで何が変わったかを確認できます。
ask_hey	1 つのプロジェクトについて自由形式で質問できます。回答は HEY の記録のみに基づきます。
chain_overview	チェーンの日ごとの状況、今週の状況、アーカイブ済みの週次レポート、予定されている HoodLock のロック解除、または市場の注目度と並べた Build Momentum を確認できます。
research_answer	6 つの機能（research_project、what_changed、builder_status、verify_project、compare_builders、unknowns）のいずれかに対する、HEY のエージェント契約（AgentIntelligenceResponse v1）を返します。回答を先頭に、続いて FACT、DERIVED、UNKNOWN のタグ付き主張、HEY が把握していないこと、情報の鮮度、根拠 ID を提示します。research_project、builder_status、unknowns では、project（スラッグ）、q（名前または $TICKER）、address（0x コントラクト）のいずれか 1 つを指定します。複数のプロジェクトで共有されている名前を指定すると、候補のスラッグを返しますが、いずれも選択しません。デフォルトではテキストは簡潔な要約です（データ、情報の鮮度、根拠の行を含めるには detail: "full" を指定します。JSON 全体は常にリソースリンクと structuredContent に含まれます）。最後は引用行で終わります：「Source: HEY Research Lab, builder research for Robinhood Chain — , as of , rules 」。情報源の文言はデータとして引用されます。

サイトで公開されている場合は、market_integrity も利用できます。

2026-09-30 に折りたたまれ、引き続き呼び出し可能ですが、2026-12-31 まではリストに掲載されない機能：lookup_token（アドレスを使って find_projects を使用）、compare_projects（compare_builders を使って research_answer を使用）、get_project_coverage（unknowns を使って research_answer を使用）。いずれも以前と同じ内容に加えて、置き換え先を示す 1 行を返します。 各ツールはテキストとともに型付きの structuredContent を返し、outputSchema を宣言します。 research_answer は AgentIntelligenceResponse v1 自体を返します。それ以外の各ツールは、 レンダリングした公開 API オブジェクトである { schema: "hey.mcp-api-answer", api, data, notice } を返します。リソース （hey://project/{slug}、hey://project/{slug}/timeline、 hey://project/{slug}/coverage、hey://contract/{chainId}/{address}、 hey://changes/latest）と8つのプロンプト（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 に数値がない場合、0 や「該当なし」として表示することはありません。

表示しない情報

HEY は公開されている開発活動を記録します。投資助言ではなく、価格を予測したり価格で順位付けしたりせず、ウォレットデータも保持しません。いずれかのツールが名前を示すアカウントは、コントラクトのデプロイヤーだけです。get_token_market は、1つのトークンの供給集中度の概要（シェアのみ）とともにその名前を示します。また、get_contract は、同じアカウントがデプロイした、追跡対象となっている他のプロジェクトのトークン数を示します。これは件数であり、プロフィールではありません。HEY 独自の共有デプロイヤー判定ルールに該当する場合に限り、ローンチサービスと呼びます。Still Building は、HEY が追跡した市場下落局面を通じて、検証済みの活動が継続しているという限定的な主張です。サーバーがその意味を示さずに述べることはありません。

ソースコード

ツールは、公開されている HEY Research リポジトリの packages/mcp-core にあります。このパッケージが stdio エントリーポイントとなり、ツールを @hey-research-lab/sdk とともに1つのファイルにバンドルします。

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

ライセンス

MIT © HEY Research Lab