Coinversaa Pulse

Coinversa Pulse — MCP サーバー

AI エージェント向けの暗号資産インテリジェンスです。MCP 対応クライアントから、Hyperliquid の全ウォレット、損益の帰属情報付きでインデックス化された取引履歴、行動コホート、リアルタイムの市場データを照会できます。pulse_global_stats を呼び出すと、現在の正確なカバレッジ（追跡中のウォレット、インデックス化された取引、取引高、損益、データ期間）を確認できます。

HIP-4 アウトカムコントラクトと builder dex に対応 — 予測市場形式のアウトカムコントラクト、決済、コモディティ（金、銀、石油）、株式（TSLA、AAPL）、および 8 つの dex と 369 以上の市場にわたる無期限先物を確認できます。

0.12.0 の新機能

L4 オーダーブックツールとデータセットのカバレッジ。 ツールが 5 つ増え、ホスト型コネクターと完全に同等になりました（https://mcp.coinversa.ai/mcp）。

新しいツール	回答できる質問
book_summary [Pro]	「現在、コイン X の板に残っている注文はどのような状態ですか？　深さ、スプレッド、偏りは？」
book_levels [Pro]	「板に残っている注文数量は、各価格レベルにどのように積み上がっていますか？」
book_whales [Pro]	「最も大きな残存注文を保有しているウォレットはどれですか？　買い側と売り側のどちらですか？」
book_stop_map [Pro]	「相場が動いたときに執行されるトリガー注文は、どこに集中していますか？」
data_coverage	「各データセットがカバーする期間と、データの鮮度を教えてください。」

ツール数：103 → 107 登録済み、106 公開（下記参照）。

0.12.0 でのその他の変更：

• builder_heatmap はデフォルトで非公開です。 上流側の集計データがバックフィルされるまでは、クライアントのタイムアウト時間内に応答できないため、公開するとタイムアウトが発生するだけでした。このツールは引き続き組み込まれています。すべてのツールを公開するには COINVERSAA_HIDDEN_TOOLS=（明示的に空）を設定するか、公開しない別のツールをカンマ区切りで指定してください。この環境変数を設定しない場合は builder_heatmap が非公開になります。
• pulse_market_overview を削除しました。 list_markets の非推奨エイリアスでした。市場の検索には正式なツールである list_markets を使用してください。
• 説明とパラメーターをホスト型コネクターに同期しました。 20 個のツールの説明と 7 個の入力スキーマに差異が生じていました。live_mark_dislocations、pulse_cohort_bias_history、pulse_cohort_performance_daily、hip4_outcomes、hip4_trader_outcomes、pulse_lifecycle に、ホスト型コネクターにはすでにあったページネーションとフィルターパラメーターを追加し、live_coin_risk_history には include を追加しました。

0.11.1 の新機能

ビルダーのユーザーライフサイクル、ジャーニー、ヒートマップ、注文意図の分析。 同じビルダー手数料データを対象に、ツールが 4 つ増えました。ビルダーのユーザーが現在どのような状態にあるか、新しいウォレットをどれほど速く収益化するか、そのフローが実際にいつ取引されるか、注文発注時にユーザーが何を意図しているかを確認できます。

新しいツール	回答できる質問
builder_journey [Pro]	「ビルダー X は新規ユーザーをどれほど速く、またどれほどばらつきのある形で収益化しますか？」
builder_lifecycle [Pro]	「ビルダー X のユーザーのうち、現在もアクティブなのは何人ですか？　また、競合に奪われたユーザーは何人ですか？」
builder_heatmap [Pro]	「ビルダー X の取引高がピークになる時間帯はいつですか？　また、リリースに適した時間帯はいつですか？」
builder_orders [Pro]	「ビルダー X のユーザーはストップ注文や利確注文を発注しますか？　また、注文フローのうち実際に約定するのはどの程度ですか？」

ツール数：99 → 103。

0.11.1 でのその他の変更：

• ツールのタイトルとアノテーション — すべてのツールに、人が読める title と MCP アノテーション（readOnlyHint: true、destructiveHint: false、idempotentHint: true、openWorldHint: true）が付くようになりました。クライアントはツールにラベルを付け、確認を求めずに読み取り専用として扱えます。
• ホスト型コネクターとの同等性 — このパッケージで提供されるツールセットが、ホスト型 OAuth エンドポイント https://mcp.coinversa.ai/mcp で提供されるものと完全に一致するようになりました。このリポジトリにあった、ヘッダー認証を使用する旧 HTTP エントリーポイントは削除しました。接続方法は 2 通りあります。詳しくはクイックスタートを参照してください。

0.11.0 の新機能

ビルダー分析 — 新しいツールを 8 つ追加（91 → 99）。 Hyperliquid のビルダーコードの経済圏（フロントエンド、ウォレットアプリ、ボット、ビルダー DEX がルーティングされた注文フローから得る手数料）が、主要なツールファミリーとして利用できるようになりました。

• builder_leaderboard — オンチェーン台帳の正確な収益額によるビルダーランキング。帰属する取引高／ユーザー数と前期間との差分付き（Starter）
• builder_profile — 1 つのビルダーの収益、日次推移、取引高上位のコイン、利益を上げているユーザーの割合（Starter）
• builder_traders — ビルダー経由で取引するウォレット。取引所全体のコホート階層付き（Pro）
• builder_fills — ビルダー経由の個々の帰属済み約定。perp／spot／HIP-4 対応（Pro）
• builder_cohorts — ビルダーのユーザーベースを行動階層別に分類（Pro）
• builder_retention — 月次の新規ユーザー維持率を示す三角表（Pro）
• builder_overlap — このビルダーのユーザーが他にどのビルダーを利用しているか（Pro）
• trader_builders — あるウォレットが取引に利用するすべてのビルダー。支払った手数料別（Starter）

収益は Hyperliquid 独自の累積ビルダー手数料台帳（オンチェーンで照合済み）から算出します。約定レベルの詳細は注文から約定への帰属情報に基づき、すべての応答で対象範囲について正直に説明しています（dataNotes）。エージェントに 「MetaMask のトレーダーは、他にどのフロントエンドも使っていますか？」 と尋ねてみてください。この質問に答えられるデータソースは他にありません。

0.10.0 の新機能

コホート階層で 2 種類の語彙に対応。 階層を入力するすべての場所で、新しい正規階層スラッグを利用できます。PnL 階層（apex、sharps、grinders、scrapers、crowd、bleeders、trapped、blown_out）と、ポジションサイズ階層（heavyweights … strawweights）に対応しています。従来のスラッグ（money_printer、smart_money、…）も引き続き利用できます。応答に変更はありません。後方互換性を破る変更はありません。

0.9.0 の新機能

エンティティ解決、階層対応セッション、チェーン検証済みの回答。

新しいツール	回答できる質問
pulse_entity_profile [Pro]	「このウォレットの所有者は誰で、すべてのサブアカウントを合算した実際のポジションはどうなっていますか？」
pulse_entity_leaderboard [Pro]	「ウォレットではなく所有者単位で重複を除いたトップトレーダーは誰ですか？ 35 個のサブアカウントを運用するファンドも、1 つのエンティティとして表示されます。」
pulse_my_plan	「この API キーのプラン、利用上限、アップグレードで利用可能になる機能は何ですか？」
pulse_exchange_volume	「24 時間の取引高は？ 合計と DEX 別の内訳は？（ビルダー DEX は約 43％を占めますが、多くのトラッカーは対象にしていません。）」
pulse_exchange_oi	「DEX 別の未決済建玉と、ロング／ショートの内訳は？」
pulse_active_traders	「過去 24 時間に取引したウォレットはいくつありますか？」
pulse_exchange_positions	「現在、DEX ごとにいくつのポジションが未決済ですか？」
pulse_pnl_leaders	「過去 24 時間に、取引所全体で最も利益を上げた人、最も損失を出した人は誰ですか？」

