@ironflowsh/mcp

MCP server for Ironflow — Hyperliquid trades, fills, liquidations, order books, HIP-3 builder markets, HIP-4 prediction outcomes, and full wallet analytics (open positions, funding payments, maker/taker split, full ledger), exposed as 36 tools for Claude Desktop, Cursor, and any MCP-compatible client.

Get a free API key in 30 seconds — email-only, no credit card. Or run with no key at all (10 req/min, 24h history, REST tools only).

Try it

Once installed, ask your AI agent things like:

"What was the biggest Hyperliquid liquidation in the last 24 hours?"

"Show me funding rates for all HIP-3 markets right now."

"List every HIP-4 prediction market that's currently live."

"Pull the order book for ETH-PERP and tell me where the largest bid wall sits."

"Set up a webhook trigger for any BTC-PERP trade above 100 BTC."

The agent picks the right tool, calls Ironflow, and answers with live data.

Install

# Run directly (no install)
npx @ironflowsh/mcp

# Or install globally
npm install -g @ironflowsh/mcp

Requires Node.js 18+.

Use with Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows):

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

Restart Claude Desktop. The Ironflow tools appear under the tools panel.

Use with Cursor

Add to ~/.cursor/mcp.json (or per-project .cursor/mcp.json):

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

Restart Cursor; the tools appear in the agent panel.

Use with other MCP clients

Any client that speaks the Model Context Protocol can connect. The server runs over stdio when invoked directly:

IRONFLOW_API_KEY=if_xxx npx @ironflowsh/mcp

Tools (32 total)

Market data — get_price, get_orderbook, get_recent_trades, get_candles, get_funding_rates, get_open_interest, get_liquidations, get_fills, get_mark_prices, get_deposits, get_withdrawals, get_order_statuses, get_vault_operations, list_markets

Analytics (Builder+) — get_net_flows, get_liquidation_levels, get_order_flow, get_vault_leaderboard, get_funding_stats

Export (Builder+) — export_data

Triggers — list_triggers, create_trigger, test_trigger, toggle_trigger, delete_trigger

Cohorts — list_cohorts, get_cohort_addresses, delete_cohort

Account & status — get_me, get_status, get_status_metrics, get_status_history

Authentication

Without an API key the server runs in unauthenticated mode: 10 req/min, 24h history, REST tools only — useful for casual exploration or trying out the server. For higher limits, WebSocket streams, longer history, and Builder+ analytics, sign up for a free key at ironflow.sh/dashboard/login and pass it via IRONFLOW_API_KEY.

Configuration

| Env var | Default | |---|---| | IRONFLOW_API_KEY | — | | IRONFLOW_API_URL | https://api.ironflow.sh |

Links

• Dashboard: ironflow.sh/dashboard
• Docs: docs.ironflow.sh
• API reference: docs.ironflow.sh/api-reference
• TypeScript SDK: @ironflowsh/sdk
• Python SDK: ironflow-sdk

License

MIT