EdgeDepth Research

EdgeDepth Research MCP サーバー

@edgedepth/research-mcp は、市場のマイクロストラクチャー検索エンジンである EdgeDepth の公式な調査専用 Model Context Protocol サーバーです。記録された Binance USDT-M 暗号資産無期限契約を対象としています。ChatGPT、Claude、Cursor、Codex、または任意の MCP クライアントから使用して、市場の条件に一致する検証済みのすべての発生を検索し、一致した全データを対象に先行する結果を確認し、無条件かつ同一範囲の参照値を読み取り、リプレイにリンクされた証拠を開くことができます。

すべての結果には、分母を伴う件数と再現性キーが含まれます。同じキーなら、同じバイト列が得られます。

ウェブサイト · 市場を検索 · REST API ドキュメント · MCP セットアップガイド · ラーニングハブ

EdgeDepth Research を使う理由

• 記録された市場のマイクロストラクチャーを検索： オーダーフロー、オーダーブックの厚みと取引コスト、記録の来歴、価格変動、ボラティリティ、ファンディング、未決済建玉、ポジショニング、ローソク足の形成、清算、清算水準を網羅する、クローズドかつバージョン管理された特徴量レジストリを検索します。
• 分母を維持： すべての件数で、その背後にある対象母集団と除外項目を報告します。データが欠落している場合は欠落したままとし、ゼロに暗黙に置き換えることはありません。
• 先読み選択なしで結果を測定： 先行リターン、MFE、MAE はすべての発生を対象に計算されます。結果フィールドをフィルターとして使用することはできません。
• 一致した母集団とベースライン母集団を比較： 決定論的なコホート結果では、一致した分布を、条件述語が偽となるほかのすべての対象バケットと並べて表示します。
• 証拠を監査してリプレイ： 結果には再現性キーが含まれ、代表的な発生には、記録された正確な市場時点への認証済みウェブハンドオフが含まれます。
• 調査専用を維持： どのツールも取引、アラートの変更、レポートの公開を行いません。非公開の Radar 管理者向けパイロットでは、別途任意の research:hypotheses 権限を使って、アカウント所有の仮説を保存できます。新しいスキャン、コホート、または層別計算では、調査利用枠の単位を消費する場合があります。その副作用は注釈に明示されています。

接続方法を選択

このパッケージでは、2 種類のトランスポートを通じて 1 つのツールコアを利用できます。

• ホステッド MCP（推奨）： Streamable HTTP 経由で https://mcp.edgedepth.com/mcp に接続し、ブラウザーで一度認証します。コピーする API キーはありません。
• ローカル stdio： EdgeDepth API キーを使って npx -y @edgedepth/research-mcp を実行します。

接続

Claude Desktop

Settings > Connectors > Add custom connector で、次を入力します。

https://mcp.edgedepth.com/mcp

EdgeDepth のブラウザー認証プロンプトを完了します。

Cursor（~/.cursor/mcp.json）

{
  "mcpServers": {
    "edgedepth-research": {
      "url": "https://mcp.edgedepth.com/mcp"
    }
  }
}

Codex（~/.codex/config.toml）

[mcp_servers.edgedepth]
url = "https://mcp.edgedepth.com/mcp"

次に、以下を実行します。

codex mcp login edgedepth

ブラウザー OAuth を使用する前に、古い bearer_token_env_var の行を削除してください。

npx を使ったローカル stdio

EdgeDepth Developer ページでキーを作成し、次を追加します。

{
  "mcpServers": {
    "edgedepth-research": {
      "command": "npx",
      "args": ["-y", "@edgedepth/research-mcp"],
      "env": {
        "EDGEDEPTH_API_KEY": "edk_live_YOUR_KEY"
      }
    }
  }
}

ローカル stdio には Node.js 20 以降が必要です。記録データ用のツールには research:read キーのスコープを使用し、無料の interpret_prose 提案ステップが必要な場合に限り research:interpret を追加してください。

結果の射影（エージェントのコンテキスト節約）

スキャン系の結果は大きくなります。ユニバーススキャンの正規バイト列は数百キロバイトに達し、その大部分を、記録されたすべての特徴を持つページ行、counts_by_symbol のゼロ値やロングテールのエントリー、空のしきい値段が占めます。そのため、クライアントは何かに回答する前にツール結果の予算を超えてしまいます。

そのため、run_scan、next_page、run_cohort はデフォルトで明示された射影を返します。表示用の導出項目と削除項目については、詳細を正確に復元する方法も明記しています。デフォルトの run_scan は、以下で説明するコンパクトなテキスト表示を追加します。full_outcomes: true、next_page、run_cohort は、次の詳細な射影を維持します。

• 出現行は rows（デフォルトは3件）までに絞り込まれ、残された各行には、その行自身の evidence ブロックで指定されたセットアップフィールドが保持されます。full_rows: true を指定すると、ベクトル全体が復元されます。
• 出現ごとの outcomes マップには、残された行のエントリーが保持されます。
• counts_by_symbol は一致数の多い順に上位エントリーを保持し、除外された銘柄数と一致数を示します。
• アウトカムラダーは、対応する回答ブロックに置き換えられます。各メトリクスについて、present、absent、選択された段の整数カウントはそのまま返され、それらの横に rate、同じ銘柄と期間における無条件の baseline_rate、および両者の比率である lift が示されます。選択対象はあらかじめ固定されており（gte 0.01、gte 0.02、lte -0.01、lte -0.02）、何も区別しない段は除外されます。また、出現数が30件以上の段のうち、lift が最大となる段が1つ追加され、kept_for で示されます。full_outcomes: true を指定すると、すべての段と、一致集合および参照集合それぞれの段ごとのヒストグラムが返されます。

母集団全体のカウント、アウトカムの分母、非該当件数、predicate_coverage、代表例、ページカーソル、再現キーはそのまま維持されます。リクエストドキュメントが書き換えられることはないため、正規クエリハッシュと課金クレジットは、リクエストした内容と完全に一致します。full_counts: true を指定すると、射影なしでエンジンの正規バイト列がそのまま返されます。ETag の適用範囲は射影ごとに定まります。ある射影用に保持した ETag が、別の射影として再検証されることはありません。