0.9.0 のその他の変更：

• 階層対応エラー — 階層制限またはレート制限に達したリクエストでは、呼び出し元の階層、必要な階層を説明し、アップグレード用の直接リンクを提示するようになりました。（有効な無料プランのキーが Pro エンドポイントで「拒否された」と表示される問題を修正しました。）
• 検証済み状態とチェーン状態の記録 — エンティティの応答に、最後に照合したチェーン状態のブロックが含まれるようになりました。

ツール数：83 → 91。

0.8.0 の新機能

ポジションのライフサイクル、執行品質、トレーダーの類型。 v0.8.0 では、全面的に再導出したポジション・ライフサイクルのデータセットを基盤とする 28 個のツールが追加されました。オンチェーンの約定から、すべての建て→決済サイクルを再構築し、各ポジションで記録された最悪の逆行価格と最良の順行価格を示す MAE/MFE を含めています。これにより、PnL だけでなく、執行品質も分析できるようになります。

新しいツール	わかること
pulse_trader_lifecycles	「このウォレットのすべての建て→決済ポジションを、エントリー／決済価格と保有時間とともに表示する。」
pulse_trader_lifecycle_summary	「このウォレットのポジション単位の統計（勝率、平均保有時間、最大の勝ち／負け）は？」
pulse_lifecycle	「ライフサイクル 12345 を、その構築と解消に関わったすべての約定に分解する。」
pulse_trader_demo	「詳しく調べる前に、ウォレットの概要を手早く確認する。」
pulse_wallet_drawdown_curve	「このウォレットの各ポジションは、利益が出るまでにどこまで含み損になったか？」
pulse_max_pain_events	「回復するまでに最も深いドローダウンに耐えた勝ちポジションは？」
pulse_perfect_exits	「最大順行幅のうち、最も多くを確保できた決済は？」
pulse_backstop_events	「個別の清算のうち、最も壊滅的だったものは？」
pulse_survivors / pulse_anti_survivors	「破綻から回復したのは誰で、回復できなかったのは誰か？」
pulse_persistent_winners	「一度の幸運ではなく、複数の異なる月で利益を上げているのは誰か？」
pulse_capital_titans	「支払った手数料 1 ドルあたりの PnL が最も大きいのは誰か？」
pulse_one_month_wonders	「一か月で大きく稼いだ後、その利益をすべて失ったのは誰か？」
pulse_newcomer_whales	「最近参入したばかりなのに、すでに大きな名目額で取引しているのは誰か？」
pulse_coin_kings	「各コインで最も稼いだのは誰か？」
pulse_top_liquidators	「他者を清算して最も利益を得ているのは誰か？」
pulse_lethal_coins	「最も多くの人を破綻させているコインは？」
pulse_coin_alpha_map	「コインごとの勝者と敗者の利益プールの規模は？」
pulse_hour_profitability	「決済時刻の UTC 時間帯のうち、最も利益が出るのは？」
pulse_market_concentration	「アルファはどれほど集中しているか。上位 1% がすべてを手にしているか？」
pulse_style_distribution	「スキャルパーとスイングトレーダーでは、どちらがより多く稼いでいるか？」
pulse_compare	「直接対決：A と B のどちらが優れたトレーダーか？」
pulse_cohort_recent_*	「今まさに利益を上げているウォレット（直近 30 日の階層）は、どのような取引をしているか（ポジション、取引、上位ライフサイクル、集中度）？」
pulse_lifecycles_recent	「取引所全体で、たった今決済されたのは何か？」（グローバルフィード。pulse_recent_closed_positions の後継）

従来の決済済みポジション用ツール（pulse_trader_closed_positions、pulse_trader_closed_position_stats、pulse_recent_closed_positions）は後方互換性のために維持されていますが、修正済みの position_lifecycles_full テーブル（より豊富な履歴、MAE/MFE、スポット）を読み取るライフサイクルツールが、これらに取って代わります。

ツール数：55 → 83。すべてのツールで API キーが必要です。利用できるツールと制限は、バックエンドのティアによって決まります。

0.7.0 の新機能

HIP-4 のアウトカム契約インテリジェンス。 v0.7.0 では、アクティブなアウトカムの検索、質問メタデータの読み取り、決済と直近の約定の確認、日次出来高の追跡、アウトカムトレーダーのランキング、アウトカムとパープの重複状況の測定、同じ原資産についてアウトカム保有者と現在オープン中のパープポジションを紐付けるためのツールを12個追加しました。

新しいツール	回答する内容
hip4_outcomes	「現在アクティブなアウトカム契約は何ですか？」
hip4_outcome	「アウトカム123とは何ですか？また、どのサイドトークンを使用しますか？」
hip4_outcome_summary	「このアウトカムの両サイド全体で、出来高／損益はいくらですか？」
hip4_outcome_recent_trades	「この予測市場の直近の約定を表示してください。」
hip4_questions	「どのようなHIP-4の質問と名前付きアウトカムがありますか？」
hip4_recent_settlements	「最近決済されたアウトカムと、勝ったサイドを教えてください。」
hip4_daily_volume	「HIP-4のアウトカム出来高は日ごとに増加していますか？」
hip4_most_active	「最も活発なアウトカム契約はどれですか？」
hip4_top_traders	「トップアウトカムトレーダーは誰ですか？」
hip4_trader_outcomes	「このウォレットはどのアウトカムを取引しましたか？」
hip4_cross_product_overlap	「アウトカムトレーダーとパープトレーダーの重複はどの程度ありますか？」
hip4_perp_position_context	「アウトカム25のトレーダーは現在、BTCパープのエクスポージャーを保有していますか？それは同じ方向ですか、それともヘッジされていますか？」

ツール数：43 → 55。すべてのツールにAPIキーが必要です。バックエンドのティアによって、利用できるツールと上限が決まります。coinversa.ai/developers でキーを取得してください。

0.6.0 の新機能

市場をまたいだ標準アセット分類。 同じ原資産が、取引所によって異なるティッカーで表示されることがあります（例：xyz の GOLD と Hyperliquid ネイティブの PAXG は、どちらも金に連動しています）。v0.6.0 では、サーバー側で同義語を解決して取引所をまたいだ集計を行うツールを3個追加し、さらに実際のOIを取得するツールを追加しました。

新しいツール	回答する内容
list_assets	「利用可能なアセットは何ですか？2つ以上の取引所に上場しているものはどれですか？」
list_asset	「GOLDはどこで取引されていますか？PAXGはGOLDと同じですか？」
pulse_cross_market_asset	「金のポジションはxyzとhynaのどちらでより偏っていますか？DEX間でBTCの方向性に意見の食い違いはありますか？」
live_official_oi	「Hyperliquid自体が報告するBTCのOIはいくらですか？こちらの数値と一致していますか？」

組み込み済みの同義語：PAXG → GOLD、XAUT → GOLD、XAGT → SILVER。プレフィックスによるグループ化（BTC ≡ flx:BTC ≡ hyna:BTC）は自動的に行われます。

