# io.github.ironflowsh/mcp (remote · mcp.ironflow.sh)

Read-only Hyperliquid data for AI agents: fills, candles, funding, liquidations, wallet analytics.

- Trust score: 78/100 (medium)
- Change this week: +10
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-10-04

## Components

- remote · `mcp.ironflow.sh`: 78/100 (this document), [markdown](https://verifymcp.io/servers/ironflowsh-mcp/mcp.md), [page](https://verifymcp.io/servers/ironflowsh-mcp/mcp)
- npm · `@ironflowsh/mcp`: 77/100, [markdown](https://verifymcp.io/servers/ironflowsh-mcp/ironflowsh-mcp.md), [page](https://verifymcp.io/servers/ironflowsh-mcp/ironflowsh-mcp)

## Channel facts

- Endpoint: `https://mcp.ironflow.sh/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `0.9.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-10-04.

- **Endpoint Security**: 80/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - No authorisation is required to call this server. Every tool declares its destructiveHint and none is destructive, so open access doesn't expose one.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 77/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 4053 tokens (~112/item across 36 items; 36 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 33/100
  - Stability observed for 10 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 36 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 37 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### How do I install the io.github.ironflowsh/mcp server?

io.github.ironflowsh/mcp is a hosted endpoint at https://mcp.ironflow.sh/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

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

### Cursor

```json
{
  "mcpServers": {
    "ironflowsh-mcp": {
      "url": "https://mcp.ironflow.sh/mcp"
    }
  }
}
```

### VS Code

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

### Codex

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

### opencode

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

### OpenClaw

```bash
openclaw mcp add ironflowsh-mcp --url 'https://mcp.ironflow.sh/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  ironflowsh-mcp:
    url: "https://mcp.ironflow.sh/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "ironflowsh-mcp": {
      "Transport": "http",
      "Url": "https://mcp.ironflow.sh/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add ironflowsh-mcp -t streamable-http -u 'https://mcp.ironflow.sh/mcp'
```

### Other

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

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-10-02 (score 78, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-30 (score 77, +1)

No change was recorded against any check on this day. Stability & Change Management went from 17 to 20. That category is still filling its 30-day observation window: 5 days of observed history at the previous scan, 6 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-28 (score 76, +8)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-09-26 (score 68, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-25 (score 67, 0)

- [functional improvement] Stability: unverified → 0.03

### 2026-09-24 (score 67)

First indexed and scored.

## MCP tools (36)

### `describe_data` (~88 tokens)

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.

Output parameters:

- `dialect`: SQL dialect and database name
- `examples` (array): Worked examples
- `limits`: Your tier's limits: history_days, max_execution_seconds, max_rows, budget_seconds_per_hour
- `tables` (array): Queryable tables
- `tiers` (array): Every tier's limits
- `tips` (array): Query tips

### `run_query` (~182 tokens)

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.

Input parameters:

- `max_rows` (number): Most rows to return (default 200, capped by your tier)
- `sql` (string, required): One ClickHouse SELECT (or WITH ... SELECT) over hl.* tables, without a FORMAT clause

Output parameters:

- `budget_remaining_seconds`: Query seconds left this hour
- `column_types` (array): ClickHouse types in row order
- `columns` (array): Column names in row order
- `limits`: Your tier's limits
- `row_count`: Rows returned
- `rows` (array): Rows as positional arrays
- `stats`: elapsed_ms, rows_read, bytes_read
- `truncated`: true when more rows existed than were returned

### `get_wallet_behavior` (~196 tokens)

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.

Input parameters:

- `addresses` (string): Comma-separated wallet addresses (up to 50). Omit to list wallets instead.
- `label` (string): Only wallets carrying this label
- `limit` (number): Wallets to return (default 20, max 100)
- `min_volume_usd` (number): Only wallets with at least this 30-day volume
- `sort_by` (string): Sort order when listing (default volume)

Output parameters:

- `wallets` (array): Wallets
- `window_days`: Days the features cover

### `get_price` (~106 tokens)

Latest mark price of a Hyperliquid market: native perps, HIP-3 builder perps (e.g. xyz:NVDA-PERP) and spot.

Input parameters:

- `market` (string, required): Market symbol — native HL perp (e.g. "BTC-PERP", "ETH-PERP") or HIP-3 builder market namespaced as "<issuer>:<base>-PERP" (e.g. "flx:GAS-PERP", "xyz:NVDA-PERP")

Output parameters:

- `market`: Display symbol, e.g. "BTC-PERP" or "xyz:NVDA-PERP"
- `price`: Price in USD

### `get_recent_trades` (~136 tokens)

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.

Input parameters:

- `limit` (number): Number of trades to return (1-100, default 20)
- `market` (string, required): Market symbol — native HL perp (e.g. "BTC-PERP", "ETH-PERP") or HIP-3 builder market namespaced as "<issuer>:<base>-PERP" (e.g. "flx:GAS-PERP", "xyz:NVDA-PERP")

Output parameters:

- `data` (array): Trades, newest first
- `pagination` (object): Cursor pagination

### `get_candles` (~149 tokens)

OHLCV candles for a Hyperliquid market, computed from tick-level trades.

Input parameters:

- `interval` (string): Candle interval (1m, 5m, 15m, 1h, 4h, 1d). Default: 1h
- `limit` (number): Number of candles to return (1-500, default 24)
- `market` (string, required): Market symbol — native HL perp (e.g. "BTC-PERP", "ETH-PERP") or HIP-3 builder market namespaced as "<issuer>:<base>-PERP" (e.g. "flx:GAS-PERP", "xyz:NVDA-PERP")

Output parameters:

- `data` (array): OHLCV candles
- `pagination` (object): Cursor pagination

### `get_funding_rates` (~122 tokens)

Hourly funding rate history for a Hyperliquid perp, including HIP-3 builder perps. A positive rate means longs pay shorts.

Input parameters:

- `limit` (number): Number of funding rate entries (1-100, default 10)
- `market` (string, required): Market symbol — native HL perp (e.g. "BTC-PERP", "ETH-PERP") or HIP-3 builder market namespaced as "<issuer>:<base>-PERP" (e.g. "flx:GAS-PERP", "xyz:NVDA-PERP")

Output parameters:

- `data` (array): Hourly funding rates
- `pagination` (object): Cursor pagination

### `get_open_interest` (~83 tokens)

Latest open interest for a Hyperliquid perp.

Input parameters:

- `market` (string, required): Market symbol — native HL perp (e.g. "BTC-PERP", "ETH-PERP") or HIP-3 builder market namespaced as "<issuer>:<base>-PERP" (e.g. "flx:GAS-PERP", "xyz:NVDA-PERP")

Output parameters:

- `data` (array): Open interest samples
- `pagination` (object): Cursor pagination

### `get_liquidations` (~130 tokens)

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.

Input parameters:

- `limit` (number): Number of liquidation events (1-100, default 20)
- `market` (string, required): Market symbol — native HL perp (e.g. "BTC-PERP", "ETH-PERP") or HIP-3 builder market namespaced as "<issuer>:<base>-PERP" (e.g. "flx:GAS-PERP", "xyz:NVDA-PERP")

Output parameters:

- `data` (array): Liquidations
- `pagination` (object): Cursor pagination

### `get_liquidation_summary` (~121 tokens)

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.

Input parameters:

- `market` (string): Optional market filter (e.g. "BTC-PERP")
- `minutes` (number): Lookback in minutes (default 60, max 240)

Output parameters:

- `by_market` (array): Top markets by liquidated notional
- `complete`: False when the page cap was hit and totals are a lower bound
- `count`: Number of liquidations
- `from`: Window start, Unix milliseconds
- `largest` (object): Largest single liquidation, or null when there were none
- `longs_liquidated_usd`: Notional of liquidated longs in USD
- `market`: Market filter, or null for all markets
- `notional_usd`: Liquidated notional in USD
- `shorts_liquidated_usd`: Notional of liquidated shorts in USD
- `to`: Window end, Unix milliseconds

### `get_fills` (~142 tokens)

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.

Input parameters:

- `address` (string, required): Wallet address (e.g. 0x...)
- `limit` (number): Number of fills (1-100, default 20)
- `market` (string): Optional market filter — native HL (e.g. "BTC-PERP") or HIP-3 builder market "<issuer>:<base>-PERP" (e.g. "flx:GAS-PERP")

Output parameters:

- `data` (array): Fills for one wallet, newest first
- `pagination` (object): Cursor pagination

### `get_mark_prices` (~70 tokens)

Mark price and oracle price series for a Hyperliquid perp.

Input parameters:

- `market` (string, required): Market symbol — native HL perp (e.g. "BTC-PERP") or HIP-3 builder market "<issuer>:<base>-PERP" (e.g. "flx:GAS-PERP")

Output parameters:

- `data` (array): Mark price samples
- `pagination` (object): Cursor pagination

### `get_vault_operations` (~75 tokens)

Deposits into and withdrawals from Hyperliquid vaults. Pass a vault address, a depositor address, or both; one is required.

Input parameters:

- `address` (string): User address
- `limit` (number): Number of events (1-100, default 20)
- `vault` (string): Vault address

Output parameters:

- `data` (array): Vault deposits and withdrawals
- `pagination` (object): Cursor pagination

### `get_liquidation_levels` (~140 tokens)

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.

Input parameters:

- `bucket_size` (string): Price bucket size (1, 5, 10, 50, 100, 500, 1000, 5000). Default: 100
- `market` (string, required): Market symbol — native HL perp (e.g. "BTC-PERP") or HIP-3 builder market "<issuer>:<base>-PERP" (e.g. "flx:GAS-PERP")

Output parameters:

- `data` (array): Price buckets

### `get_vault_leaderboard` (~54 tokens)

Hyperliquid vaults ranked by net deposits. Needs a Builder or Enterprise key; keyless and free-key calls return 403.

Input parameters:

- `limit` (number): Number of vaults (default 10)

Output parameters:

- `data` (array): Vaults

### `get_funding_stats` (~129 tokens)

Funding statistics per time bucket for a Hyperliquid perp: average, minimum, maximum and annualized rate.

Input parameters:

- `interval` (string): Time interval (1h, 4h, 8h, 1d, 7d). Default: 1d
- `limit` (number): Number of data points (default 7)
- `market` (string, required): Market symbol — native HL perp (e.g. "BTC-PERP") or HIP-3 builder market "<issuer>:<base>-PERP" (e.g. "flx:GAS-PERP")

Output parameters:

- `data` (array): Buckets

### `get_user_state` (~66 tokens)

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?'

Input parameters:

- `address` (string, required): 0x-prefixed 20-byte hex address

Output parameters:

- `address`: Wallet address (0x…)
- `as_of_ts`: Snapshot time, Unix milliseconds
- `asset_positions` (array): Open positions
- `margin_summary` (object): Account totals

### `get_user_funding` (~140 tokens)

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.

Input parameters:

- `address` (string, required): 0x-prefixed 20-byte hex address
- `bucket` (string): Aggregation bucket; default 1d
- `from` (number): Unix ms window start (inclusive)
- `limit` (number): Most recent rows to return (default 200)
- `market` (string): Optional market filter (e.g. BTC-PERP)
- `to` (number): Unix ms window end (exclusive)

Output parameters:

- `address`: Wallet address (0x…)
- `bucket`: Bucket size
- `data` (array): Buckets
- `from`: Window start, Unix milliseconds
- `returned`: Rows in data, most recent first
- `to`: Window end, Unix milliseconds
- `total_rows`: Rows in the window before the limit

### `get_user_maker_taker` (~96 tokens)

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.

Input parameters:

- `address` (string, required): 0x-prefixed 20-byte hex address
- `from` (number): Unix ms window start
- `market` (string): Optional market filter
- `to` (number): Unix ms window end

Output parameters:

- `address`: Wallet address (0x…)
- `data` (array): Per market
- `from`: Window start, Unix milliseconds
- `to`: Window end, Unix milliseconds
- `total` (object): All markets

### `get_user_ledger` (~139 tokens)

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.

Input parameters:

- `address` (string, required): 0x-prefixed 20-byte hex address
- `event_types` (string): Comma-separated type filter (deposit,withdrawal,vault_deposit,vault_withdraw,vault_transfer_in,vault_transfer_out)
- `from` (number): Unix ms window start
- `limit` (number): Max entries, default 1000, cap 10000
- `to` (number): Unix ms window end

Output parameters:

- `address`: Wallet address (0x…)
- `data` (array): Ledger entries
- `from`: Window start, Unix milliseconds
- `to`: Window end, Unix milliseconds

### `get_pnl_leaderboard` (~106 tokens)

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.

Input parameters:

- `from` (number): Unix ms window start (default 30d ago)
- `limit` (number): Number of rows, max 200, default 50
- `sort_by` (string): Ranking metric
- `to` (number): Unix ms window end (default now)

Output parameters:

- `data` (array): Wallets
- `from`: Window start, Unix milliseconds
- `sort_by`: Ranking metric
- `to`: Window end, Unix milliseconds

### `get_market_top_wallets` (~118 tokens)

Top wallets on one Hyperliquid market by volume or realized PnL, up to 200 rows.

Input parameters:

- `from` (number): Unix ms window start (default 24h ago)
- `limit` (number): Number of rows, max 200, default 25
- `market` (string, required): Market symbol (e.g. 'BTC-PERP' or 'flx:GAS-PERP')
- `sort_by` (string): Ranking metric
- `to` (number): Unix ms window end (default now)

Output parameters:

- `data` (array): Wallets
- `from`: Window start, Unix milliseconds
- `market`: Display symbol, e.g. "BTC-PERP" or "xyz:NVDA-PERP"
- `sort_by`: Ranking metric
- `to`: Window end, Unix milliseconds

### `get_markets_snapshot` (~201 tokens)

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.

Input parameters:

- `issuer` (string): HIP-3 builder code (e.g. 'xyz'). Omit to include every issuer.
- `limit` (number): Rows to return (1-200, default 25)
- `market_class` (string): Filter to one class
- `min_volume_usd` (number): Skip markets with less 24h volume than this (USD)
- `order` (string): desc (default) or asc
- `sort_by` (string): Ranking key (default volume). funding_rate is hourly; positive means longs pay shorts.

Output parameters:

- `data` (array): Ranked markets
- `matched`: Markets past the volume floor
- `order`: desc or asc
- `returned`: Rows in data
- `sort_by`: Ranking key used
- `total_markets`: Active markets before filtering

### `get_user_summary` (~87 tokens)

One Hyperliquid wallet's stats over a window: volume, realized PnL, fill count, win rate, maker share and markets traded.

Input parameters:

- `address` (string, required): 0x-prefixed 20-byte hex address
- `from` (number): Unix ms window start (default 24h ago)
- `to` (number): Unix ms window end (default now)

Output parameters:

- `address`: Wallet address (0x…)
- `from`: Window start, Unix milliseconds
- `state` (object): Open positions right now
- `to`: Window end, Unix milliseconds
- `window` (object): Window totals

### `get_wallet_labels` (~120 tokens)

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.

Input parameters:

- `addresses` (string): Comma-separated wallet addresses to look up
- `smart_top_n` (number): Top N smart-money wallets to include (max 500, default 100)
- `whale_top_n` (number): Top N whales to include (max 500, default 100)

Output parameters:

- `counts`: Wallets per label kind
- `generated_at`: Unix milliseconds
- `labels` (object): Address to its labels
- `note`: What the labels map includes
- `source`: Venue, always hyperliquid
- `ttl_seconds`: Cache lifetime

### `get_user_pnl_series` (~101 tokens)

Realized PnL curve of a Hyperliquid wallet over time, bucketed (for example hourly or daily).

Input parameters:

- `address` (string, required): 0x-prefixed 20-byte hex address
- `bucket_ms` (number): Bucket size in ms (e.g. 3600000 for 1h)
- `from` (number): Unix ms window start
- `to` (number): Unix ms window end (default now)

Output parameters:

- `address`: Wallet address (0x…)
- `bucket`: Bucket size
- `data` (array): Buckets
- `from`: Window start, Unix milliseconds
- `to`: Window end, Unix milliseconds

### `get_top_traders` (~118 tokens)

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.

Input parameters:

- `limit` (number): Number of traders (1-50, default 20)
- `sort` (string): Ranking. Default top
- `window` (string): Lookback window. Default 30d

Output parameters:

- `aggregate` (object): Totals
- `sort`: Ranking used
- `traders` (array): Traders
- `window`: Lookback window, e.g. "30d"

### `get_market_leaders` (~97 tokens)

The best traders on one Hyperliquid market, ranked by profit factor then win rate, among wallets with at least 5 closed trades there.

Input parameters:

- `limit` (number): Number of traders (1-50, default 20)
- `market` (string, required): Market symbol (e.g. "BTC-PERP", "xyz:NVDA-PERP")
- `window` (string): Lookback window. Default 30d

Output parameters:

- `market`: Display symbol, e.g. "BTC-PERP" or "xyz:NVDA-PERP"
- `traders` (array): Traders
- `window`: Lookback window, e.g. "30d"

### `get_early_movers` (~123 tokens)

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.

Input parameters:

- `limit` (number): Number of wallets (1-25, default 10)
- `market` (string, required): Market symbol (e.g. "BTC-PERP", "xyz:SKHX-PERP")
- `window` (string): Lookback window. Default 30d

Output parameters:

- `formula`: How the lead score is computed
- `market`: Display symbol, e.g. "BTC-PERP" or "xyz:NVDA-PERP"
- `signals` (array): Wallets
- `window`: Lookback window, e.g. "30d"

### `get_trader_profile` (~80 tokens)

A Hyperliquid wallet's trading record over 7, 30 or 90 days: win rate, profit factor, realized PnL, max drawdown and its best markets.

Input parameters:

- `address` (string, required): 0x-prefixed 20-byte hex address
- `window` (string): Lookback window. Default 30d

Output parameters:

- `address`: Wallet address (0x…)
- `liquidation_count`: Liquidations in the window
- `markets` (array): Best markets, ranked
- `overall` (object): Headline stats
- `trades`: Recent round-trip trades
- `window`: Lookback window, e.g. "30d"

### `list_cohorts` (~61 tokens)

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

Output parameters:

- `data` (array): Cohorts

### `get_cohort_addresses` (~55 tokens)

Get the wallet addresses in a specific cohort

Input parameters:

- `name` (string, required): Cohort name (e.g. top_pnl_30d, high_volume_30d, whale_fills, or a custom cohort name)

Output parameters:

- `addresses` (array): Wallets
- `fetched_at`: Unix milliseconds

### `get_status` (~23 tokens)

Get system status, data freshness, and venue health (unauthenticated)

Output parameters:

- `components`: data_pipeline, rest_api and streaming health
- `platform`: Event and market counts
- `status`: operational, degraded or down
- `timestamp`: Unix milliseconds
- `uptime`: Time since the last incident
- `venues`: Freshness per venue

### `get_status_metrics` (~24 tokens)

Get rolling-window API + pipeline + synthetic performance metrics (unauthenticated)

Output parameters:

- `api`: Latency and error rate
- `pipeline`: Ingestion latency and throughput
- `synthetic`: Synthetic probe latencies
- `timestamp`: Unix milliseconds

### `get_status_history` (~57 tokens)

Get an uptime / freshness timeline. period: '24h' (default) or '7d' (unauthenticated)

Input parameters:

- `period` (string): Lookback window. '24h' (default) or '7d'.

Output parameters:

- `period`: 24h or 7d
- `points` (array): Hourly buckets
- `uptime_percent`: Share of operational hours

### `list_markets` (~180 tokens)

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).

Input parameters:

- `issuer` (string): HIP-3 issuer code (e.g. 'flx'). Pass empty string '' to return only native non-builder markets. Omit to include every issuer.
- `limit` (number): Rows to return (default 100)
- `market_class` (string): Market class. Omit to return perp + spot + prediction. 'prediction' filters to HIP-4 outcome contracts.
- `search` (string): Case-insensitive match on symbol, base asset or Hyperliquid coin
- `source` (string): Venue. Defaults to 'hyperliquid'.

Output parameters:

- `data` (array): Markets
- `matched`: Markets matching the search
- `returned`: Rows in data
- `total_markets`: Active markets before search

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/ironflowsh-mcp/mcp#diagnostics

## Score history

- 2026-10-04: 78
- 2026-10-03: 78
- 2026-10-02: 78
- 2026-10-01: 77
- 2026-09-30: 77
- 2026-09-29: 76
- 2026-09-28: 76
- 2026-09-27: 68
- 2026-09-26: 68
- 2026-09-25: 67
- 2026-09-24: 67

## Common questions

### What is the io.github.ironflowsh/mcp server?

io.github.ironflowsh/mcp is listed in the public MCP registry as io.github.ironflowsh/mcp. Read-only Hyperliquid data for AI agents: fills, candles, funding, liquidations, wallet analytics. This page covers its hosted endpoint (https://mcp.ironflow.sh/mcp).

### Is the io.github.ironflowsh/mcp server safe to use?

io.github.ironflowsh/mcp scores 78 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the io.github.ironflowsh/mcp server expose?

io.github.ironflowsh/mcp exposes 36 tools: describe_data, run_query, get_wallet_behavior, get_price, get_recent_trades, and 31 more. Their descriptions and schemas cost roughly 3,915 tokens of context every time the server is loaded.

### Does the io.github.ironflowsh/mcp server require authentication?

No. We connected to io.github.ironflowsh/mcp without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

### Is the io.github.ironflowsh/mcp server still maintained?

io.github.ironflowsh/mcp is still listed as active in the MCP registry. We last reached this channel on 4 October 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

## Links

- Remote endpoint: https://mcp.ironflow.sh/mcp
- Repository: https://github.com/ironflowsh/mcp
- Changelog RSS feed: https://verifymcp.io/servers/ironflowsh-mcp/mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/ironflowsh-mcp/mcp.json
- HTML version of this page: https://verifymcp.io/servers/ironflowsh-mcp/mcp