list_features にも同じ処理をリクエストできます。search、feature_ids、compact を指定すると、文法全体ではなく1つの特徴ファミリーが返され、閉じた仕様部分（演算子、ウィンドウ、シーケンス規則、制限、エラーコード）はそのまま保持されます。

プロンプトとリソース

サーバーは、互換性のあるクライアントで選択可能なコマンドとして表示される、手順付きプロンプトを公開しています。test_a_claim、liquidation_cascade_bounce、investigate_symbol、what_preceded_moves_like_this、does_it_confirm、how_common_is_it（無料の有病率確認経路）を利用できます。いずれも同じ回答契約を定めています。文法に基づいて正確な定義を提示し、確認を待ってから、分母、参照情報、再現キー、再実行への引き継ぎとともに結果を報告します。

文法レジストリは edgedepth://research/grammar というリソースとしても提供されます。そのため、クライアントは毎回のセッションで list_features を呼び出す代わりに、一度だけこれを添付できます。

推奨されるエージェントのワークフロー

1. セットアップを優先する質問では、ホスト内の文章を解釈し、構造化されたスコープ、述語、結果を指定して prepare_study を呼び出します。このツールはウェブバリデーターと測定コントラクトを再利用し、現在のインストゥルメントへの所属を検証して、未実行の正規定義と最新の利用枠の見積もりを返します。外部 LLM は使用されません。user_stated、semantic_translation（上位 10% は rank >= 0.9）、model_assumed は別々に保持してください。発明された提案を示すのは最後のものだけです。未加工の文章にフォールバックする場合は、interpret_prose を変更せずに使用します。珍しいフィールドや検証の修正には簡潔な list_features を使い、すべての質問で使う必要はありません。
2. マニフェストから導出されたユニバース、カバレッジ、プロベナンスを確認する必要がある場合に限り、list_instruments を呼び出します。その結果には、まだ記録中のマーケットについて、同じ形式で人間向けのマーケットページ https://edgedepth.com/research/symbols/<symbol> が含まれます。ユニバース内の上場廃止済みマーケットにはページがないため、リンクを提供するのではなく、その旨を伝えてください。
3. 条件、正確なマーケットと日付／タイムゾーン、結果の定義と期間、利用枠の消費量を含む短い提案を 1 つ提示します。解釈は無料ですが、新しい計算では利用枠を消費することがあります。提供されていない値はすべて、チップのプロベナンスを使って提案上の仮定として明示してください。サポートされていない断片を解消し、調査に実質的な影響を与える質問だけをしてください。正確な JSON と診断情報はツールの詳細で確認できるようにし、必要に応じて提示します。
4. 人間から明示的な承認を得てから、同じドキュメントを run_scan に渡します。変更がある場合は、新たな提案と確認が必要です。正確なドキュメントを使う API は、提案 ID も人間の承認記録も保存しません。クライアントの同意が必要であり、モデルが指定したフラグは証明になりません。対応するウェブリリース（b68c744 以降）では、返された rq ワークベンチリンクを開くと編集可能な提案が読み込まれ、Run を待つ状態になります。ページ遷移によって計算が承認されることはありません。
5. ゼロ件一致や結論が出ない結果もそのまま保持し、まず質問に答えます。一致数／適格数、カバレッジによる除外、発生した結果と発生しなかった結果、合意した期間における両方向、重複／選択による制約を示します。発生率は、すべての発生を対象とする outcomes_summary から読み取ります。ページ上の行は例であり、分母ではありません。各段階には、一致数と発生率、無条件発生率、それらの比率である lift がすでに含まれています。それらを引用し、発生率と併せて件数も示してください。lift がない場合は、参照値がないか、無条件発生率がゼロです。いずれの場合も lift を推定してよい根拠にはなりません。
6. 利用可能な場合は、追加された同一スコープの無条件参照を確認します。これは一致対象でも比較可能なものでも、因果関係を示す対照でもありません。
7. 回答とともに、完全な再現性キーと、関連する次のアクションを 1 つ返します。選択肢は、返却されたリプレイ、変更した仮定、既存レポートです。一般的な保存済み調査とアラートは引き続きウェブ上で操作します。非公開の Radar 仮説には、以下のオプションのワークフローを使用します。引き継ぎの際は、それぞれどの程度過去の時点にさかのぼるかを示してください。リプレイ可能な範囲はアカウントごとの権限で決まるため、発生自体は実在していても、古い時点のものはウェブ画面で拒否されることがあります。next_page は、API から返されたカーソルがある場合にのみ使用してください。

MCP クライアントへの指示例：

Did elevated VPIN and one-sided buying tend to precede a rise? Propose a precise
study before running anything. Label any suggested thresholds, markets, dates
and outcome definition so I can approve or change them.

ユーザーにツール名、機能 ID、JSON を知らせる必要はありません。クライアントは、確認済みの提案を既存の正確なドキュメント呼び出しに変換します。

成果優先およびポイント移動ワークフロー

成果優先の質問では、目標と範囲に合意した後、outcome_first を使用します。期間内に触れた（reached）場合と終了時に近い（finished）場合の違い、方向、大きさ、期間を維持してください。成果をセットアップインタープリターに渡したり、実例で置き換えたりしないでください。目標の文法は edgedepth://research/outcome-first で確認できます。

表示する各読み取りについて、母集団と、カウントに基づく両方の割合を報告してください。利用者が読み取りを1つ選べるようにし、変更していないリクエストに対して full_rows: true を指定して、その読み取りの setup_first_rerun を取得してください。run_scan の前に、そのセットアップが正確に一致することを確認してください。元の目標は、変更していないドキュメントの外で run_scan.measure に渡します。到達の場合は kind: "touch"、終了の場合は "close" を指定し、合意した方向、小数表記の大きさ、期間も渡してください。返されるワークベンチリンクには、その表示上の選択が保持され、未実行のドラフトとして残ります。これはスキャン／キャッシュキーを変更しません。以下のローカルの選択済み成果の追加機能では、終了時リターンの探索とは別に、選択した読み取りの正確な内容が保持されます。 元の成果目標は、マッチしたセット全体のサマリーから読み取ってください。投影結果にその段階が含まれていない場合は、full_outcomes をリクエストしてください。利用できない段階はその旨を示し、既定の期間で置き換えてはいけません。2つの読み取りでは分母が異なります。同じ期間での再実行は引き続き探索段階です。条件を固定し、検証を主張する前に別の期間を使用してください。