その他の0.6.0の整理：デフォルトのAPI URLを本番環境に設定しました。古くなった「710K+ウォレット／1.8B+取引」というハードコードされたマーケティング数値を削除しました（現在のカバー範囲は pulse_global_stats を呼び出して確認してください）。pulse_market_overview は、標準の list_markets の非推奨エイリアスとして残しています。

クイックスタート

接続方法は2通りあります。どちらもデフォルトで利用できる同じ106個の読み取り専用ツールを提供し、Coinversa APIキー（cvsa_...）が必要です。キーなしで利用できるティアはありません。

方法	場所	認証	最適な用途
ホスト型リモート MCP（推奨）	https://mcp.coinversa.ai/mcp	ブラウザーで OAuth 2.1 を使用 — クライアントでキーを扱う必要はありません	Claude.ai、Claude Desktop、Claude Code、Cursor、ChatGPT、Perplexity、およびすべての Streamable HTTP クライアント
ローカル stdio MCP（このパッケージ）	npx -y @coinversaa/[email protected]	COINVERSAA_API_KEY 環境変数	Codex などの stdio 専用クライアント、エアギャップ環境、開発

常に最新の標準クライアントガイドは docs.coinversa.ai/mcp/setup にあります。以下のスニペットはその内容に準拠しています。

ホスト型リモート MCP（OAuth）

URL をクライアントに貼り付け、認証／ヘッダーの各フィールドはすべて空欄にしてください。クライアントが OAuth フローを自動検出し、ブラウザーで Coinversa の認証ページを開きます。そこで、次のいずれかを行います。

• Sign in / Sign up & get a key をクリックします。ポップアップで開く開発者ポータルでキーを選択する（または自動作成する）と、1 回限りの接続コードが認証ページに返されます。この方法では、キーそのものが MCP サーバーに渡ることはありません。または
• 既存の cvsa_ キーを直接貼り付けます。

Authorize をクリックすると接続されます。新規アカウントはクレジットカード不要で、Pro を 14 日間利用できます。開発者ポータルでキーを取り消すと、そのキーで認証したすべてのエージェントが即座に切断されます。

Claude.ai（ウェブ）

1. claude.ai/customize/connectors?modal=add-custom-connector を開きます。
2. Name： Coinversa — URL： https://mcp.coinversa.ai/mcp。認証フィールドは空欄のままにします。
3. Add、次に Connect をクリックします。Coinversa のページでサインインし、Authorize をクリックします。
4. 新しいチャットで 「Coinversa Pulse の全世界の取引統計を教えてください」 と尋ねます。Claude が pulse_global_stats を呼び出すはずです。

Claude Desktop

Claude Desktop は stdio のみをサポートしているため、stdio と HTTP を橋渡しし、OAuth の一連の処理を行う mcp-remote シムを使用します。設定ファイルを編集します。

OS	パス
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json
Linux	~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "coinversa": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.coinversa.ai/mcp"]
    }
  }
}

Claude Desktop を完全に終了してから、再起動します。初回接続時に mcp-remote がブラウザーで Coinversa の認証ページを開くので、サインインして Authorize をクリックします。

Cursor

Cursor は HTTP MCP サーバーを標準でサポートしています。~/.cursor/mcp.json（またはプロジェクト内の .cursor/mcp.json）に追加します。

{
  "mcpServers": {
    "coinversa": {
      "url": "https://mcp.coinversa.ai/mcp"
    }
  }
}

Cursor を再起動し、ブラウザーに表示される認証プロンプトを承認します。developers.coinversa.ai/connect にあるワンクリックの Install in Cursor ディープリンクも使用できます。

Claude Code

claude mcp add --transport http coinversa https://mcp.coinversa.ai/mcp

次に Claude Code 内で /mcp を実行し、coinversa の Authenticate を選択します。ブラウザーでの手順は上記と同じです。

ChatGPT、Perplexity、その他のリモートクライアント

カスタムコネクター／リモート MCP サーバーを追加し、URL に https://mcp.coinversa.ai/mcp を指定します。ヘッダーは設定しません。初回利用時に、クライアントが Coinversa の認証ページを開きます。

ローカル stdio MCP（npx + API キー）

stdio のみをサポートするクライアント（Codex など）を使う場合や、キーを自分で管理したい場合は、この npm パッケージをローカルで実行してください。開発者ポータルからキーを取得します。

{
  "mcpServers": {
    "coinversa": {
      "command": "npx",
      "args": ["-y", "@coinversaa/[email protected]"],
      "env": {
        "COINVERSAA_API_KEY": "cvsa_your_key_here"
      }
    }
  }
}

または、シェルから実行します。

COINVERSAA_API_KEY=cvsa_... npx -y @coinversaa/[email protected]

これにより、OAuth ではなく環境変数のキーで認証し、同じツールを stdio 経由でローカル実行します。COINVERSAA_API_KEY が設定されていない場合、stdio サーバーは起動時に終了します。クローンもビルドも不要です。すべて npx が処理します。

動作確認

エージェントに 「Coinversa Pulse を使って、今週の総 PnL で Hyperliquid のトレーダー上位 5 人を表示してください」 と尋ねます。ランキングされたアドレスとともに pulse_leaderboard の呼び出しが表示されます。pulse_my_plan では、接続中のキーが利用しているプランと、各ティアで利用可能になる機能を確認できます。エージェントが 401 を報告した場合は、認証の有効期限が切れているか、キーが取り消されています。コネクターに再接続すると、認証ページが再び開きます。

ホスト型リモート MCP

エンドポイント： https://mcp.coinversa.ai/mcp — ステートレスなストリーミング可能な HTTP です。各 POST /mcp は 1 つの JSON-RPC リクエスト（またはバッチ）を送信し、その接続上で応答を受け取ります。再開するサーバー側セッションはないため、GET /mcp と DELETE /mcp は 405 Method Not Allowed を返します。SSE エンドポイントはありません。

エンドポイント	メソッド	目的
/mcp	POST	MCP ストリーミング可能な HTTP エンドポイント（有効な OAuth アクセストークンが必要です）
/health	GET	ヘルスチェック — { ok, name, version } を返します
/.well-known/oauth-authorization-server	GET	OAuth 2.1 認可サーバーのメタデータ（RFC 8414）
/.well-known/oauth-protected-resource/mcp	GET	保護されたリソースのメタデータ（RFC 9728） — クライアントが /mcp の 401 から参照するものです
/authorize	GET	認可エンドポイント。確認ページを表示します
/token	POST	トークンエンドポイント（authorization_code + PKCE、refresh_token）
/register	POST	動的クライアント登録（RFC 7591）
/revoke	POST	トークンの失効（RFC 7009）

ホスト型サーバーは Coinversa によって運用され、あなたが認可したキーを使用して、あなたに代わってファーストパーティの Coinversa API（https://api.coinversa.ai）を呼び出します。これはサードパーティのプロキシではありません。このパッケージと同じツール定義（同じ名前、説明、入力スキーマ、タイトル、注釈。tests/toolParity.test.ts によって検証されています）を提供します。このリポジトリは npm の stdio パッケージのソースであり、ホスト型 OAuth サーバー自体のソースではありません。

認証

ホスト型エンドポイントがサポートする認証方式は、PKCE（S256）と動的クライアント登録を使用する OAuth 2.1 の 1 つだけです。準拠しているすべてのクライアント（Claude.ai、mcp-remote 経由の Claude Desktop、Claude Code、Cursor、ChatGPT、Perplexity）は、URL だけでこの処理を自動的に行います。

仕組み：

