ironflowsh

@ironflowsh/mcp

Ironflow 用の MCP サーバーです。Claude、Cursor、あらゆる MCP クライアントから、Hyperliquid の読み取り専用市場データとウォレット分析を利用できます。ネイティブパーペチュアル、HIP-3 ビルダー市場、HIP-4 アウトカム市場、スポットに対応しています。36 個のツールはすべて読み取り専用で、Hyperliquid のすべての約定、ウォレット、ファンディング、清算テーブルに対する読み取り専用 SQL を実行する run_query も含まれます。

利用開始に API キーは不要です。キーなしの呼び出しでは、1 分あたり 10 リクエスト、過去 24 時間分の履歴を利用できます。ironflow.sh/key で無料キーを取得すると、1 分あたり 60 リクエスト、過去 30 日分に拡張されます。

質問の例

「過去 24 時間で最も規模の大きかった Hyperliquid の清算を教えてください」

「現在の HIP-3 市場のファンディングレートを表示してください」

「稼働中の HIP-4 アウトカム市場を一覧表示してください」

「このウォレットの過去 30 日間を要約してください。PnL、手数料、メイカー比率、支払ったファンディングをお願いします」

ホスト型サーバー（インストール不要）

URL で接続します：https://mcp.ironflow.sh/mcp（Streamable HTTP）。

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

# with a free key
claude mcp add --transport http ironflow https://mcp.ironflow.sh/mcp \
  --header "Authorization: Bearer if_your_api_key"

Claude デスクトップと claude.ai の場合：設定 → コネクタ → カスタムコネクタを追加し、URL を貼り付けます。

Cursor（~/.cursor/mcp.json またはプロジェクトの .cursor/mcp.json）：

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

ヘッダーを送信できないクライアントでは、URL に ?key=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_liquidations、get_liquidation_summary、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_liquidation_levels、get_vault_leaderboard（この 2 つには Builder または Enterprise キーが必要です）

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

ウォレット分析： get_user_state、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

約定履歴は直近 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（ツール名）です。ホスト型サーバーは各リクエストのメソッド、ツール引数、クライアント名、ステータス、呼び出し元 IP のソルト付きハッシュを記録します。IP アドレスや API キーが記録されることはありません。

Links

• Docs: docs.ironflow.sh
• API reference: docs.ironflow.sh/api-reference
• Hyperliquid node guides: ironflow.sh/guides

License

MIT