特定の時点は snapshot_at で調べることができ、複数の指定時点は commonality で比較できます。以下のスクリーンショットの経路では、範囲を限定した明示的な終値付近の調査と既存の検出器ジオメトリを追加します。自動的な移動の選択は MCP では提供されていません。過去のマーカーの閲覧と、汎用的な出来高ティアの解決は、まだ MCP の機能ではありません。以下のローカルの resolve_scope 追加機能では、ウェブ版のリリース後に明示的なセクター解決が可能になります。list_instruments が提供するのは、カバレッジと銘柄の出典情報であり、セクター構成ではありません。利用可能な場合は resolve_scope を使って記録済みのセクター構成を確認してください。そうでない場合は、正確に指定された銘柄リストを使用してください。グループの構成銘柄や数値の価格を作り上げてはいけません。リプレイの引き継ぎではウェブ画面が開き、利用者のカバレッジと利用資格が引き続き適用されます。

ツール

ツール	機能
list_features	クローズドな文法レジストリを返します。内容は、特徴量 ID、型、範囲、演算子、ウィンドウ、シーケンスルール、制限、エラーコードです。search、feature_ids、compact で絞り込めます。
list_instruments	リサーチ対象とカバレッジを返します。デフォルトでは簡潔な概要を返します。選択したレコード全体を取得するには symbols: [...] を、正規の対象全体をそのまま取得するには full: true を使います。
prepare_study	無料の決定論的な構造化準備、出典情報、許容量の見積もりを提供します。事前にウェブの /prepare リリースが必要です。
interpret_prose	散文をクエリ文書案に変換します。クエリは実行しません。任意の time_zone には、カレンダー計画用の IANA タイムゾーンを指定できます。
run_scan	research_query.v2 文書を実行し、件数、分母、結果、無条件の同一スコープ参照、再現性キーを含む結果バイト列を返します。デフォルトでは投影形式です（rows、full_rows、full_counts）。
next_page	不透明なカーソルを使って、前回のスキャンを続行します。カーソルを手動で作成しないでください。
ground_screenshots	ホストが抽出したスクリーンショットの座標を、記録されたローソク足の終値とカバレッジに照合し、不確実性を保持しながらイベント表示の重複を排除します。無料です。
investigate_move	根拠が確認されたイベントについて、既存の直前の動きと、任意で記録済みの検出器ジオメトリを読み取り、実行前の正確なセットアップ文書を準備することもできます。読み取りは無料です。過去データの利用資格が適用されます。
snapshot_at	記録された時点におけるレジストリの特徴量値、ウィンドウ集計、発火したルールを読み取ります。
base_rate	1 つの節について、指定したウィンドウ内の一致数と対象バケット数を数えます。
commonality	複数の時点に共通する決定論的な部分集合を特定します。選択バイアスに関する注意事項も含まれます。
get_report	8 文字の正規ハッシュを指定して、公開済みレポートを取得します。
run_cohort	一致するすべてのバケットの後に起きたことを、条件を満たすその他すべての述語不一致バケットの後に起きたことと比較します。
run_stratified	既存のアンカーを基準に、1 つの一致集団を分割し、分割条件が真、偽、欠如する場合の結果概要を示します。
outcome_first	セットアップではなく MOVE から開始します。結果（サイズ、方向、期間）を指定し、実現したすべての類似 MOVE の前にある 5 つの固定オフセットで、記録にどのような動きがあったかを報告します。各行には 2 つの比率が示されます。これらの MOVE の前の比率と、同じスコープ内で条件を満たすすべての分にわたる比率です。また、逆方向から再検証するセットアップ先行の再実行も含まれます。これは記述的な読み取りであり、ルールの検索ではありません。行はルールでも候補でも発見事項でもなく、行の順序は表示順です。実現した MOVE が少なすぎるスコープは、件数と 4 つの調整方法を示して拒否されます。拒否されても許容量は消費されません。デフォルトでは投影形式です（rows、full_rows）。

取引、市場状態の変更、公開ができるツールはありません。アカウントのリサーチ履歴を変更できるのは、別途許可が必要な非公開の仮説ツールだけです。run_scan、run_cohort、run_stratified、outcome_first は、呼び出しのたびに許容量を 1 単位、取り消し不能な形で消費する可能性があるため、従量制の計算として注記されています。その他の記録データ用ツールは、クローズドワールドの読み取り専用です。interpret_prose は、設定済みの外部言語インタープリターを使用する無料の読み取りです。

プライベート Radar 仮説ワークフロー（ローカル追加機能）

対応する Web リリース、そのオプションの API キースコープ移行、および Radar 管理者アクセスが必要です。Web が MCP に先行します。既存の付与権限とキーに権限は追加されません。research:read と併せて research:hypotheses をリクエストし、新しい権限付与を承認するか、キー作成時に仮説オプションを明示的に選択してください。通常のアカウントには引き続きアクセスが許可されません。これは一般公開やホスト環境での受け入れを表明するものではありません。

• get_hypothesis：元の観測データ（event）、保存済みの記録（id）、またはいずれも指定しない場合は一覧を取得します。full: true を指定すると、すべてのレシート本文が復元されます。読み取りでは何も実行されません。
• prepare_hypothesis：編集可能な正確なドラフト、4 件のリクエスト、リビジョン、プランハッシュ、許容量の見積もりを返します。保存、計算、承認を意味するものではありません。
• save_hypothesis：既知のリビジョンを指定して、非公開で明示的に保存します。既存のソースと試行結果は変更されません。失敗を除外せずに、Test／Keep／Reject を保存します。
• run_hypothesis：提案内容を人が承認した後、4 件のリクエストすべてを固定し、最初のリクエストを実行します。返された続行シリアルを使い、同じ承認のもとで残りのリクエストを順番に実行してください。値が返されなくなったら停止します。タイムアウトが発生して結果が不明な場合は、保存済みの履歴を読み取ってください。実行中または不明な処理が再試行されることはありません。