1. クライアントはトークンなしで /mcp に POST し、保護されたリソースのメタデータを示す WWW-Authenticate ヘッダー付きの 401 を受け取ります。そこから認可サーバーを検出します。
2. クライアントは /register（DCR）経由で自身を登録し、PKCE コードチャレンジを含めてブラウザーで /authorize を開きます。
3. Coinversa の確認ページが表示されます。cvsa_ キーを貼り付けるか、サインイン／サインアップしてキーを取得をクリックします。クリックするとポップアップで開発者ポータルが開き、確認ページに短期間有効な一度限りの接続コードが返されます。ポータルを使用する場合、生のキーが MCP サーバーに届くことはありません。バックエンドが解決するキー参照のみが保存されます。
4. クライアントは認可コード（および PKCE 検証子）を /token でトークンと交換します。

トークンの詳細：

トークン	形式	有効期間
アクセストークン	不透明なランダム値	1 時間
リフレッシュトークン	不透明なランダム値。更新のたびにローテーションされます	90 日（スライド式）

トークンはサーバー上でハッシュ化（SHA-256）して保存されます。開発者ポータルで基盤となる API キーを失効させると、そのキーで認可されたすべてのセッションが無効になります。

ホスト型エンドポイントでは、ヘッダーによる API キー認証はできません。 OAuth を省略して、生の cvsa_ キーを Authorization ヘッダーまたはカスタムヘッダーに指定したリクエストは 401 で拒否されます。手元のキーで認証する場合は、代わりにローカルの stdio サーバーを実行してください（上記を参照）。このサーバーは環境から COINVERSAA_API_KEY を読み取り、それを使って Coinversa API を直接呼び出します。

プライバシーとデータの取り扱い

ホスト型サーバーは、お使いの MCP クライアントと Coinversa API の間をつなぐ、ステートレスな薄いブリッジです。

保存する情報（Coinversa のインフラストラクチャ上の SQLite データベース）：

• 動的クライアント登録を通じて作成された OAuth クライアント登録情報（クライアント ID、リダイレクト URI、クライアントメタデータ）。
• SHA-256 ハッシュとして保存されるアクセストークンとリフレッシュトークン。平文のトークンはお使いのクライアントにのみ存在します。
• 各トークンに紐づく API キーの付与情報：デベロッパーポータル経由で接続した場合はキー ID（バックエンドが解決する参照情報であり、キー自体は保存されません）、または貼り付けたキー（データベースの外部に保管されたキー暗号化キーを使用し、AES-256-GCM で保存時に暗号化されます）。

決して保存しない情報：

• 会話内容。サーバーが目にするのは実行中のツール呼び出しのみで、チャット内容は見えません。
• 処理中のリクエストの存続期間を超えるツールの引数や結果。データベースには何も書き込まれず、パラメーターもログに記録されません。
• ウォレットの秘密鍵、シードフレーズ、署名、取引所の認証情報、または資産管理に関する情報。これらを求めるツールはなく、サーバーにもそのような情報は存在しません。

ローカルの stdio サーバーは一切情報を保存しません。プロセスの実行中は COINVERSAA_API_KEY をメモリ内に保持し、各ツール呼び出しを Coinversa API に転送します。

**ツール呼び出しで Coinversa API に送信される情報：**各ツールのスキーマで確認できるパラメーター（市場シンボル、公開ウォレットアドレス、コホート名、HIP-4 の結果 ID、ビルダーアドレス、時間枠）に加え、認証と使用量の計測に必要な API キーです。使用量はキーのプランに算入されます。詳しくはレート制限をご覧ください。

**範囲：**すべてのツールは読み取り専用で、その旨が注釈されています（readOnlyHint: true、destructiveHint: false）。サーバーは、Hyperliquid や Coinversa で注文を出したり、トランザクションに署名したり、資金を移動したり、エージェントを承認したり、アカウント設定を変更したりできません。

取り消し：デベロッパーポータルで API キーを失効させると、そのキーで認証したすべてのエージェントとの接続が解除されます。または、お使いのクライアントからコネクターを削除してください。クライアントから /revoke を呼び出すこともできます。

ポリシー：coinversa.ai/privacy · coinversa.ai/terms。ご質問やデータに関するお問い合わせ：[email protected]。

コネクターディレクトリ

ディレクトリの審査担当者やセキュリティチーム向けに、情報をまとめています。

• 読み取り専用。 登録済みツールは 107 個、デフォルトで利用可能なツールは 106 個です。すべて GET 相当の分析機能であり、書き込み、取引、送金、アカウント変更の機能は一切ありません。このコネクターを通じて金融取引を行うことはできません。
• 認証： OAuth 2.1、PKCE S256、動的クライアント登録、リフレッシュトークンのローテーション。ヘッダーに API キーを含める必要はなく、クライアント設定に静的なシークレットを置く必要もありません。
• データソース： 自社提供です。サーバーは Coinversa が運営し、Coinversa 独自の API（api.coinversa.ai）のみを呼び出します（サインイン時は Coinversa のデベロッパーポータル／バックエンドも呼び出します）。サードパーティのデータブローカーや LLM プロバイダーは呼び出しません。
• トランスポート： Streamable HTTP（ステートレスな POST /mcp）、TLS のみ。
• データ保持： ハッシュ化されたトークン、暗号化されたキーまたはキー ID、DCR クライアントレコード。会話やパラメーターのログ記録はありません。
• ソースコード： github.com/coinversaa/mcp-server（MIT）。npm の stdio パッケージで、ホスト型コネクターと同じツール定義を使用します。
• サポート： [email protected] · プライバシー · 利用規約

Builder Dex Markets

Hyperliquid は、ネイティブのパーペチュアル取引所に加えて、複数のビルダー DEX に対応しています。各 DEX には、独自のマーケット、担保トークン、シンボル形式があります。

DEX	取引対象	担保	シンボルの例
(ネイティブ)	主要なパーペチュアル（暗号資産）	USDC	BTC, ETH, SOL, HYPE
xyz	コモディティ、株式、指数	USDC	xyz:GOLD, xyz:SILVER, xyz:TSLA
flx	パーペチュアル	USDH	flx:BTC, flx:ETH
vntl	パーペチュアル	USDH	vntl:ANTHROPIC, vntl:BTC
hyna	パーペチュアル	USDE	hyna:SOL, hyna:BTC
km	エネルギー、コモディティ	USDH	km:OIL, km:NATGAS
abcd	その他	USDC	abcd:BITCOIN
cash	株式	USDT0	cash:TSLA, cash:AAPL

シンボル形式：

• ネイティブ Hyperliquid のシンボル：BTC、ETH、SOL
• ビルダー DEX のシンボル：prefix:COIN — 例：xyz:GOLD、cash:TSLA、hyna:SOL

利用可能なすべてのシンボルと、それぞれが属する DEX を確認するには、list_markets ツールを使用してください。

エージェント型トレーダー向けのバックエンド取引に関する注意：Coinversaa のバックエンド署名付き Hyperliquid 注文では、vaultAddress ではなく、承認済みの Hyperliquid エージェントウォレットを使用します。バックエンド署名者を変更した場合、注文を送信する前に Hyperliquid でその署名者を再承認してください。ビルダー DEX の注文では、対応する DEX 間で USDC 担保を共有できるよう、統合アカウントモードも必要になる場合があります。分離マージン専用のマーケットでは、省略された marginMode は isolated がデフォルトになります。ビルダー DEX のシンボルで cross が利用できるとは限らないため、そう仮定しないでください。 フロントエンドのアカウントモードに関する注意：アプリでは、POST /api/v1/hyperliquid/prepare-abstraction を介して、ユーザー署名による抽象化の変更を準備できるようになりました。これにより、ユーザーは Coinversa を離れることなく、統合アカウントモードを有効化または無効化できます。ただし、取引所側の理由により、Hyperliquid が切り替えを拒否する場合があります。

