Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "ironflowsh": {
      "type": "http",
      "url": "https://mcp.ironflow.sh/mcp"
    }
  }
}

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

[mcp_servers.ironflowsh]
url = "https://mcp.ironflow.sh/mcp"

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ironflowsh": {
      "type": "remote",
      "url": "https://mcp.ironflow.sh/mcp",
      "enabled": true
    }
  }
}

{
  "mcpServers": {
    "ironflowsh": {
      "type": "http",
      "url": "https://mcp.ironflow.sh/mcp"
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=ironflowsh&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbWNwLmlyb25mbG93LnNoL21jcCJ9"
}

{
  "servers": {
    "ironflowsh": {
      "type": "http",
      "url": "https://mcp.ironflow.sh/mcp"
    }
  }
}

{
  "mcpServers": {
    "ironflowsh": {
      "httpUrl": "https://mcp.ironflow.sh/mcp"
    }
  }
}

extensions:
  "ironflowsh":
    enabled: true
    name: "ironflowsh"
    type: streamable_http
    uri: "https://mcp.ironflow.sh/mcp"
    timeout: 300

Quality 68 / 100needs work

protocol75 · weight 25

warn
protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
n/a
protocol.statelessonly applies to 2026-07-28 servers
pass
protocol.transportstreamable HTTP
n/a
protocol.list_ttlonly applies to 2026-07-28 servers

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygiene86 · weight 30

pass
tools.descriptionsevery tool has a description
pass
tools.description_lengthdescriptions are concise
pass
tools.schemasevery tool has an object input schema
pass
tools.annotations36 of 36 tools declare readOnlyHint or destructiveHint
fail
tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: get_pnl_leaderboard (destructiveHint, idempotentHint); get_early_movers (destructiveHint, idempotentHint); list_markets (destructiveHint, idempotentHint); …
pass
tools.token_costabout 5,000 tokens to load every tool
pass
tools.api_dumptools are not a one-to-one API dump

stability25 · weight 15

warn
stability.changes38 tool changes in 30 days
fail
stability.rug_pull2 tools kept their name but changed most of their description in 30 days; review before trusting them

dependencies67 · weight 15

pass
deps.known_vulnsno known advisory in 98 resolved packages
fail
deps.mcp_sdk_version@modelcontextprotocol/sdk 1.29.0 has 1 known advisory (GHSA-6qxp-vccf-f47h); update @modelcontextprotocol/sdk to 1.31.0 or later
pass
deps.resolvable@ironflowsh/[email protected] resolved: 98 packages

36 tools, about 5,000 tokens to load them all · tool set 1e7aba13c8e2 · tools last changed 2026-10-06 · checked 2026-10-19 16:53 UTC

Tool changes

2026-10-06get_vault_leaderboardchangeddescription, input schema, output schemameaning changed
before
Hyperliquid vaults ranked by net deposits. Needs a Builder or Enterprise key; keyless and free-key calls return 403.
after · 30% of words in common
Hyperliquid vaults ranked by net deposits (deposits minus withdrawals) over the last 7 days, with depositor counts. Keyless calls see the last 24 hours; a free key from https://ironflow.sh/key gives the full 7 days.
2026-10-06get_vault_operationschangeddescription, input schema
before
Deposits into and withdrawals from Hyperliquid vaults. Pass a vault address, a depositor address, or both; one is required.
after · 57% of words in common
Deposits into and withdrawals from one Hyperliquid vault or one depositor. Pass vault, address, or both; at least one is required (HLP is 0xdfc24b077bc1425ad1dea75bcb6f8158e10df303). For flows across all vaults use get_vault_leaderboard.
2026-09-24get_wallet_behavioradded
How Hyperliquid wallets trade, from their last 30 days: labels (market_maker, high_frequency, whale, directional, consistent_winner, big_loser, revenge_sizing, often_liquidated, hip3_trader, spot_trader, prediction_trader) and the numbers behind them (maker share, buy/sell imbalance, fills per day, green-day share, profit factor, liquidations). Look up specific addresses, or list wallets with one label.
2026-09-24run_queryadded
Run one read-only ClickHouse SELECT over Ironflow's Hyperliquid tables (hl.fills, hl.wallet_daily, hl.wallet_behavior, hl.funding, hl.mark_prices, hl.oracle_prices, hl.open_interest, hl.liquidations, hl.builder_fills, hl.transfers, hl.vault_operations). Call describe_data first for columns and examples. Aggregate in SQL: results are capped (1,000 rows keyless). Keyless: last 24 hours, 5 s per query, 60 query seconds per hour per IP; a free key from https://ironflow.sh/key gives 30 days of history.
2026-09-24describe_dataadded
Start here for any Hyperliquid question the other tools do not answer directly. Returns the SQL tables you can query with run_query (every fill, per-wallet daily totals, wallet behaviour labels, funding, mark and oracle prices, open interest, liquidations, builder-code fills, transfers, vault flows), their columns, how far back each goes, query tips, worked examples and your own limits.
2026-09-24list_marketschangeddescription, input schema, output schema
before
Every active Hyperliquid market with its display symbol, class (perp, spot, prediction), HIP-3 issuer and base asset. Call it when unsure how a market is named.
after · 56% of words in common
Active Hyperliquid markets with display symbol, class (perp, spot, prediction), HIP-3 issuer and base asset. Use search to find how a market is named (e.g. search 'nvda' finds xyz:NVDA-PERP).
2026-09-24get_status_historychangedoutput schema
2026-09-24get_status_metricschangedoutput schema
2026-09-24get_statuschangedoutput schema
2026-09-24get_cohort_addresseschangedoutput schema

Showing the latest 10. Full history: list_changes · trend: quality JSON.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 93 / 100

provenance80

liveness98

freshness100

hygiene100

+repository +namespace-matches-repo +reachable +uptime-96% +updated-25d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Dependencies

@ironflowsh/[email protected] npm97 dependencies, resolved · MCP SDK @modelcontextprotocol/sdk 1.29.0 · advisories checked 2026-10-19

advisory	severity	package	fixed in
GHSA-6qxp-vccf-f47hMCP TypeScript SDK: OAuth client could send credentials to an authorization server chosen by the MCP server	high	`@modelcontextprotocol/[email protected]`MCP SDK, direct	fixed in `1.31.0`

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.

Endpoints

remote	auth	reachable	uptime 30d	p50	protocol	last ok
`https://mcp.ironflow.sh/mcp` streamable-http	none	yes	96%	725 ms	2025-11-25	2026-10-19

package	registry	version	runtime	secrets
`@ironflowsh/mcp`	npm	0.9.0	–	`IRONFLOW_API_KEY`

Tools (36)

`describe_data`read-only	Start here for any Hyperliquid question the other tools do not answer directly. Returns the SQL tables you can query with run_query (every fill, per-wallet daily totals, wallet behaviour labels, funding, mark and oracle prices, open interest, liquidations, builder-code fills, transfers, vault flows), their columns, how far back each goes, query tips, worked examples and your own limits.
`get_candles`read-only	OHLCV candles for a Hyperliquid market, computed from tick-level trades.
`get_cohort_addresses`read-only	Get the wallet addresses in a specific cohort
`get_early_movers`read-only	Wallets whose large orders (at least $10k) on a Hyperliquid market were followed by a price move in their direction within 30 minutes. Returns a lead score in basis points and a hit rate per wallet. Past activity does not predict future results.
`get_fills`read-only	Every fill for one Hyperliquid wallet, optionally for one market, from indexed history: price, size, side, fee and realized PnL. Hyperliquid's own userFills endpoints stop at the 10,000 most recent fills.
`get_funding_rates`read-only	Hourly funding rate history for a Hyperliquid perp, including HIP-3 builder perps. A positive rate means longs pay shorts.
`get_funding_stats`read-only	Funding statistics per time bucket for a Hyperliquid perp: average, minimum, maximum and annualized rate.
`get_liquidation_levels`read-only	Liquidated notional on a Hyperliquid perp bucketed by price: where longs and shorts were wiped out. Needs a Builder or Enterprise key; keyless and free-key calls return 403.
`get_liquidations`read-only	Liquidations on a Hyperliquid perp, read from our own nodes: price, size, side and the liquidated wallet. Hyperliquid's public API has no liquidation feed.
`get_liquidation_summary`read-only	Liquidations across every Hyperliquid market (or one market) over the last N minutes, totalled: count, notional, longs vs shorts liquidated, the top markets and the largest single liquidation. Use it for 'who got liquidated in the last hour?'. Keyless calls can look back 60 minutes, keyed calls up to 240.
`get_market_leaders`read-only	The best traders on one Hyperliquid market, ranked by profit factor then win rate, among wallets with at least 5 closed trades there.
`get_markets_snapshot`read-only	Active Hyperliquid markets ranked in one call: mark price, 24h change, 24h volume, open interest and current hourly funding. Sort by abs_funding for the most extreme funding, abs_change_24h for the biggest movers, or volume (default). Use min_volume_usd to skip illiquid markets. Returns the top 25 unless limit is set.
`get_market_top_wallets`read-only	Top wallets on one Hyperliquid market by volume or realized PnL, up to 200 rows.
`get_mark_prices`read-only	Mark price and oracle price series for a Hyperliquid perp.
`get_open_interest`read-only	Latest open interest for a Hyperliquid perp.
`get_pnl_leaderboard`read-only	Every Hyperliquid wallet ranked by realized PnL, biggest losses or volume over a window. Wallets with fewer than 5 fills in the window are left out.
`get_price`read-only	Latest mark price of a Hyperliquid market: native perps, HIP-3 builder perps (e.g. xyz:NVDA-PERP) and spot.
`get_recent_trades`read-only	Latest tick-level trades on a Hyperliquid market from our own nodes: price, size, side and block time. Covers native perps, HIP-3 builder markets, HIP-4 outcomes and spot.
`get_status`read-only	Get system status, data freshness, and venue health (unauthenticated)
`get_status_history`read-only	Get an uptime / freshness timeline. period: '24h' (default) or '7d' (unauthenticated)
`get_status_metrics`read-only	Get rolling-window API + pipeline + synthetic performance metrics (unauthenticated)
`get_top_traders`read-only	Hyperliquid traders ranked across all markets by results over 7, 30 or 90 days: win rate, profit factor, realized PnL, max drawdown and best markets. sort=top ranks by realized PnL, lowrisk by smallest max drawdown, new by most recently first seen.
`get_trader_profile`read-only	A Hyperliquid wallet's trading record over 7, 30 or 90 days: win rate, profit factor, realized PnL, max drawdown and its best markets.
`get_user_funding`read-only	Funding a Hyperliquid wallet paid or received, per market per bucket. Positive means received, negative means paid. bucket=1d gives daily totals, 1h the raw hourly payments.
`get_user_ledger`read-only	Vault deposits, withdrawals and transfers for a Hyperliquid wallet. Positive amounts go into the account. Account deposits and withdrawals are recorded only up to 2026-06-06.
`get_user_maker_taker`read-only	Maker vs taker breakdown of a Hyperliquid wallet's fills per market: volume, fees and rebates. A high maker share with negative maker fees marks a market maker.
`get_user_pnl_series`read-only	Realized PnL curve of a Hyperliquid wallet over time, bucketed (for example hourly or daily).
`get_user_state`read-only	Open positions and unrealized PnL for a Hyperliquid wallet right now, across native and HIP-3 perps. Use it for questions like 'is this wallet long or short?'
`get_user_summary`read-only	One Hyperliquid wallet's stats over a window: volume, realized PnL, fill count, win rate, maker share and markets traded.
`get_vault_leaderboard`read-only	Hyperliquid vaults ranked by net deposits (deposits minus withdrawals) over the last 7 days, with depositor counts. Keyless calls see the last 24 hours; a free key from https://ironflow.sh/key gives the full 7 days.
`get_vault_operations`read-only	Deposits into and withdrawals from one Hyperliquid vault or one depositor. Pass vault, address, or both; at least one is required (HLP is 0xdfc24b077bc1425ad1dea75bcb6f8158e10df303). For flows across all vaults use get_vault_leaderboard.
`get_wallet_behavior`read-only	How Hyperliquid wallets trade, from their last 30 days: labels (market_maker, high_frequency, whale, directional, consistent_winner, big_loser, revenge_sizing, often_liquidated, hip3_trader, spot_trader, prediction_trader) and the numbers behind them (maker share, buy/sell imbalance, fills per day, green-day share, profit factor, liquidations). Look up specific addresses, or list wallets with one label.
`get_wallet_labels`read-only	Labels for notable Hyperliquid wallets: top whales by 24h volume, top traders by 30-day realized PnL, vaults and vault leaders. Pass addresses to check specific wallets; without them it lists the whales and smart money.
`list_cohorts`read-only	List available address cohorts: six predefined groups (top_pnl_30d, high_volume_30d, whale_fills, net_withdrawers_7d, liquidation_prone, vault_whales) plus any custom cohorts the caller has created
`list_markets`read-only	Active Hyperliquid markets with display symbol, class (perp, spot, prediction), HIP-3 issuer and base asset. Use search to find how a market is named (e.g. search 'nvda' finds xyz:NVDA-PERP).
`run_query`read-only	Run one read-only ClickHouse SELECT over Ironflow's Hyperliquid tables (hl.fills, hl.wallet_daily, hl.wallet_behavior, hl.funding, hl.mark_prices, hl.oracle_prices, hl.open_interest, hl.liquidations, hl.builder_fills, hl.transfers, hl.vault_operations). Call describe_data first for columns and examples. Aggregate in SQL: results are capped (1,000 rows keyless). Keyless: last 24 hours, 5 s per query, 60 query seconds per hour per IP; a free key from https://ironflow.sh/key gives 30 days of history.

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "io.github.ironflowsh/mcp",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://mcp.ironflow.sh/mcp",
      "type": "streamable-http"
    }
  ],
  "version": "0.9.0",
  "packages": [
    {
      "version": "0.9.0",
      "transport": {
        "type": "stdio"
      },
      "identifier": "@ironflowsh/mcp",
      "registryType": "npm",
      "environmentVariables": [
        {
          "name": "IRONFLOW_API_KEY",
          "format": "string",
          "isSecret": true,
          "description": "Optional Ironflow API key. Keyless calls get 10 requests per minute; a free key from https://ironflow.sh/key gives 60."
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/ironflowsh/mcp",
    "source": "github"
  },
  "description": "Read-only Hyperliquid data for AI agents: fills, candles, funding, liquidations, wallet analytics."
}