Web と MCP はどちらも同じアカウント履歴を使用します。件数はネイティブの全結果サマリーから取得されます。A+B が主要な結果で、A／B はマッチも含む同一の入力対象集団に対する診断です。サンプルには支持するケースと矛盾するケースの両方が含まれることがありますが、分母としては使用されません。対象は Binance の USDT 無期限契約で、対応する数値フィールドは 6 つです。バックエンドのリリース後は、集団にネイティブの日次価格／OI クロスも含められます。結果はコストや約定を考慮する前の、4 時間以内の +5% MFE です。開発期間は最大 31 日間で、予約済み評価期間とは 7 日間を完全に空けます。アンカーの終了日は 2026 年 9 月 11 日までです。予約済み評価は実行されません。

サーバーは定義、失敗、レスポンスのバイト列、HTTP／許容量ヘッダー、および再現性キーを保持します。既定の出力では例を表示し、復元方法を明記したうえで生のレシートは省略します。インポートしたブラウザーの証拠には、呼び出し元が提供したものというラベルが付いたままになります。ストレージや並行処理のエラーが発生した場合、それ以降の作業を停止します。再度開いても計算は行われません。既存の課金方式は引き続き適用されます。API の計算ではそれぞれ許容量を消費する場合があり、キャッシュ済みの処理は無料です。セッション UI では、既存の集団スキャンメーターが引き続き使用されます。

リサーチ契約

• 検証エラーは 422 {"errors":[{"code":"...","message":"..."}]} としてそのまま返されます。
• トランスポートエラーには {"error","code"} エンベロープが使われます。
• 契約コードは機械処理に利用できます。UNSUPPORTED_FEATURE や OUTCOME_IN_PREDICATE などのエラーが発生した場合は、list_features を呼び出してドキュメントを修正し、再試行してください。
• 決定論的ツールは、正確なドキュメントを使い、UTC のみで動作します。interpret_prose は日付の計画にタイムゾーンを使用する場合がありますが、run_scan、run_cohort、base_rate が暦上の表現を解釈し直すことはありません。
• 再実行と ETag の 304 Not Modified による再検証は無料です。list_instruments の ETag は、要求されたサマリー、シンボルの射影、または完全な表現ごとにスコープされます。
• 解釈は無料で、スキャン許容量を消費することはありません。スキャン許容量が利用できない場合、チェックアウトリンクを含まない中立的な 402 RESEARCH_ALLOWANCE_EXHAUSTED メタデータが返されます。

REST API とドキュメント

MCP サーバーは、公開されている EdgeDepth Research API への薄く決定的なインターフェースです。

• REST API クイックスタート
• 認証と API キー
• クレジット、キャッシュ、制限
• バージョン管理されたクエリー文法
• 再現性に関する契約
• API の使用例
• MCP 接続ガイド
• EdgeDepth Research の仕組み
• 質問できる内容

stdio パッケージが使用するデフォルトの REST ベース URL は https://app.edgedepth.com/api/v1/research です。

環境

ローカル stdio

変数	デフォルト	用途
EDGEDEPTH_API_KEY	なし	stdio ツール呼び出しに必須です。
EDGEDEPTH_API_BASE	https://app.edgedepth.com/api/v1/research	任意の REST API ベース URL の上書きです。

ホスト型サーバーの運用者

変数	デフォルト	用途
EDGEDEPTH_OAUTH_EXCHANGE_URL	http://127.0.0.1:3002/api/mcp/oauth/exchange	OAuth アクセストークン交換エンドポイントです。
MCP_INTERNAL_SECRET	なし	必須の内部アサーションシークレットです。Web アプリと一致している必要があります。
PORT	3003	HTTP リッスンポートです。
HOST	127.0.0.1	HTTP リッスンホストです。

認証とセキュリティ

ホスト型サーバーではブラウザー OAuth を使用します。不透明なアクセストークンを検証し、それらを有効期間の短い別個の内部アサーションに交換します。また、OAuth アクセストークンが REST API に渡されることはありません。MCP サーバーはステートレスで、ユーザーの認証情報を保存しません。

互換性のあるクライアントは、接続が有効な間、リフレッシュトークンをサイレントにローテーションします。EdgeDepth Connected Apps でアクセスを確認または取り消せます。

API キーは、スクリプト、ローカル stdio、ブラウザー OAuth を使用しない MCP クライアントでも引き続き利用できます。edk_live_... キーはシークレットとして扱い、ソース管理にコミットしないでください。

開発

npm install
npm run build
npm test
npm run typecheck

TypeScript は dist/ にビルドされます。nginx の設定例、systemd のセキュリティ強化、運用者向けの環境変数は deploy/ にあります。本番環境へのデプロイと npm への公開は、引き続き運用者が行います。

関連プロジェクト

• edgedepth-terminal（AGPL）：オープンソースの C++/WASM オーダーフローテ​​ィングターミナルです。調査結果からリプレイにリンクされた証拠を開くと、記録された正確な市場の瞬間が表示されます。また、docker compose コマンド 1 つでセルフホストできます。
• edgedepth-gateway（MIT）：Binance の公開ストリームをターミナルのワイヤ形式に変換する Go ブリッジです。アカウントなしで、ライブデータ上でターミナルを実行できます。

ライセンス

MIT

インラインスキャンの証拠