クロスマーケット資産分類

同じ原資産が、異なる取引所では異なるティッカーで表示されることがあります（例：xyz の GOLD と hyna の PAXG は、どちらも金価格に連動します）。Coinversa は正規資産レジストリを提供しているため、グループ化の仕組みを独自に作る必要はありません。

• 正規資産 — 経済的エクスポージャーを識別する名称（GOLD、BTC、ETH）。
• シンボル — 取引所での表示名（xyz:GOLD、hyna:PAXG、BTC、flx:BTC）。
• 同義語（ティッカー → 正規資産）：PAXG → GOLD、XAUT → GOLD、XAGT → SILVER。

資産レベルの情報（取引所での取扱状況、取引所横断の OI、取引所間のバイアスの不一致）には、list_assets / list_asset / pulse_cross_market_asset を使用してください。単一の取引所に関するクエリには、list_markets / market_price を使用してください。

グループ化の仕組み：

• 複数の取引所で同じティッカー（BTC、flx:BTC、hyna:BTC）→ 自動的に正規資産 BTC の下にグループ化されます。設定は不要です。
• ティッカーは異なるものの、同じエクスポージャー（PAXG と GOLD はどちらも金 1 オンスに連動）→ 上記の同義語テーブルにより解決されます。
• ラップド資産またはステーキング資産（WBTC、WETH、stETH、wstETH）→ デフォルトでは集約されません。リスク特性と流動性が異なるため、独立した資産として扱ってください。

例：集約した「GOLD」の表示（2026 年 4 月のライブスナップショット）：

• 6 つの取引所：xyz:GOLD（OI が最大の $149M）、PAXG（ネイティブ HL、$39M）、cash:GOLD、km:GOLD、flx:GOLD、hyna:GOLD
• netBias: 0.27 — 取引所全体でややロング
• biasRange: 0.61 — 確信度の強さについて取引所間で大きな意見の相違があります（回答で注意喚起する価値があります）
• synonyms: ["GOLD", "PAXG"] — PAXG が正規資産 GOLD に正しく統合されたことを確認できます

数値は参考例です。現在の値を取得するには、canonical: "GOLD" を指定して pulse_cross_market_asset を呼び出してください。

バックエンド依存関係

3 つの資産ツールは、本番環境の Coinversa バックエンド（https://api.coinversa.ai）にある /api/public/v1/assets* エンドポイントを呼び出します。セルフホストまたはフォークした環境では、これらのルートを公開するバックエンドを実行する必要があります。参考実装については、Coinversa バックエンドのリポジトリを参照してください。

利用可能なツール（106）

すべてのツールで API キーが必要です。MCP には 107 個のツールが登録されていますが、デフォルトでは 106 個が公開されます（builder_heatmap は非公開です。詳しくは0.12.0 の新機能をご覧ください）。また、Coinversa API ではキーのティアに応じてアクセスが制限されます。Free API キーでは公開ルートや探索ルートを利用でき、Starter、Pro、Enterprise キーでは、より詳細なトレーダー、HIP-4、リスク、過去データ、公式 OI のツールを利用できます。

リスクツールのデータ鮮度

live_risk_overview、live_coin_risk_snapshot、live_coin_risk_history、live_mark_dislocations、live_recent_liquidations、live_liquidation_summary、live_oi_history、live_cohort_bias_history などの Syncer ベースのリスクツールは、ベータ版の最近のインテリジェンスを提供するツールとして扱うのが最適です。取引所の正確な OI データを確認するには、live_official_oi で Hyperliquid の Info API から直接取得し、照合できます。

• 調査、LLM のトレーニング、清算分析、OI トレンドの調査、ポジションの偏りの検出に最適です
• 7d や 30d など、最近の期間を指定して照会するのが最適です
• データの鮮度は同期状況に依存するため、リアルタイムから遅れる場合があります
• 実際の取引執行の確実な根拠や、正確な過去の会計データとして扱わないでください

market_recent_candles では、リクエストの対象を短期間かつ最近のデータに絞ってください。この MCP ツールでは、エージェントが 1 回の呼び出しで膨大な分足データを取得しないよう、1 分足のローソク足レスポンスを 720 行（12 時間分）に制限しています。

AI エージェントによるリスクツールの活用方法

これらのリスクツールは、単に生データを出力するのではなく、市場構造に関する質問に AI が明確に答えるためのものです。

目的	最適なツール	AI が回答できる質問
現在のリスクを検出する	live_risk_overview、live_coin_risk_snapshot	「今、どの部分が脆弱に見えますか？」「BTC のポジションは偏っていますか？」「どのコインが強制決済に最も近いですか？」
最近のストレスを説明する	live_recent_liquidations、live_liquidation_summary、live_mark_dislocations	「強制決済はどこで発生しましたか？」「清算の前にベーシスのストレスは現れましたか？」「過去 30 日間に何が清算されましたか？」
市場レジームの変化を追跡する	live_coin_risk_history、live_oi_history、live_cohort_bias_history	「この値動きの中で OI は積み上がりましたか？」「スマートマネーのコホートが先に資金を移しましたか？」「この状況は時間とともにどのように脆弱になりましたか？」

実際には、Claude のようなエージェントはこれらを活用して、次のような変化を促せます。

• 生の質問：「BTC についてどう思いますか？」
• より良い回答：「BTC の OI が積み上がり、清算が増え、スマートマネーのバイアスが弱まり、値動きの後半にはベーシスのストレスが拡大しました。」

Pulse — トレーダーインテリジェンス

ツール	説明
pulse_global_stats	Hyperliquid 全体のトレーダー数、取引数、取引量、PnL。現在のカバレッジ数を確認するにはこれを呼び出してください
list_markets	正規の市場探索。dex、価格、取引量、資金調達率、OI とともに、すべてのシンボルを表示します
pulse_market_overview	list_markets の非推奨エイリアス（同じペイロード）
pulse_leaderboard	PnL、勝率、取引量、スコア、またはリスク調整後リターンで順位付けされた上位トレーダー
pulse_hidden_gems	多くのプラットフォームが見逃している、過小評価された高パフォーマンス銘柄
pulse_most_traded_coins	取引量と取引数で順位付けされた、最も活発に取引されているコイン
pulse_biggest_trades	Hyperliquid 全体で最も利益または損失の大きかった取引
pulse_recent_trades	直近 N 分／時間の大口取引
pulse_token_leaderboard	特定のコインの上位トレーダー

Assets — 正規化されたクロスマーケット資産（v0.6.0）

1 つの資産が複数の取引所で複数のティッカーを持ちます。同義語（PAXG↔GOLD、XAUT↔GOLD、XAGT↔SILVER）と取引所のプレフィックス（BTC ≡ flx:BTC ≡ hyna:BTC）をサーバー側で解決します。3 つすべてに API キーが必要です。

ツール	説明
list_assets	正規化された資産の一覧です。すべての資産を経済的エクスポージャー別にグループ化し、取引所、同義語、クロスマーケットフラグを表示します。複数の取引所にまたがる資産に絞り込むには、crossMarketOnly: true を使用します。
list_asset	取引所別の内訳を含む、単一の正規化済み資産の検索です。同義語を受け付けます。list_asset({canonical: "PAXG"}) は GOLD 資産を返します。
pulse_cross_market_asset	1 つの資産について、取引所別のロング／ショート／バイアス／OI の集計値に加え、全取引所の合計値と biasRange 指標（取引所間で方向性が一致しているか、食い違っているか）を返します。「X はポジションが偏っていますか？」「取引所間で Y の方向性に食い違いはありますか？」という問いに対する、エージェント向けの回答です。

