MarketTrace Crypto MCP

MarketTrace agent-feed

AI エージェント向けの読み取り専用暗号資産無期限先物のマイクロストラクチャー — すべての指標にカバレッジと鮮度を明示した、取引所横断の正規化済み市場状態です。事実と正規化データを提供し、判断は示しません。解釈はエージェントに委ねます。

• ホスト型 MCP：https://api.markettrace.ai/mcp（Streamable HTTP、OAuth — API キー不要）
• 公式レジストリ：ai.markettrace/agent-feed
• ドキュメント：https://markettrace.ai/agents

このリポジトリは入口であり、接続設定、インターフェースの仕様、簡易な stdio ブリッジを提供します。データパイプライン自体（4 取引所からの取り込み、アーカイブ、正規化）はオープンソースではありません。

---

提供する内容

Binance、Bybit、OKX、Hyperliquid の 9 資産（BTC、ETH、SOL、BNB、XRP、DOGE、HYPE、ZEC、ENA）：

ツール	回答する内容
get_market_state	正規化された単一のスナップショット：ファンディングレートと過去 2 年間のパーセンタイル、OI、出来高、CVD、オーダーブックの不均衡、清算、ベーシス、要因。「ETH のポジションは偏りすぎていますか？」
get_funding_percentile	現在のファンディングレートを、過去 2 年間の推移に照らして順位付けした値（0–100）と、同符号の連続期間。
get_liquidations_recent	指定期間の取引所横断の清算額推定：USD、ロング／ショートの内訳。
get_ohlcv	取引所横断で統合されたローソク足（5m…1d）。ローソク足ごとのデルタ（テイカー買い − テイカー売り）を含み、ATR、値幅、CVD、RV の計算に利用できます。
get_conditional_outcomes	指定した条件の後に測定された将来リターンの履歴 — 通説ではなく基本発生率を示します。「ファンディングレートが 90 パーセンタイルを上回った後、過去には何が起きましたか？」
get_state_history	15 分間隔のアーカイブから、任意の数値状態フィールドの時系列を取得します — スナップショットを補完するトレンド表示です。
get_volume_profile	統合テープから算出した UTC 日ごとの出来高プロファイル水準：POC、バリューエリアの上限／下限、バリューエリアの幅とその順位、複数日分の複合プロファイル、ネイキッド POC。「価格は昨日のバリューエリア内にありますか？」
get_big_trades	大口のアグレッシブ注文（同じ取引所、売買方向、タイムスタンプの約定を合算して 1 件の取引としたもの）：売買方向別の合計と、取引所、価格、USD 建てサイズを含む最大の約定。「クジラの成行注文は買いと売りのどちらでしたか？」
get_footprint_events	1 分足フットプリントから取得したオーダーブックの壁イベント：ピーク、約定、終値時点のサイズを USD 建てで示す吸収された壁と取り消された壁、および板が薄い時間帯。「この下落の前に買い板の壁は取り消されましたか？」
get_stacked_imbalances	統合テープから取得したフットプリントの積み上げ不均衡：ローソク足（1m…1h）ごとの対角方向の買い・売りの連続。価格帯と USD 建てサイズを含みます。「今朝、BTC でアグレッシブな買い手が積み上がったのはどこですか？」
help	サーバー自体のガイド：回答する質問ごとに整理されたすべてのツール、それぞれの実行可能な呼び出し例、シンボル、スケールの読み方、制限、専用ツールのないデータ（建玉、CVD、ファンディングレート）の参照先。「建玉を取得できるツールはどれですか？」

**データ：**ファンディングレート、建玉、累積出来高デルタ（CVD）、オーダーブックの厚み、清算、ローソク足ごとのデルタを含む OHLCV、出来高プロファイル水準、大口のアグレッシブ注文、オーダーブックの壁イベント、フットプリントの積み上げ不均衡。

**誠実性モデル：**すべての指標には coverage エントリ（取引所、ウィンドウの深さ、鮮度）が含まれます。履歴が少ない場合は、数値を捏造せず、開示された深さに基づいて回答します。条件付き結果は、エビデンスの最低基準を下回る場合 history_silent になります。すべてのレスポンスでデータの経過時間を明示します。予測ではなく、履歴を報告します。

接続

Claude（ウェブ／デスクトップ）： Settings → Connectors → カスタムコネクターを追加 → https://api.markettrace.ai/mcp → 認証（メールのマジックリンク）。

どのクライアントでも、サインインの方法は同じです。ブラウザーが開くので、メールアドレスを入力するとサインインリンクが届きます。開始したときと同じデバイス、同じブラウザーでリンクを開いてください。

Claude Code（サーバーを追加しただけではサインインされないため、両方を実行してください）：

claude mcp add --transport http markettrace https://api.markettrace.ai/mcp
claude mcp login markettrace

Codex：

codex mcp add markettrace --url https://api.markettrace.ai/mcp
codex mcp login markettrace

Cursor： これを ~/.cursor/mcp.json に追加し（または https://markettrace.ai/agents で Cursor に追加 を使用し）、Cursor のプロンプトに従ってサインインしてください：

{
  "mcpServers": {
    "markettrace": { "url": "https://api.markettrace.ai/mcp" }
  }
}

Stdio のみのクライアント（標準の OAuth 対応ブリッジを使用）：

npx -y mcp-remote https://api.markettrace.ai/mcp

その他のクライアント設定は examples/mcp-configs.md をご覧ください。

ローカル Stdio ブリッジ（このリポジトリ）

mcp_server.py は依存関係ゼロの Stdio ブリッジです。認証情報がなくても起動し、イントロスペクション（initialize、tools/list）に応答します。付属の tools.json は、ホストサーバーの契約内容をスナップショットとして保存したものです。MARKETTRACE_BEARER が設定されている場合、ツールの呼び出しはホストされたエンドポイントにプロキシされます。設定されていない場合は、データではなくホストされた OAuth エンドポイントへのリンクを返します。メソドロジーは持たず、クライアントとしてのみ機能します。

契約を更新する： tools.json は、稼働中サーバーの tools/list の {version, generated_at, tools} スナップショットです。その応答を取得し、現在の契約バージョンを付与して再生成してください（get_market_state の feed.version と同様です）。

python3 mcp_server.py            # Python 3.9+, no dependencies

または、Docker を使用します：

docker build -t markettrace-bridge . && docker run -i markettrace-bridge

質問の例

• 「BTC の市場状況はどうですか？ ポジションは偏りすぎていますか？」
• 「ファンディングが90パーセンタイルを超えた後、過去には何が起きましたか？」
• 「過去3日間で建玉はどのように積み上がりましたか？」
• 「過去1時間に ETH でどれだけ清算されましたか？ ロングとショートのどちらですか？」
• 「BTC の主要な出来高水準はどこですか？ 近くに未検証の POC はありますか？」
• 「過去1時間に SOL で大口の指値注文が吸収されましたか？」

利用条件

市場データの提供のみを目的としています。金融アドバイスではありません。 プライバシーポリシー · 利用規約 · お問い合わせ：[email protected]

このリポジトリのブリッジは MIT ライセンスです（LICENSE）。ホストサービスには上記の利用規約が適用されます。