対応する MCP Apps ホストでは、run_scan の比較カードと記録済み分布カードを表示できます。このカードが受け取るのは、ツール結果の _meta に含まれる、完全な結果のみを対象としたフォワードリターンの要約、カバレッジ、正確なクエリ／キー、メータリング情報です。ChatGPT では、このデータはモデルに表示されません。既存のテキスト表示に変更はありません。分布の作成に生のページ観測値は使用せず、適合曲線を捏造することもありません。また、チャート表示を切り替えてもリクエストや利用枠の消費は増えません。参照分布との比較は、ビンの境界が一致する場合に限られます。空のビン、開いた裾、欠損した結果、観測数がゼロまたは1件の状態も表示されたままになります。期間と値動き幅のコントロールは、すでに計算済みの結果の表示方法を選ぶものであり、承認済みクエリを変更するものではありません。カードは指定された結果を初期表示します。指定がない場合は、24時間を優先し、利用可能であれば30回以上発生した、ラベル付きの探索的な値動きを表示します。正確な調査／証拠の詳細はカード内で展開できます。テキストのみのホストには、簡潔なスキャン応答が返されます。HTML リソースにネットワーク依存関係や変更処理はありません。これは開発者向けコネクターの更新であり、公式 V1 の再スキャンが自動的に行われるわけではありません。

スクリーンショット主導の調査（ローカル実装。リリースが必要です）

ビジョン対応ホストにチャートを添付し、investigate_screenshots を使用します。ホストが画像を読み取り、サーバーは ground_screenshots を通じて screenshot_observation.v1 の事実を受け取ります。仕様は edgedepth://research/screenshots です。2つ目の画像モデルや自動添付アクセスは使用しません。

認証済みのすべてのティアで、グラウンディングは無料です。記録済みの Binance 先物ローソク足とマニフェストの範囲に照らして、明示された分足終値の境界を確認し、可視／推定／ユーザー指定／欠損の来歴を保持して、完全に一致するイベント表示を重複排除します。日付やタイムゾーンが不明確な場合、境界が推定された場合、座標が競合する場合、例が重複する場合は、確認が必要です。デフォルトの日付、取引所の代替、近傍の値動きの検索は行いません。ヒゲのティック時刻や、裏付けのない描画は照合しません。

investigate_move はイベントを再確認し、ウェブ版の5つの先行オフセット、記録済みの検出器証拠、セットアップ組み合わせビルダーを再利用します。利用枠は消費しません。過去のスナップショットには既存の利用資格が適用されます。オプションの正確な調査範囲と目標リターンを指定すると、未実行の setup_first_rerun ドキュメント、利用枠の見積もり、編集可能なワークベンチのリンクが返されます。デフォルトの応答では、重複するソーススナップショットと検出器のローソク足を省略し、full_sources: true を指定すると完全なバイト列を復元します。すべての読み取り値、正確なセットアップドキュメント、ソースメタデータ、欠損、パリティは引き続き確認できます。無料で再読み込みすると、より新しいリビジョンが表示される場合があります。母集団の件数とフォワードレートを確認するには、具体的な提案と人間による明示的な承認の後、既存の outcome_first または run_scan を引き続き使用する必要があります。正確な目標はセットアップ述語とは分けて扱われます。選択された勝ち事例と同一期間での再実行は、引き続き探索的なものです。検証には別の期間を使用してください。リプレイのカバレッジと利用資格は、調査履歴とは独立しています。

これらの MCP ツールをリリースする前に、ウェブ版の /api/v1/research/investigate/ground、/investigate、/evidence ルートをデプロイしてください。ウェブ版 b68c744 のワークベンチは、rq を編集可能な提案として読み込み、Run の実行を待ちます。到着時に実行する古いリリースでは、新しい提案リンクを使用しないでください。過去マーカーと名前付きコレクションの MCP パリティは、別途対応する作業です。返される見積もりは、準備済みの各セットアップに対するものであり、一般的な見積もりエンドポイントではありません。

ローカルの決定論的テストでは、抽出済みの観測値と、フィクスチャを使用した認証済みハンドラーをテストします。画像モデルやビジョンホストの受け入れテストではありません。アップロードから調査までがエンドツーエンドで機能すると表明する前に、実際のビジョン対応ホストで test/screenshot-host-acceptance.md のケースに従って確認してください。

リリース 0.8.0

スクリーンショットによる明示的な根拠提示と値動きの調査を追加しました。デフォルトではコンパクトなソース投影を使用し、完全な根拠が必要な場合は full_sources: true を指定します。 ホストが画像を読み取り、MCP は構造化された観察結果と正確な記録済み座標を検証します。曖昧な場合は値動きをでっち上げず、確認を求めます。

保存済みのスキャン、コホート、比較、結果優先の調査は、利用枠を使い切った後も読み取り可能です。ウェブでは専用のエンジンキャッシュ読み取りルートを使用し、結果が見つからない場合に新たな計算を開始することはできません。キャッシュはリビジョンに紐づけられ、削除される場合があるため、結果が永続的に保存されることを保証するものではありません。一般的なリプレイへのアクセスは、記録された日付、市場、プランによって異なります。調査リンクによってイベントへの利用許可が付与されることはありません。

ホストの準備とコンパクトなレポート（ローカル；リリースが必要）

prepare_study は、スコープ（シンボル、オフセット付きの from/to、出所）、セットアップ（フィールド／演算子／値／出所）、結果（到達／完了、方向、比率による大きさ、期間、出所）を受け付けます。ソースのメタデータはハッシュ化されたクエリとは別に保持されます。スクリーンショットのアンカーは画面上で確認できるもの、またはユーザーが指定したものである必要があります。不確かな時刻については確認が必要です。EdgeDepth の読み取り値は、まず snapshot_at で取得してください。定性的なルールは、本人が提案を承認するまで model_assumed のままです。サーバーはホストの申告を検証しますが、ホストが実際に何を見たかは確認できません。

get_report は、ソース件数と保存済みの完全性ステータスを含む、明記された固定の 1h 概要をデフォルトで返します。ピンを再検証したとは主張しません。full:true を指定すると、すべての結果と定義を含む保存済みの完全なバイト列が復元されます。この選択内容は、保存済みの要求測定ではありません。公開レポートの読み取りは引き続き無料です。

MCP より先にウェブをデプロイしてください。ローカルの決定論的テストは、本番環境でのレイテンシやビジョンホストの受け入れを保証するものではありません。