HIP-4 — アウトカムコントラクト（v0.7.0）

Hyperliquid からインデックス化された、予測市場形式のアウトカムコントラクトです。アウトカムサイドコインでは #<encoding> を使用し、encoding = 10 * outcomeId + side です。サイドトークンでは +<encoding> を使用します。

バックエンドのティア分けは Coinversa API によって適用されます。以下の「無料」には、無料の API キーが必要であることも含まれます。

ツール	プラン	入力	バックエンドのルート	返却内容／用途
hip4_outcomes	無料 API キー	hours 1〜168、デフォルトは 24	GET /hip4/outcomes	最近アクティブだったアウトカムを返します。outcomeId、任意の質問メタデータ、解析済みの priceBinary、サイドトークン、コインキー、資産 ID、約定数、ユニークウォレット数、USDH 建て名目取引額、最初と最後の取引時刻を含みます。アクティブな予測市場の発見に使用します。
hip4_outcome	無料 API キー	outcomeId	GET /hip4/outcomes/{outcome_id}	メインネットのローンチ以降における、指定したアウトカム ID の詳細を返します。メタデータを取得できない場合の代替サイドトークンを含め、検索結果と同じアウトカム形式を返します。
hip4_outcome_summary	Starter+	outcomeId	GET /hip4/outcomes/{outcome_id}/summary	両サイドの集計情報を返します。サイド 0／1 のコントラクト数、サイド別 USDH 建て名目取引額、名目取引額の合計、実現損益、約定数、ユニークウォレット数、最初と最後の取引時刻を含みます。「この市場の規模はどれくらいだったか」や、損益／取引高の概要を確認する際に使用します。
hip4_outcome_recent_trades	無料 API キー	outcomeId、hours 1〜168、デフォルトは 24、limit 1〜500、デフォルトは 100	GET /hip4/outcomes/{outcome_id}/recent-trades	決済、ペアの償還、オークションフェーズでの約定を除いた、最近の実約定のみを返します。取引時刻、ウォレット、coin、sideIndex、サイドラベル、dirId、価格、数量、損益、手数料を含みます。
hip4_questions	無料 API キー	なし	GET /hip4/questions	Hyperliquid の outcomeMeta 質問カタログを返します。質問 ID、名前、説明、代替アウトカム、名前付きアウトカム ID、決済済みの名前付きアウトカムに加え、クラス、原資産、満期、期間、価格しきい値などの解析済みフィールドを含みます。
hip4_recent_settlements	無料 API キー	hours 1〜720、デフォルトは 168、limit 1〜200、デフォルトは 50	GET /hip4/settlements/recent	最近の決済情報を返します。アウトカム ID、決済時刻、判定可能な場合は勝ちサイド、勝者／敗者の約定数、勝者への支払総額、敗者の損失総額を含みます。
hip4_daily_volume	無料 API キー	days 1〜60、デフォルトは 14	GET /hip4/daily-volume	指定した期間の開始日以降の日次推移を返します。約定数、ユニークな取引数、ユニークウォレット数、コントラクト数、USDH 建て名目取引額を含みます。採用状況やアクティビティの傾向に関する質問に使用します。
hip4_most_active	無料 API キー	hours 1〜168、デフォルトは 24、limit 1〜50、デフォルトは 10	GET /hip4/most-active	最近の約定数が多い上位アウトカムを、利用可能な場合はメタデータとサイドトークンとともに返します。現在のアウトカム市場のアクティビティを順位付けする際に使用します。
hip4_top_traders	Starter+	days 1〜30、デフォルトは 7、limit 1〜100、デフォルトは 25	GET /hip4/top-traders	アウトカムトレーダーのランキングを返します。アドレス、約定数、異なるアウトカムの数、コントラクト総数、USDH 建て名目取引額の合計、実現損益を含みます。
hip4_trader_outcomes	Starter+	address、days 1〜365、デフォルトは 30	GET /hip4/trader/{address}/outcomes	1 つのウォレットのアウトカム履歴を返します。アウトカム ID、サイドインデックス、サイドトークン、約定数、純シェア数、USDH 建ての購入総額／売却総額、実現損益、最初と最後の取引時刻を含みます。ウォレット単位のアウトカムに関するデューデリジェンスに使用します。
hip4_cross_product_overlap	Pro+	days 1〜30、デフォルトは 7	GET /hip4/cross-product/overlap	HIP-4 アウトカムトレーダー数、無期限先物トレーダー数、重複数、重複率を返します。アウトカムのアクティビティが独立しているのか、無期限先物トレーダーにも共有されているのかを確認する際に使用します。
hip4_perp_position_context	Pro+	outcomeId、days 1〜60、デフォルトは 14、limit 1〜100、デフォルトは 25	GET /hip4/outcomes/{outcome_id}/perp-position-context	純保有数が正のアウトカム保有者と、同じ原資産で現在オープンしている無期限先物ポジションを結合します。サイド別の重複、ロング／ショート数、原資産のネットポジション、名目取引額、ポジションが方向一致かヘッジかの件数、予測市場に特化したトレーダー数、シグナルラベル付きの上位ウォレットを返します。アウトカムトレーダーが方向性のあるエクスポージャーを持つのか、ヘッジしているのか、予測市場に特化しているのかを確認する際に使用します。

ポジションのライフサイクル — 0.8.0

ライフサイクルツールは、新しいエージェント向けに推奨されるポジション単位のインターフェースです。ライフサイクルとは、スケールイン、スケールアウト、実現損益、手数料、保有時間、清算状態を含む、再構築された1つのオープンからクローズまでのポジションです。従来のクローズ済みポジションのペイロードや、全体の最近のクローズ済みポジションのフィードが特に必要な場合に限り、旧式のクローズ済みポジションツールを使用してください。

目的	推奨ツール
ウォレットをすばやく確認する	pulse_trader_demo
ウォレット単位のポジション統計	pulse_trader_lifecycle_summary
ウォレットの全ライフサイクル履歴	pulse_trader_lifecycles
1つのポジションの約定を詳しく調べる	pulse_lifecycle
MAE/MFEの痛みと決済タイミング	pulse_wallet_drawdown_curve、pulse_max_pain_events、pulse_perfect_exits
トレーダーのアーキタイプを見つける	pulse_survivors、pulse_anti_survivors、pulse_persistent_winners、pulse_capital_titans、pulse_one_month_wonders、pulse_newcomer_whales
市場全体のライフサイクル構造	pulse_coin_alpha_map、pulse_hour_profitability、pulse_market_concentration、pulse_style_distribution
ウォレットを比較する	pulse_compare
現在注目されているコホートを分析する	pulse_cohort_recent_positions、pulse_cohort_recent_trades、pulse_cohort_recent_lifecycle_stats、pulse_cohort_recent_top_positions、pulse_cohort_recent_alpha_concentration

ビルダー分析 — 0.11.x

