Ironflow: Hyperliquid data

@ironflowsh/mcp

Ironflow 用の MCP サーバーです。Claude、Cursor、その他あらゆる MCP クライアント向けに、読み取り専用の Hyperliquid 市場データとウォレット分析を提供します。ネイティブパープ、HIP-3 ビルダー市場、HIP-4 アウトカム市場、現物を網羅しています。41 個のツールはすべて読み取り専用で、Hyperliquid のすべての約定、ウォレット、ファンディング、清算テーブルを対象とする読み取り専用 SQL 用の run_query も含まれます。

開始時に API キーは不要です。キーなしのリクエストでは、1 分あたり 30 件、1 日あたり 2,000 件、24 時間分の履歴を利用できます。ironflow.sh/key から無料のキーを取得すると、上限は 1 分あたり 60 件、30 日分に引き上げられます。

インストール

ホスト型サーバーは、インストールもキーも不要です：https://mcp.ironflow.sh/mcp（ストリーミング HTTP）。

Claude Code

claude mcp add --transport http ironflow https://mcp.ironflow.sh/mcp

Claude（claude.ai と Claude Desktop）：Customize → Connectors を開き、Add custom connector をクリックします。名前に Ironflow、URL に https://mcp.ironflow.sh/mcp を入力し、Add をクリックします。Team プランと Enterprise プランでは、Owner が Organization settings → Connectors → Add → Custom から追加すると、メンバーが Connect をクリックできるようになります。

Cursor：上のボタンを使うか、次の内容を ~/.cursor/mcp.json（またはプロジェクトの .cursor/mcp.json）に追加します。

{
  "mcpServers": {
    "ironflow": { "url": "https://mcp.ironflow.sh/mcp" }
  }
}

VS Code：上のボタンを使うか、次のように設定します。

code --add-mcp '{"name":"ironflow","type":"http","url":"https://mcp.ironflow.sh/mcp"}'

ローカルサーバー（stdio）：npx -y @ironflowsh/mcp。詳しくはローカルサーバーを参照してください。

無料のキーを使う場合

Authorization: Bearer if_your_api_key として送信するか、ヘッダーを設定できないクライアントでは URL に ?key=if_your_api_key を付けます。

claude mcp add --transport http ironflow https://mcp.ironflow.sh/mcp \
  --header "Authorization: Bearer if_your_api_key"

Cursor では、url の隣に "headers": { "Authorization": "Bearer if_your_api_key" } を追加します。

ローカルサーバー

npx -y @ironflowsh/mcp

Node.js 18 以降が必要です。Claude Desktop の設定（macOS では ~/Library/Application Support/Claude/claude_desktop_config.json、Windows では %APPDATA%/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "ironflow": {
      "command": "npx",
      "args": ["-y", "@ironflowsh/mcp"],
      "env": { "IRONFLOW_API_KEY": "if_your_api_key" }
    }
  }
}

env ブロックは省略可能です。Claude Code の場合：claude mcp add ironflow -- npx -y @ironflowsh/mcp。

HTTP サーバーを自分でホストする場合：npx -y -p @ironflowsh/mcp ironflow-mcp-http（PORT で待ち受けます。デフォルトは 8080、パスは /mcp）。

ツール

何でも質問（SQL）： describe_data は、クエリ可能なテーブル、列、クエリ例を一覧表示します。run_query は、これらに対して読み取り専用の ClickHouse SELECT を 1 回実行します（すべての約定、ウォレットごとの日次合計、行動ラベル、資金調達、マーク価格とオラクル価格、建玉、清算、ビルダーコードの約定、送金、ボールトの資金フロー）。get_wallet_behavior は、ウォレットごとの過去 30 日間の取引スタイルラベルを返します。キーなしのクエリでは過去 24 時間分が表示され、無料キーでは過去 30 日間分が表示されます。

市場データ： get_price、get_recent_trades、get_candles、get_funding_rates、get_open_interest、get_open_interest_changes、get_premium、get_outcome_markets、get_liquidations、get_liquidation_summary、get_auto_deleveraging、get_fills、get_mark_prices、get_vault_operations、list_markets、get_markets_snapshot

市場分析： get_funding_stats、get_pnl_leaderboard、get_market_top_wallets、get_wallet_labels、get_vault_leaderboard、get_liquidation_levels（Builder または Enterprise キーが必要です）

シグナル： get_top_traders、get_market_leaders、get_early_movers、get_trader_profile

ウォレット分析： get_user_state、get_positions_at、get_user_summary、get_user_pnl_series、get_user_funding、get_user_maker_taker、get_user_ledger

コホート： list_cohorts、get_cohort_addresses

ステータス： get_status、get_status_metrics、get_status_history

市場は表示用シンボル（BTC-PERP、xyz:NVDA-PERP、HYPE/USDC）または Hyperliquid 名（BTC、@107、xyz:NVDA）で指定できます。時刻は Unix ミリ秒、Unix 秒、ISO 8601 で指定できます。API が名称を読み取った場合、またはキーの履歴制限により、指定より後の時刻から始まる期間を返す場合、結果の先頭にその旨を示す notice が含まれます。約定履歴は過去 12 か月分を対象とします。オーダーブック、注文状況、ストリーミング用のツールはありません。

設定

環境変数	デフォルト
IRONFLOW_API_KEY	任意。無料キーは ironflow.sh/key で取得できます
IRONFLOW_API_URL	https://api.ironflow.sh
PORT（HTTP サーバー）	8080
MCP_LOG_SALT（HTTP サーバー）	プロセスごとにランダム。アクセスログ内の呼び出し元ハッシュのキーとして使用

使用状況データ

各 API 呼び出しには、使用されているアプリとツールを把握するため、2 つのヘッダーが付与されます。X-Ironflow-Client（MCP クライアントの名前とバージョン。例：claude-code/2.1.0）と X-Ironflow-Tool（ツール名）です。ホスト型サーバーは各リクエストについて、メソッド、ツール引数、クライアント名、ステータス、ツールがエラーを返したかどうか、その背後にある API のステータスとエラーコード、およびソルト付きの呼び出し元 IP ハッシュを記録します。IP アドレスや API キーを記録することはありません。

リンク

• ドキュメント：docs.ironflow.sh
• API リファレンス：docs.ironflow.sh/api-reference
• Hyperliquid ノードガイド：ironflow.sh/guides

ライセンス

MIT