調査ジャーニーの継続性（ローカル、リリースが必要）

この MCP ビルドを使用する前に、ウェブの /api/v1/research/scope をデプロイしてください。resolve_scope は記録済みのセクタータグと、ウェブの値動き優先の入口と同じリゾルバーを使い、確認済みの Binance 暗号資産リニア無期限契約に絞り込みます。正確な銘柄リストと市場ごとの履歴を返します。対象集団に欠落、曖昧さ、データ不足、または過大な規模がある場合はブロックされます。自動的に対象範囲を広げることはありません。対象の構成は現在記録されている分類に基づくもので、過去の特定時点での構成ではありません。また、履歴が特徴量の完全性を証明するわけではありません。

run_scan.measure は、正規のバイト列に加え、厳密な対象全体の件数、逆方向、無条件の参照値を含む selected_outcome.v1 を追加します。ゼロ件数も表示され、分母がゼロの場合はレートが示されません。利用できない指標や段階が別の値に置き換えられることはありません。インラインビューでは同じ読み取り内容を先に示し、その厳密な測定値に対応する期間と値動きのコントロールが開きます。ヒストグラムには常に終値リターンと表示され、経路ラダーには MFE/MAE の到達値が別途表示されます。既存のレポートには、明記された固定の概要が引き続き適用されます。

類似性は、明記された次元における探索的な近さを示すものです。モニタリングには、過去の数値と完全に一致することではなく、バージョン管理されたサポート対象の述語を厳密に満たすことが必要です。見つかったしきい値には「提案」と明記し、別期間で評価する前に固定する必要があります。また、調整が行われた場合はその内容を開示してください。類似性をアラートに変換する機能、取引ルールの評価機能、自動フォワードテスト準備状況の判定機能は追加されません。保存とモニタリングには、非公開のウェブ連携と明示的な確認を使用します。アラートが示すのは条件の成立であり、予測の再現ではありません。

任意の取引ルールテスト（0.9.0、ホスト版のリリース待ち）

run_trade_test は、別途明示的に提案し、人間の承認を得た後にのみ使用してください。 このツールは、trade_query.v1 の正確なレコード母集団を、すべての trade_rules.v1 パラメーターと文字列値の source_measurement 来歴情報とともにラップします。デフォルトの提案は次のとおりです。 1%のストップ、固定ターゲットなし、終値でラチェットする2%のトレール、240分足、片側あたり6ベーシスポイントの 手数料と10ベーシスポイントのスリッページ、決済まで同一市場のシグナルをスキップします。 ロングまたはショートを明示的に選択してください。これらは編集可能な前提であり、最適な パラメーターではありません。上限は31日、明示的に指定する市場100件、シグナル5,000件です。

エントリー価格は次の1分足の始値です。ギャップストップでは不利な方の始値で約定し、同一足で ストップとターゲットの両方に達した場合はストップが優先されます。トレールは確定した終値に基づいて更新され、 次の足から適用されます。始値または価格足が欠けている場合は利用不可とし、直前の終値で 代替しません。バケットの終了時刻は区間ラベルであり、正確な約定タイムスタンプではありません。

勝ち、負け、平均利益／損失、期待値は、完全な取引サマリーから読み取り、MFE やページの行からは読み取らないでください。リターンには手数料とスリッページが含まれますが、 資金調達コストなどの執行コストは含まれないため、完全なネットリターンでもポートフォリオリターンでもありません。 元の質問、selected_measure JSON、測定バージョン、クエリハッシュ、データセットのリビジョン、 およびソース調査を source_measurement に保持してください。Web での保存とダウンロードでは結果が保持されます。 アラートはセットアップの再発とは別に扱われます。

バックエンドと Web のリリースは MCP より先に行う必要があります。始値列のない古い期間では、 TRADE_OPENS_UNAVAILABLE を返し、計算もデビットも行いません。新しいスキーマの行でも欠損がある場合があり、 個別にカウントされます。ホスト版のリリースによって、npm／レジストリへの公開が許可されることはありません。

取引結果はデフォルトで、完全なサマリーと時系列順の最初の10件のジャーナル例を返します。 full_trades:true を指定すると、正規の全バイト列が復元されます。表示モード間での再検証を防ぐため、 投影ごとに異なる ETag が使われます。どちらのモードもルール、完全な結果の件数、再現性キー、 計算料金を変更しません。

どちらのモードも、まず損益の要点を表示します。手数料とスリッページ控除後の期待値、勝ちと負け、 勝ちと負けの平均値と件数、勝ちと負けの合計、勝ち利益に占める最大利益の割合、理由別の決済数、 利用不可数とスキップ数、除外項目（資金調達コスト、保有時間は最大でも1440分）です。最大利益の割合と理由別の決済数は、行を切り詰める前の完全なジャーナルから算出されます。そのジャーナルがエンジンの勝ち負け件数と一致しない場合は、推定値を出さず、 表示しません。ネットワーク接続なしで使える損益ビュー（ui://edgedepth/trade-payoff-v1.html）には、同じ情報として、判定、 勝ち負けを対比する棒グラフ、ルール、除外項目が表示されます。

保存済みの調査エビデンス（ローカル、リリース待ち）

get_investigation_bundle は、Web と同じ API を通じて、既存の SHA256 バンドル ID を読み取ります。コンパクト出力には、正確なイベント／基準時点の範囲、ソースの受領記録、 指標、決定的な観測結果、矛盾するエビデンス、未実施の分析が保持されます。 full: true を指定すると、固定された入力観測結果が復元されます。モデル、スキャン、利用枠のデビット、 公開は行われません。比較可能な母集団が見つからない場合は引き続き利用不可となり、要求時には 既存の厳密調査の承認フローが適用されます。このツールでバンドルを読み取れるようにするには、バックエンドと Web の読み取り機能、 および明示的にレビュー済みのアーティファクトを事前に用意する必要があります。この変更によって公開ジョブが有効になることはありません。

単一取引所 Hyperliquid 調査（2026-09-15、ローカル）