ビルダー（フロントエンド、ウォレットアプリ、ボット、HIP-3 DEX）は、Hyperliquidで注文ごとにビルダー手数料を徴収します。収益の数値はオンチェーンの累積ビルダー手数料台帳に基づく正確な値です。出来高／ユーザー／約定の詳細は注文から約定へのアトリビューションに基づいており、トリガー注文（ストップ／TP）の約定はまだアトリビューションされないため、実際よりわずかに少なくなります。すべてのレスポンスにはdataNotesによる説明と、台帳ブロックの検証済みスタンプverifiedが含まれます。ビルダーアドレスは0xに40桁の16進数を続けた形式です。

ツール	ティア	説明
builder_leaderboard	Starter	正確な台帳収益に基づくビルダーのランキング。アトリビューションされた出来高／ユーザー／約定数と、前の期間との差分を含みます
builder_profile	Starter	1つのビルダーの収益、日次系列、上位コイン、利益を上げているユーザーの割合
trader_builders	Starter	1つのウォレットが取引で利用するすべてのビルダーを、支払手数料の多い順に表示します
builder_traders	Pro	ビルダーにアトリビューションされたウォレット。損益、手数料、出来高、全期間のコホートティアを含みます
builder_fills	Pro	ビルダーを通じた個々のアトリビューション済み約定（perp/spot/HIP-4）
builder_cohorts	Pro	ビルダーのユーザーベースを行動ティア別に分類します
builder_retention	Pro	過去12か月分の月次新規ユーザー継続率の三角表
builder_overlap	Pro	このビルダーのアクティブユーザーを共有する他のビルダー
builder_journey	Pro	直近1年間の獲得コホートの収益推移：ウォレットごとの累積手数料、クジラへの集中度、累積収益のピーク／50%／75%に達するまでの日数
builder_lifecycle	Pro	全期間のユーザーベースをactive／cooling／switched／dormant／movedOnに分類し、真の継続率、離脱率、競合への流出を表示します
builder_orders	Pro	注文配置レイヤーの意図：アクションと有効期間の構成、reduce-onlyの割合、ストップ／TPトリガーの内訳、約定への転換率

現在は非表示で、上記の数には含まれません： builder_heatmap [Pro] — 直近84日間を、曜日×時間（UTC）の7×24グリッドで出来高、手数料、約定数として表示します。登録済みですが、時間単位のロールアップがバックフィルされるまでは、上流がクライアントのタイムアウト内に応答できないため、デフォルトでは公開されていません。公開するにはCOINVERSAA_HIDDEN_TOOLS=（明示的に空）を設定します。

Pulse — トレーダープロフィール

ツール	説明
pulse_trader_profile	任意のウォレットの包括的なデューデリジェンス（PnL、勝率、ティア、プロフィットファクター）
pulse_trader_performance	直近30日と全期間の比較、およびトレンドの方向
pulse_trader_demo	ウォレットの簡易概要：ライフサイクルの要約と、最近の大きな利益・損失
pulse_trader_trades	任意のウォレットの最近の取引 — コピー取引のシグナル
pulse_trader_daily_stats	日ごとのPnL、勝率、取引量の内訳
pulse_trader_token_stats	コインごとのP&L内訳（トレーダーの得意分野を特定）
pulse_trader_lifecycle_summary	推奨される0.8ウォレットのポジション概要 — 勝ち・負け、清算回数、保有時間、手数料、最大利益・最大損失
pulse_trader_lifecycles	推奨される0.8ライフサイクル履歴 — 1行につき、再構築された1つの建玉から決済までのポジション
pulse_lifecycle	IDで指定した1つのライフサイクルと、構成する約定
pulse_trader_closed_positions	従来の決済済みポジションのペイロード。新しいポジション分析では pulse_trader_lifecycles を推奨
pulse_trader_closed_position_stats	従来の集計統計。新しいポジション分析では pulse_trader_lifecycle_summary を推奨

Pulse — コホートインテリジェンス

追跡対象のHyperliquidウォレットをすべて行動ティアに分類しています。他にはない独自のデータです。現在の追跡対象ウォレット数を確認するには、pulse_global_stats を呼び出してください。

PnLティア（収益性順、上位から下位）：

表示名	スラッグ	旧スラッグ（現在も使用可能）
頂点	apex	money_printer
熟練者	sharps	smart_money
着実に稼ぐ人	grinders	grinder
小幅に稼ぐ人	scrapers	humble_earner
大多数	crowd	exit_liquidity
損失が膨らむ人	bleeders	semi_rekt
身動きの取れない人	trapped	full_rekt
大損した人	blown_out	giga_rekt

サイズティア（取引量順、大きいものから小さいもの）：

表示名	スラッグ	旧スラッグ（現在も使用可能）
ヘビー級	heavyweights	leviathan
クルーザー級	cruiserweights	tidal_whale
ミドル級	middleweights	whale
ウェルター級	welterweights	small_whale
ライト級	lightweights	apex_predator
フェザー級	featherweights	dolphin
フライ級	flyweights	fish
ストロー級	strawweights	shrimp

ツールの入力では、どちらの用語体系も受け付けます（API呼び出しの前に新しいスラッグが正規化されます）。APIレスポンスでは、現在も旧スラッグが出力されます（例：pnlTier: "money_printer"）。

ツール	説明
pulse_cohort_summary	追跡対象の全ウォレットにわたる行動ティアの内訳
pulse_cohort_positions	Apex／Heavyweightsティアが現在保有しているポジション
pulse_cohort_trades	コホートが直近N分／時間に行ったすべての取引
pulse_cohort_history	任意のコホートの過去のパフォーマンストレンド
pulse_cohort_bias_history	すべてのコホートの過去の1時間ごとのバイアススナップショット
pulse_cohort_performance_daily	すべてのコホートの過去の日次パフォーマンス統計

Market — ライブデータ

ツール	説明
market_price	任意のシンボル（ネイティブまたはビルダーDEX）の現在のマーク価格
market_positions	任意のウォレットのオープンポジション
market_orderbook	任意の取引ペアの買い気配・売り気配の板の厚み
market_historical_oi	1時間ごとの過去のオープンインタレストスナップショット（名目USD）
market_recent_candles	市場の直近1分足ローソク足。MCPレスポンスを実用的なサイズに保つため、直近12時間分に制限されています

ライブ — リアルタイム分析

ツール	説明
live_liquidation_heatmap	価格帯ごとの清算クラスター — サポート／レジスタンスのシグナル
live_risk_overview	取引所全体のリスクスナップショット：OI、レバレッジ、ポジションの集中度、清算間近のエクスポージャー、過去7日間の清算合計
live_coin_risk_snapshot	個別コインの現在の脆弱性スナップショット：OI、ポジションの集中度、上位ポジション、清算ヒートマップ、過去7日間のストレス
live_coin_risk_history	コインの複数指標の履歴：OI、ロング／ショート、コホートのローテーション、ローソク足、価格乖離、清算フロー
live_mark_dislocations	コインのマーク価格／オラクル価格の乖離履歴 — アンワインドの前や最中にベーシスのストレスを見つけるのに役立ちます
live_recent_liquidations	ウォレット、コイン、ペナルティ手数料、確定損益を含む、実際の syncer 清算イベント
live_liquidation_summary	最適な清算サマリーツール：件数、合計、コイン別の集計、タイムラインの区分
live_long_short_ratio	グローバルまたはコイン別のロング／ショート比率。履歴も指定できます
live_cohort_bias	指定したコインについて、すべての層のネットロング／ショートのスタンス
live_oi_history	任意のコインまたはグローバルの過去の建玉 — 最大30日分の1時間ごとのスナップショット（独自に算出したOI）
live_official_oi	Hyperliquid の Info API から取得した DEX ごとの公式 OI（会場の実測値であり、独自算出値ではありません）— 最大30日分の1時間ごとのスナップショット
live_cohort_bias_history	各コホートのロング／ショートのバイアスが時間とともにどう変化したか — スマートマネーのローテーションを追跡するのに役立ちます
pulse_recent_closed_positions	すべてのトレーダーを対象に、エントリー／決済データを含む直近の決済ポジション