最初の取引所横断レプリケーションの範囲では、API v1 のユニバース読み取りに exchange=hl を追加し、MCP の list_instruments に exchange: "hl" を追加します。省略した場合は引き続き Binance が選択されます。厳密なレコード文書では、["identity.exchange", "eq", "hl"] を使って HL を指定し、btc などの小文字の ID を記録します。1 つの文書で指定できる取引所は 1 つだけです。検証済みの機能対応範囲が重なる場合は、ペア定義を別々に実行してください。Binance の正規ハッシュ、デフォルトスコープ、結果のバイト列は変更されません。

日次／統合読み取り、クエリ／ベースライン／コホート／有病率／層別／取引のラッパー、ページ設定のハイドレーション、リビジョンチェックは、選択した取引所に従います。存在しない機能は引き続き存在しないものとして扱います。マニフェストで確立されていない HL メタデータは不明のままです。この範囲では、HL のライブモニタリングおよびリプレイ／ワークベンチへの引き継ぎは利用できません。結果先行、スナップショット、散文形式の準備、名前付きスコープ、UI での取引所選択は引き続き個別のゲートです。レコードの検証だけを根拠に、これらの箇所で HL がサポートされていると推測しないでください。

提供順序は、バックエンド、Web API／バリデーター、MCP です。ソースの抽出、データセットの昇格、キャプチャの変更、本番リリースは行われていません。ローカルでの BTC 9 月 12 日の証明と継続担当者は、タスクハブの正規ファイル tasks/research-cross-venue-replication.md および outputs/cross-venue-20260915/ に記載されています。

スタディウィジェット（ローカル、ホスト版リリース待ち）

run_scan、run_cohort、run_stratified は、ネットワークを使用しないウィジェットを共有します。prepare_study.summary をそのまま、厳密なクエリドキュメントの外側にある任意の study_summary に渡します。以前の呼び出し元には、節とスコープを忠実に示す見出しが表示されます。見出しには、明示された結果、発生件数、スキャンしたシンボルが保持されます。

任意の measure で、種類、方向、大きさ、期間を設定できます。設定しない場合、利用可能であれば 24h から開始し、どちらの方向でも発生件数が 30 件以上ある、終値リターンの段階のうち 1% を超える最大のものを選びます。条件に合うものがなければ、分布を表示し、読者に値動きを選択するよう促します。この表示上の選択は、有意性を示す証拠ではありません。すべてのコントロールは、処理済みの結果バイトを読み取ります。

結果の概要セクションでは、選択した結果の正確な件数、観測された分母、割合を使った平易な文章を最初に示します。結果が欠落している場合はその件数を報告し、可能な場合は正確な参照比較をパーセントポイントで示し、それ以外の場合は比較できない理由を示します。タッチの結果では、両方向が発生する可能性があり、その順序は不明であるという注意書きを維持します。これは記述的な証拠であり、成功や確信度のスコアではありません。結果が明示されていない場合は、終値の両方向を示し、探索的な表示であることを明記します。

期間または値動きのラベルを変更すると、概要に探索中であることが示されます。明示された結果に戻すと、リクエストを送信せずにこれら 2 つのコントロールが復元されます。層別の概要には、表示中のグループが記載されます。文言は処理済みの件数から決定的に生成され、新たなモデル呼び出しやエンジンの計算は行われません。

デフォルトの表示は、判定、「優位性はあるか？」ボックス、そして 1 つの図です。選択した値動きの大きさについて、セットアップ後の各方向と通常の割合（参照値）を、正確な件数付きで、同じスケール上の対になった棒グラフとして示します。MFE、リフト、参照値に関する専門用語は避けます。件数を文章で示したもの、リフトを含む両方向の情報、ヒストグラム、経路の段階は、1 つの折りたたまれた詳細表示にまとめられています。

ヒストグラムには記録されたすべてのバケットが保持されます。ホバー、フォーカス、タップのいずれでも、選択した帯がミント色で強調表示され、正確な件数と割合がチャート下の読み取り欄に表示されます。チャート全体が 1 つの Tab 停止位置となり、左右の矢印キーで帯を移動し、Home/End で両端に移動できます。空の帯も選択でき、リクエストは発生しません。すべての件数は展開可能なテーブルにも表示されます。整合する参照値は重ねて表示され、コンパクトな MFE/MAE の段階表示には同じ期間が使われます。参照値がない場合はその理由を示し、リフトは両方の正確な割合があり、参照値の割合がゼロでない場合にのみ表示されます。コホートでは、条件が偽の場合の比較を正確にラベル付けします。層別表示では、分割値の読み取りが欠落しているグループも含む 3 つのグループすべてを保持し、参照値を捏造しません。

拒否されたドキュメントでは、HTTP の状態、コード、メッセージが、チャートの証拠を省略するホストとは別に表示されます。エンジン、research_query.v2、正規バイト列、プロジェクション、認証、課金の動作に変更はありません。リリースと実際の Claude ホストでの受け入れは、James の承認待ちです。

コンパクトなスキャンテキスト（ローカル、リリース必須）

デフォルトの run_scan テキストでは、合意された結果、両方向、カウント対象の母集団、制限事項を先に示します。指定がない場合は、探索用の段階を24時間として、合意された結果と反対方向を正確に表示し、すべての期間の存在数と不在数を維持します。一致した市場の上位3件と1行の例も引き続き表示されます（rows で追加をリクエストできます）。どちらも分母ではありません。

参照範囲の一覧が長い場合は、ラベル付きのレシートも付属します。長い文字列の in リストは、明示的に実行不可能な query_preview レシートに変換されます。レシートには、件数、リストをソートした結果（重複を保持）の UTF-8 JSON の SHA256、およびソート後の先頭5件の値が含まれます。繰り返される行のエビデンスは、同じリストハッシュを参照します。結果の例では、バケットの存在数も含め、表示対象の期間を維持します。UTC の日次一致件数は、最初と最後の一致日、およびピーク日（同数の場合は最も早い日）を付した月次合計になります。一致日は、有効な特徴量の利用可能期間を示すものではありません。このレスポンスには、述語の初回データ日付は含まれません。