プロンプトの例

接続したら、AI に次のように質問してみましょう。

• 「Hyperliquid で PnL 上位5人のトレーダーは誰ですか？」
• 「apex 層が現在保有しているものを見せてください」
• 「過去10分間の最大の取引を見せてください」
• 「過去1時間にウォレット 0x7fda...7d1 が行った取引は何ですか？」
• 「勝率70％以上の、過小評価されているトレーダーを探してください」
• 「ウォレット 0x7fda...7d1 を詳しく分析してください。今も好調ですか？」
• 「BTC の清算クラスターはどこにありますか？」
• 「今週の Hyperliquid の取引所全体のリスク概要を見せてください」
• 「現在、最もポジションが集中しているように見えるコインはどれですか？」
• 「過去7日間の ETH の清算イベントを見せてください」
• 「OI、清算、コホートのローテーションを含む BTC のリスク履歴を見せてください」
• 「過去30日間の BTC のマーク価格／オラクル価格の乖離を見せてください」
• 「現在、スマートマネーのトレーダーは ETH をロングしていますか、ショートしていますか？」
• 「過去24時間で最大の損失を見せてください」
• 「現在、最も活発に取引されているコインは何ですか？」
• 「このトレーダーの平均保有時間とポジション勝率はどれくらいですか？」
• 「xyz dex ではどのマーケットが利用できますか？」
• 「金と銀のすべてのマーケットを見せてください」
• 「xyz:GOLD の価格はいくらですか？」
• 「すべての builder dex マーケットとその価格を一覧表示してください」
• 「Hyperliquid で取引できる株式は何ですか？」
• 「BTC の直近240本の1分足ローソクを見せてください」
• 「PAXG は GOLD と同じですか？ どの取引所に上場していますか？」
• 「2つ以上の dex で取引されているすべての資産を見せてください」
• 「現在、すべての dex における BTC の建玉合計はいくらですか？」
• 「ETH のポジションは、ネイティブ Hyperliquid より HYNA のほうが集中していますか？」
• 「金の価格の方向について、dex 間で見解が分かれていますか？」
• 「Hyperliquid 自身の Info API では BTC の OI はいくらですか？ 私たちの数値と一致していますか？」
• 「本日、最も活発な HIP-4 のアウトカム契約はどれですか？」
• 「アウトカム 123 の最近の取引を見せてください」
• 「最近、どの HIP-4 アウトカムが決済されましたか？」
• 「今週の HIP-4 アウトカムのトレーダー上位は誰ですか？」
• 「アウトカム 25 では、Yes のトレーダーはすでに BTC をロングしていますか、それとも主に予測市場に特化していますか？」
• 「過去7日間で、アウトカムのトレーダーと無期限先物のトレーダーに重複はありましたか？」

環境変数

これらは ローカルの stdio サーバー（npx -y @coinversaa/[email protected]）に適用されます。ホスト型のエンドポイントには設定は必要ありません。

変数	必須	デフォルト	説明
COINVERSAA_API_KEY	はい	—	API キーです（cvsa_ で始まります）。すべてのツールで必須です。設定されていない場合、stdio サーバーは起動時に終了します。
COINVERSAA_API_URL	いいえ	https://api.coinversa.ai	API ホストを上書きします。独自の Coinversa バックエンド（セルフホストまたはフォーク）を運用している場合にのみ必要です。

レート制限

レート制限は API キーのティアによって適用されます。

ティア	リクエスト数/分	1 日あたりの上限	1 か月あたりの上限
無料 API キー	30	1,000	—
Starter	120	2,000	50,000
Pro	600	20,000	500,000
Enterprise	カスタム	カスタム	カスタム

レート制限ヘッダーはすべてのレスポンスに含まれます。

• X-RateLimit-Limit：設定済みの上限
• X-RateLimit-Remaining：現在のウィンドウで残っているリクエスト数
• X-RateLimit-Reset：ウィンドウがリセットされるまでの秒数
• X-RateLimit-Tier：API キーのティア
• X-RateLimit-Daily-Remaining：1 日あたりの上限が適用される場合に、今日残っているリクエスト数

開発

このリポジトリは、@coinversaa/mcp-server npm パッケージのソースです。エントリーポイントが src/index.ts → src/coinversaServer.ts の createCoinversaServer() となっている stdio MCP サーバーです。

git clone https://github.com/coinversaa/mcp-server.git
cd mcp-server
npm install
npm run build

# run the stdio server against your key
COINVERSAA_API_KEY=cvsa_... node build/index.js

# or drive it with the MCP Inspector
npx @modelcontextprotocol/inspector build/index.js

# unit tests (bun) and typecheck
bun test
npx tsc --noEmit

https://mcp.coinversa.ai/mcp のホスト型 OAuth コネクターは Coinversa が運用しており、このリポジトリからビルドされているものではありません。このコネクターでは同じツールセットを利用できます。

これが他と異なる点

これは公開ブロックチェーン API のラッパーではありません。Coinversa は Hyperliquid のクリアリングハウスを直接インデックス化し、ほかでは得られない分析情報を算出します。

• 市場横断型の標準分類体系：1 つの資産、多数の取引所、多数のティッカー。list_assets / list_asset / pulse_cross_market_asset は類義語（PAXG↔GOLD、XAUT↔GOLD、XAGT↔SILVER）を解決し、取引所をまたいだ OI、バイアス、ポジションを集計します。処理はサーバー側で行われるため、クライアント側でのグループ化は不要です。
• ビルダー DEX 市場：コモディティ、株式、指数、パーペチュアルを含む 8 つの DEX で 369 以上の市場にアクセスできます。
• 取引所の実際の OI：live_official_oi は Hyperliquid の Info API から直接データを取得するため、当社の算出値と照合できます。
• 行動別コホート：追跡対象のすべてのウォレットを、PnL ティア（Apex から Blown Out まで）とサイズティア（Heavyweights から Strawweights まで）に分類します。
• コホートのリアルタイムポジション：トップトレーダーが保有しているポジションをリアルタイムで確認できます。
• リアルタイムの取引フィード：任意のウォレットまたはコホートによるすべての取引を、時間枠を指定して照会できます。
• 清算ヒートマップ：任意のコインについて、価格帯ごとのクラスター分析を確認できます。
• ポジションのライフサイクル分析：保有期間、エントリー／エグジット VWAP、実現 PnL、手数料、清算状態、MAE/MFE による執行品質分析を含む、再構成されたオープンからクローズまでのライフサイクルを提供します。
• 隠れた逸材の発見：ランキングサイトが見逃す熟練トレーダーを見つけられます。
• 建玉履歴：任意のコインについて、最大 30 日前までの時間ごとの OI スナップショットを取得できます。
• コホートのバイアス履歴：スマートマネー、クジラ、その他のティアが、時間の経過とともにロング／ショートのポジションをどのように変化させたかを追跡できます。
• API で利用できる最も詳細な Hyperliquid 取引履歴：pulse_global_stats を呼び出すと、ライブのカバー率を確認できます（古いマーケティング用の数値ではありません）。

貢献

プルリクエストを歓迎します。大きな変更については、まずイシューを作成して、変更内容を議論してください。

ライセンス

MIT

---

Coinversa が作成