2,000文字を超える正確なワークベンチ URL は、コンパクトテキストでは明示的に省略されます。ハッシュのみの URL や永続的な定義の検索は保証されません。元の承認済みツール入力はそのまま保持され、full_counts: true により正規の結果、完全な定義、日次件数、完全な引き継ぎ情報が復元されます。full_outcomes: true により、詳細な結果ビューが復元されます。ウィジェットはエビデンス全体を保持します。エンジンへのリクエスト、正規ハッシュ、計測、ベースライン予算に変更はありません。テキスト形式と期間の変更には、それぞれ異なる投影 ETag が割り当てられます。この範囲を限定した追加対応では、コホート、層別化、継続の各テキストは既存の投影を維持します。

ある動きに関する保存済みの解釈（2026-10-03、ローカル）

get_investigation_assessment({id, edition?}) は、調査ページやチャネルの下書きで使用される既存の公開済み評価を読み取ります。公開 ID は /research/investigate/publication/<id> リンクから取得します。これは、get_investigation_bundle が受け付ける SHA256 バンドル ID とは別のものです。結果には、対象市場、期間／基準時点、モード、エビデンス参照、ギャップ、比較可能性、版が正確に保持されます。固定された版に変更があった場合は409が返され、修正されたエビデンスがある場合は410が返されます。公開を停止して再開してください。元の質問に対して、別の版を暗黙に適用してはいけません。非公開の下書きは公開されません。この読み取りでは research:read を使用し、調査の利用枠を消費せず、評価の生成やモデルの呼び出しも行いません。ホストは不確実性を保ちながらエビデンスを解釈できます。測定値の引用は因果関係の証明ではありません。このツールを使用する前に、Web の /api/v1/research/investigation-assessment リーダーをデプロイしてください。

プライベートな戦略調査（ローカル拡張、リリース保留中）

調査サブスクライバーは、ウェブ版の /research/strategies ワークスペースと同じ、バージョン管理された長期ベースライン、持続性および実行調査を利用できます。この最初の v2 コントラクトは、条件を満たす5分足 OHLC、クオートボリューム、実際に決済されたファンディングに基づく、最初の1時間のロングのベースブレイクに対応します。同じ日付範囲におけるリッチ機能やティックリプレイの対応を意味するものではありません。従来の run_trade_test も引き続き利用できます。

• get_strategy({catalog:true}) では、正確なソースリビジョン、対象市場、上限を確認できます。引数なしでは非公開の定義と試行を一覧表示し、id ではジョブの進行状況を、id,result:true では完了済みの不変な結果を読み取ります。
• prepare_strategy({document}) は、明示的な trade_query.v2 を保存も実行もせずに検証し、見積もりを作成します。すべての必須フィールドを設定するには、ウェブの正確な定義ビューまたはツールスキーマの説明を使用してください。数値例は検証ではありません。
• save_strategy({document,name,revisit_of?}) は、アカウント所有の定義を保存します。後続のエビデンスリビジョンでは、結果を上書きせずに前の定義を参照します。
• run_strategy({document,confirmation,attempt,units,name,revisit_of?}) を実行するには、返された定義、対象範囲、コスト、ファンディング規約、見積もりを人間が正確に承認する必要があります。返された値はすべて変更せずに送信してください。モデルによる表明やハッシュは同意にはなりません。進行状況を確認するには get_strategy をポーリングしてください。キューに入った応答を完了済みの結果として扱ってはいけません。
• cancel_strategy({id}) は、所有者によるキャンセルを要求します。終端状態の cancelled を待ってください。その試行は履歴に残ります。削除やモニタリングの変更は行いません。

変更操作には、Research の利用資格に加えて、任意の research:strategies OAuth／キー権限が必要です。既存のデフォルトは引き続き読み取り／解釈です。読み取り／見積もりには research:read を使用します。完了済みの非公開エビデンスは、利用期限切れ後も読み取り可能です。新しい作業では試行ごとに利用枠を一度だけ予約し、重複読み取りやキャッシュ済みの読み取りは無料です。また、既知の失敗またはキャンセル済みの試行は返金されます。完了が不明確な場合は、同じ予約が維持されます。再試行する前に元のハッシュを読み取ってください。終端状態になった試行を再試行するには、新しい見積もりと明示的な承認が必要です。どのツールも、ライブモニタリングや取引を有効化しません。

すべてのポリシーで、同じ機会母集団、判断、絶対期間を使用します。2.5%の押し目は、注文送信時点で固定された直近の確定高値を基準とします。リクレイムには確定終値と次のバーでの約定が必要です。約定なし／スキップされた行は既知の損益ゼロとして数えます。一方、価格／ファンディングが不明な行は、明示的に除外されたままです。ファンディングには、ラベル付けされた LB1 の固定想定元本による決済近似を使用します。リスク単位とエクスポージャーはポートフォリオリターンではありません。マイナスの結果も有効なエビデンスです。

デフォルトでは、get_strategy(result:true) は、全結果の要約、ペア比較、カバレッジ、正確なクエリ、再現性に関するフィールドをすべて保持し、機会／取引の例は10件のみ表示します。これらの例は分母ではありません。full:true を指定すると、完全な正規レスポンスと ETag が復元されます。コンパクトな投影では ETag が削除されます。

リリース順序と受け入れ確認：バックエンドの docs/RESEARCH_STRATEGIES_V2.md、次にウェブの docs/RESEARCH_STRATEGIES.md、最後に MCP。この実装では、320,262件のジャーナル比較全体で不一致ゼロのまま、LB1 の14,563件すべての機会を再現し、公開ハンドラーを介した条件付きエントリーも個別にテストしています。ブートストラップには明示的にバージョンを付与し、NumPy の区間バイトとの同一性は主張していません。ローカルのウェブブラウザーでのチェックでは、ラベル付きフィクスチャを使用しています。デプロイ済みアカウントでの受け入れ確認と支払い意思については、引き続き検証が必要です。これらのチェックをもって本番リリースを意味するものではありません。