flowscan-mcp
flowscan-mcp is a free, read-only MCP server that turns Flowscan’s Hyperliquid mainnet data into agent-callable tools, with no API key required.
Query revenue: daily HyperCore fees (native vs HIP-3), HIP-3 deployer fees, priority gas, and 1/7/30-day summaries.
Explore perps: market positioning snapshots, largest positions, address positions, open interest, long/short ratios, and liquidation levels.
Inspect addresses: PnL/role/perp state/spot balances, orders, fills, funding/ledger, staking, vaults/sub-accounts, approved builders, borrow/lend, rate limits, and TWAP fills.
Analyze builders: leaderboards, arbitrary-range revenue, daily revenue, trader growth, dashboards, and Builder Intelligence reports.
Cover HIP-3: DEX overview/market share, daily metrics, markets, per-DEX details, builder-routed volume, and Binance RWA comparison.
Access HIP-4 prediction markets: active/settled outcomes, questions, outcome detail with YES/NO candles, and asset labels.
View staking: overview, validator list, validator stakers/events, and address delegations.
Browse other Flowscan pages: tokenized stocks, weekend trading and position changes, stablecoin margin, gossip peers, and a coverage map.
Optionally set
FLOWSCAN_HYPERLIQUID_DIRECT=1to add 14 live Hyperliquid tools for prices, candles, order books, blocks, and transactions.
Provides HIP-3 market comparison data against Binance USDT-M, including Binance symbols, open interest, 24h volume, last price, and daily OI/volume history for individual symbols.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@flowscan-mcp what did Hyperliquid earn in fees yesterday?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
flowscan-mcp
Give your AI agent the Hyperliquid data from flowscan.xyz.
Flowscan is a real-time explorer for the Hyperliquid blockchain. (It has nothing to do with the Flow blockchain.) This MCP server turns the numbers on Flowscan into tools, so you can ask your agent things like:
"How much did Hyperliquid earn in fees yesterday?"
"Who holds the biggest BTC longs right now?"
"Which builder code made the most revenue this week?"
"What positions does 0x… have open?"
"How much was liquidated on ETH today, and who just opened big shorts?"
Free, no API key, read-only, Hyperliquid mainnet.
Quick start
You need Node.js 20 or newer.
Claude Code
claude mcp add flowscan -- npx -y github:joshavenue/flowscan_mcpClaude Desktop, Cursor, Gemini CLI and most other clients: add this to the client's MCP config file, then restart the client:
{
"mcpServers": {
"flowscan": {
"command": "npx",
"args": ["-y", "github:joshavenue/flowscan_mcp"]
}
}
}The first start can take a minute while npm builds the server. Then ask your agent a question about Hyperliquid.
Other clients (Codex, VS Code, ChatGPT, Zed, Cline, LangChain and more): see docs/clients.md for setup steps, and examples/ for config files you can copy.
Related MCP server: Hyperliquid MCP Updated
What it covers
54 tools, grouped by the Flowscan page they mirror:
Area | What you can ask about |
Revenue | Daily protocol fees, HIP-3 deployer fees, priority gas, 1/7/30-day totals |
Perps | Open interest, long/short ratios, the largest positions in any market, who opened or closed what, liquidation levels |
Terminal | Funding, open-interest and slippage history, liquidations, buy/sell order flow, active TWAPs |
Addresses | Positions, PnL, trades, closed trades and win rate, orders, funding, deposits, staking, vaults, Flowscan's name for an address |
Builders | Builder-code leaderboards and weekly movers, revenue over any date range, user stats, top users |
HIP-3 | Perp DEX market share, volume, markets, comparison with Binance |
HIP-4 | Outcome (prediction) markets, prices and candles |
Staking | Total HYPE staked, validators, delegators |
More | Tokenized stocks, weekend trading, stablecoins, network nodes, search |
Every result names the Flowscan route it came from and when it was served; series and snapshots also carry their dates or snapshot time.
Optional: live market data
Some Flowscan panels (live prices, candles, order books, blocks and transactions) are loaded in your browser straight from Hyperliquid, not from Flowscan. To get these too, set one environment variable:
"env": { "FLOWSCAN_HYPERLIQUID_DIRECT": "1" }This adds 14 tools (68 in total). By default the server only talks to www.flowscan.xyz. With this setting it also calls Hyperliquid's public API.
Good to know
Unofficial. The server uses the same internal routes the Flowscan website uses. If Flowscan changes them, a tool may break until it is updated.
Mainnet only. Flowscan doesn't show testnet.
Works with any MCP client, locally over stdio or remotely over HTTP (
npx -y github:joshavenue/flowscan_mcp --http).Better answers with the guide. Give your agent skills/flowscan (Claude) or AGENTS.md (most other agents). These tell it which tool to use for each kind of question.
Documentation
Full reference: every tool and parameter, output format, errors and settings
Coverage matrix: every Flowscan feature, the tool that serves it, and what is not served
Client setup: step-by-step for 20+ MCP clients, HTTP and Docker
Evaluation: 242 real questions answered by a model using only these tools (96% pass); first run
Development
git clone https://github.com/joshavenue/flowscan_mcp
cd flowscan_mcp
npm install # also builds
npm test # offline unit tests
npm run smoke # live test against flowscan.xyzSee CONTRIBUTING.md to add a tool.
License
MIT. Not affiliated with Flowscan or Hyperliquid.
Available Tools
44 toolsflowscan_address_extrasAddress extras: approved builders, borrow/lend, rate limit, TWAP fillsBRead-only
Smaller address-page widgets. kind: 'approvedBuilders' (builder codes the user approved with max fee), 'borrowLend' (HyperCore native borrow/lend state per token, health and health factor), 'rateLimit' (API request allowance vs cumulative volume), 'twapSliceFills' (fills generated by the user's TWAP orders).
Inputs: kind (required), address (required), limit, fields, +1 more.
flowscan_address_fillsAddress trade fillsARead-only
Address 'Trades' tab: fills newest first, 50/page (coin, px, sz, side, direction, closed PnL, fee, hash, time + timeIso). totals (count, closedPnlUsdc, fees, volumeUsd = px*sz, byCoin) cover ALL matched fills in coveredRange: quote them, never add rows. No startTime: the latest ~2000 fills. With startTime[/endTime]: pages past the 2000-row cap are followed (maxPages); if still capped, continue from nextStartTime.
Inputs: address (required), coin, limit, fields, +5 more.
flowscan_address_ledgerAddress funding payments or ledger updatesARead-only
Address 'Funding' / 'Ledger' tabs, newest first, rows with timeIso. kind='ledger' (default, 50/page, since 30 days ago): deposits, withdrawals, sends, transfers, vault/staking moves; totals.byType {count, sumUsdc, inUsdc, outUsdc}. kind='funding' (100/page, last 7 days): hourly payments; totals {netUsdc, paidUsdc, receivedUsdc, byCoin}. Totals cover ALL matched rows in coveredRange: quote them, never add rows. Pages past the 2000-row cap are followed (maxPages); if still capped, continue from nextStartTime.
Inputs: address (required), coin, kind, limit, +5 more.
flowscan_address_ordersAddress open or historical ordersARead-only
Address 'Open Orders' / 'Order History'. kind='open' (default): all resting orders on every DEX (coin, side B/A, limit price, size, oid, time). 'openDetailed': main-DEX orders with trigger/TP-SL/reduce-only/type/TIF (upstream max 100, capped then). 'historical': the newest ~2000 orders with final status, newest first; countsByStatus (filled/canceled/...) covers all of them, coveredRange shows their time span (seconds for busy accounts). Returns count of matching orders; pages default to 100 (open) / 50 rows. Times have ISO twins.
Inputs: address (required), coin, kind, limit, +2 more.
flowscan_address_perp_positionsOpen perp positions for an address (snapshot)ARead-only
Homepage perp snapshot address lookup: an account's open perp positions across all markets incl. HIP-3 (market, side, signed size, notional, entry, leverage, liquidation price, funding PnL, all-time PnL) from the latest snapshot (refreshes every few minutes), with totalNotional and totalPositions. Sorted by notional desc. For live margin/account state use flowscan_address_summary.
Inputs: address (required), side, limit, fields, +2 more.
flowscan_address_stakingAddress staking delegations & historyBRead-only
Address page 'Staking' section: totalDelegatedHype, current delegations per validator (validator address and name, commission_bps, is_jailed, amountHype, lock-up end) and the staking history (delegate/undelegate, deposits/withdrawals to staking, newest first).
Inputs: address (required), fields, historyLimit.
flowscan_address_summaryAddress overview (role, PnL summary, perp state, spot balances)ARead-only
Overview of an /address page: role (user/vault/subAccount/agent/missing), lifetime PnL summary (PnL, win rate, trades, hold time, volume, fees, funding, days active, tradedPairs as count + first 30), live perp state (account value, notional, margin, withdrawable, positions with size/entry/leverage/liquidation/uPnL/ROE/funding, largest first, capped by positionsLimit) and non-zero spot balances. Perp state is the main DEX unless dex names a HIP-3 DEX (prefix or display name; unknown names are rejected).
Inputs: address (required), dex, fields, include, +2 more.
flowscan_address_vaults_subaccountsAddress vault equities & sub-accountsBRead-only
Address 'Vaults' and 'Sub-accounts': equity held in each vault (vault, equity, lock-up) and sub-accounts (name, address, account value, notional, withdrawable, open positions, non-zero spot balances).
Inputs: address (required), fields.
flowscan_builder_dashboardBuilder detail dashboard (stats, daily series, volume by asset)ARead-only
The /builders/{id} dashboard for one builder over a FIXED window (7d/30d/90d/all, ending yesterday UTC): stats (volume, revenue, fills, unique/new traders, volume per trader, share of Hyperliquid and builder volume, revenue run-rate), daily series (last 90 days unless days) and volume/revenue by asset. USD. builder: 0x address, 'id:' or a name. For arbitrary ranges use flowscan_builder_revenue.
Inputs: builder (required), days, fields, window, +2 more.
flowscan_builder_intelligence_detailBuilder Intelligence: deep-dive for one builderARead-only
A /builder-intelligence builder report: user status (active/dormant/cooling-off/switched/moved-on), revenue, cohorts, lifecycle, retention, daily activity, top users, heatmap, daily revenue. Payload is ~11 MB, so pick sections (default metadata, key_metrics, user_status_metrics, revenue_metrics). Long lists are paged with limit/offset (50 top-level, 20 nested) and address lists become {count, sample}.
Inputs: builderId (required), limit, fields, offset, +3 more.
flowscan_builder_intelligence_listBuilder Intelligence: builders & categoriesARead-only
The /builder-intelligence index: ~120 analysed builders (id, name, category, total/active users, all-time revenue/volume USD, 7d new users) and categories. Ids feed flowscan_builder_intelligence_detail, category ids flowscan_builder_intelligence_summary. Prefer this for user-status/retention questions. Its '7d new users' comes from a different dataset than the leaderboard's and user_series'; say which you quote.
Inputs: limit, fields, offset, search, +3 more.
flowscan_builder_intelligence_summaryBuilder Intelligence: category or overall summaryARead-only
The /builder-intelligence aggregate view for a category (e.g. wallet, copytrading, desktop_trading, mobile_trading) or 'overall': metadata (builders included and their weights), totals (users, active users, 7d new users, all-time revenue, fees 24h/7d/30d/90d, average daily revenue, week-1/4 retention) and user-weighted averages (key metrics, user status, revenue by status, lifecycle, retention, equity/fee cohorts). Cohort member address lists are reduced to {count, sample}.
Inputs: fields, endDate, category, startDate, +1 more.
flowscan_builder_lookupFind a builder's id/address by nameARead-only
Resolve a builder name to its id/address. Names can be ambiguous (e.g. two 'fomo' builders); call this first, then pass the exact id/address to flowscan_builder_revenue or flowscan_builder_dashboard (as address or 'id:'). If multiple strong matches exist, show them to the user. Matches id, name and address (case-insensitive); exact matches first, then substrings, by all-time revenue. Each match: id, name, category, address, revenue and volume USD for 1d/7d/30d/90d/all_time, total_users.
Inputs: query (required), limit.
flowscan_builder_revenueOne builder's revenue over any date range (e.g. last 45 days)ARead-only
Total and daily revenue (USD) of ONE builder over any range ('past 45 days'): days (complete UTC days ending yesterday, default 30) or startDate/endDate (end clamped to yesterday; future start = error). builder: 0x address (preferred), 'id:' or a name; ambiguous names return candidates (ask the user). Sums /api/builders/all-daily-revenue, cross-checked with the dashboard series when the address is known (both totals + covered dates, volume/fills/traders). Daily rows newest first.
Inputs: builder (required), days, limit, fields, +3 more.
flowscan_builders_daily_revenueDaily revenue per builder (date range, all builders)ARead-only
The /builders daily revenue chart: for each UTC day in the range, builder revenue (USD) keyed by builder id (slug like 'phantom' for well-known builders, 0x address for the rest), plus range totals per builder and the grand total. Defaults to the last 30 days ending yesterday, like the site. By default keeps the top 20 builders by range revenue. For one builder's total over a range use flowscan_builder_revenue instead.
Inputs: top, fields, builder, endDate, +1 more.
flowscan_builders_leaderboardBuilders leaderboard (revenue, volume, users by window)ARead-only
The /builders 'Builder Arena': ~1800 builders ranked by one metric over a FIXED window (1d/7d/30d/90d/all_time): revenue, volume (USD), new_users, total_users or avg_revenue_per_user_all_time (last two all-time only). Compact rows (rank, id, name, category, value, that metric's windows, all-time revenue, users); full=true for all metrics. For arbitrary ranges like 'last 45 days' use flowscan_builder_revenue; flowscan_hip3_builders ranks by HIP-3 volume only.
Inputs: full, limit, fields, metric, +5 more.
flowscan_builders_summaryBuilders all-time summary by categoryARead-only
The /builders page headline totals: all-time builder revenue (USD), volume (USD), users and avg revenue per user, overall and per builder category (with builder counts), plus the per-builder all-time list (paged with limit/offset, default 50).
Inputs: limit, fields, offset.
flowscan_builders_user_seriesDaily traders & new traders per builderARead-only
The /builders user-growth chart: daily count of active traders and new traders across all builders and per builder since 2025-07-27. Prefer this for daily active/new trader time series; for windowed totals use flowscan_builders_leaderboard (its new_users.7d is a separate dataset and can differ).
Inputs: days, fields, metric, builder.
flowscan_coverageWhat Flowscan shows and which tool to useARead-only
Start here when unsure. Returns the map of flowscan.xyz pages -> tools, what Flowscan does NOT serve (block/tx lookups, prices), the mainnet-only rule and output-shaping conventions. Optionally filter by a keyword (e.g. 'revenue', 'address', 'hip-3'): matching pages plus matching notServed items, with servedByThisServer=false when only notServed matches. Also lists HIP-3 dex display names vs on-chain prefixes.
Inputs: topic.
flowscan_hip3_binance_comparisonHIP-3 RWA markets vs Binance futures (OI & volume)ARead-only
HIP-3 page Binance comparison: ~240 real-world-asset symbols (equities incl. HK/KR/CN, commodities, indices, FX, pre-market) with Binance USDT-M symbol, open interest (USD), 24h volume (USD) and last price. With symbol: Binance row, daily Binance OI/volume history and the HIP-3 side per DEX (OI, DAU, volume, spread, slippage). Prefer this when comparing HIP-3 with Binance.
Inputs: days, limit, fields, offset, +3 more.
flowscan_hip3_buildersBuilder-routed volume on HIP-3 DEXsARead-only
HIP-3 'Builders' section: share of HIP-3 volume routed via builder codes (all-time/30d/90d), per-DEX builder volume with top builders, and 800+ builders ranked by HIP-3 volume only (address, name, total/30d/90d volume, shares). dex ranks by one DEX. For revenue/users across Hyperliquid use flowscan_builders_leaderboard.
Inputs: dex, limit, fields, offset, +3 more.
flowscan_hip3_dailyHIP-3 daily time series (volume, trades, traders, new users, OI)ARead-only
HIP-3 page charts: daily values per DEX as dated rows [{date, XYZ: v, KM: v, ...}] (raw=true for positional {dates, series}). metric: volume, trades, traders, new_users, oi, oi_by_market (top markets), collateral_traders, collateral_oi. Returns the last N days (default 30); lastDayPartial flags when the last date is the current, still-accumulating UTC day. dex takes a display name or on-chain prefix.
Inputs: dex, raw, days, fields, +1 more.
flowscan_hip3_dexOne HIP-3 DEX: totals, markets, daily totalsARead-only
HIP-3 per-DEX tab: collateral, total volume/trades/traders/OI, every market with all-time volume, traders and current two-sided OI (sorted by volume), and dated daily-total rows for the last N days (today flagged partial). dex: display name or prefix ('mkts' = KM). Prefer this for one DEX's market list.
Inputs: dex (required), days, limit, fields, +3 more.
flowscan_hip3_marketsHIP-3 markets list & cross-DEX market comparisonARead-only
HIP-3 market tables. Without symbol: all HIP-3 markets (dex, symbol, canonical, asset class) filterable by dex/assetClass/search. With symbol ('TSLA', 'GOLD'): per listing DEX the OI, DAU, volume, spread, slippage (1k-1m), plus OI/DAU history trimmed to days. Prefer this to compare one underlying across HIP-3 DEXs; live positioning is in flowscan_perp_markets ('xyz:TSLA'), Binance in flowscan_hip3_binance_comparison.
Inputs: dex, days, limit, fields, +4 more.
flowscan_hip3_overviewHIP-3 perp DEXs overview & market shareARead-only
The /hip-3 headline: HIP-3 totals (volume all-time/30d/90d, trades, traders, new users, OI), per-DEX and per-collateral market share, collateral per DEX, builder-routed share (top 3 per DEX), and dexAliases (display name -> on-chain prefix, e.g. KM=mkts, Paragon=para, Entropy=io). OI is two-sided (long + short). Prefer this for DEX-level totals and share.
Inputs: fields.
flowscan_hip4_labelsHIP-4 asset id -> human labelARead-only
Resolve HIP-4 outcome asset ids like '#14730' (YES) / '#14731' (NO) to readable labels such as 'Arsenal · Yes', as the address page does for HIP-4 spot balances. Returns {labels: {assetId: label}}.
Inputs: assets (required).
flowscan_hip4_marketsHIP-4 prediction markets (questions, active & settled outcomes)ARead-only
The /hip-4 page: HIP-4 prediction markets. section='active' (default): slim rows (outcomeId, name, marketType, asset ids, underlying/target/expiry, yesMark/noMark = implied probability, yesChange24h, volume24h, totalVolume, deployer, question) sorted by sortBy (default volume24h desc). 'settled': resolved outcomes with settleFraction and trade stats. 'questions': question groups. 'all': all three. full=true for descriptions. Candles: flowscan_hip4_outcome.
Inputs: full, limit, order, fields, +7 more.
flowscan_hip4_outcomeHIP-4 outcome detail with YES/NO candlesARead-only
HIP-4 page outcome drill-down: candles for the YES and NO assets of one outcome over the last N days (compact rows [openTime ms, open, high, low, close, volume, trades]), plus per-side trade stats and, for settled outcomes (settled=true), the settled outcome record. Settled outcomes typically have no candles. Only outcomeId is required (asset ids default to '#0' YES / '#1' NO). Get outcomeId from flowscan_hip4_markets.
Inputs: outcomeId (required), days, fields, settled, +3 more.
flowscan_peersHyperliquid gossip-network peersARead-only
The /peers gossip-network crawl (~600 nodes). Default: meta (crawl time, counts, reachability, states), footprint (top countries/ASNs) and sentries (validator sentries with operator, state, peers served). section='nodes' (IP id, role, operator, state, tier, hops, parent, feeders, geo, ASN; filterable), 'edges' (feed links) or 'all' are paged.
Inputs: role, limit, state, fields, +5 more.
flowscan_perp_marketsPerp positioning snapshot per marketARead-only
Homepage perp snapshot for every perp market (~330 incl. HIP-3 like 'xyz:TSLA'): long/short counts and notional, ratios, open interest, avg entry, median leverage, unique addresses, snapshotIso/snapshotAgeSeconds (refreshes every few minutes). openInterest is Flowscan's two-sided figure: long + short notional (2x the one-sided OI some UIs show). Prefer this for live OI/positioning; hip3_markets/hip3_dex give HIP-3 history, hip3_binance_comparison the Binance side.
Inputs: limit, fields, market, offset, +1 more.
flowscan_perp_positionsLargest open perp positions in a marketARead-only
Perp snapshot drill-down: open positions in one market, largest first (address, signed size, notional, side, entry, leverage, liq price, account value, funding/all-time PnL), with snapshotIso/snapshotAgeSeconds, marketSummary (whole market, unfiltered; OI = long + short notional) and filteredSideSummary (over the filtered rows only, with filter). Market is case-insensitive; bare 'TSLA' resolves to 'xyz:TSLA' when unique.
Inputs: market (required), dir, page, side, +14 more.
flowscan_revenue_deployer_feesDaily HIP-3 deployer fees by DEXARead-only
/revenue 'Deployer Fees': HIP-3 deployer fees per UTC day, oldest first: totalFee and byDex [{dex, totalFee}] with on-chain names ('xyz', 'para', 'io', 'mkts', 'hyna', 'cash', 'flx', 'vntl', 'km', 'hyperliquid'), plus rangeTotals (overall and per DEX). days = last N complete UTC days ending yesterday (default 90); includeToday adds today's partial row. USDC. Paid to deployers, so not part of Flowscan's headline protocol revenue.
Inputs: dex, days, limit, fields, +6 more.
flowscan_revenue_hypercore_feesDaily HyperCore fee revenue (native vs HIP-3)ARead-only
/revenue 'Daily HyperCore Revenue' (and homepage 24h panel): one row per UTC day, oldest first: nativeHypercoreFee (non-HIP-3 markets) and hip3HypercoreFee (HIP-3 markets), USDC strings, plus rangeTotals. days = last N COMPLETE UTC days ending yesterday (default 90), like revenue_summary and the builder tools; includeToday appends today's partial row (partial: true). Or pass startDate/endDate or startTime/endTime (ms). History from 2026-03.
Inputs: days, limit, fields, offset, +5 more.
flowscan_revenue_priority_gasDaily priority gas (write/read) with top usersARead-only
/revenue 'Daily Priority Gas' and 'Top Users': per UTC day, writePriority and readPriority {totalGas (HYPE), count} and, with includeTopUsers, the top 5 gas payers, plus rangeTotals. days = last N complete UTC days ending yesterday (default 90); includeToday adds today's partial row.
Inputs: days, limit, fields, offset, +6 more.
flowscan_revenue_summaryRevenue summary (last 1 / 7 / 30 complete days)ARead-only
Convenience aggregate of the /revenue page and the homepage '24h Revenue' card: sums native HyperCore fees (USDC), HIP-3 HyperCore fees (USDC), their sum totalUsdcExcludingGas, HIP-3 deployer fees (USDC, paid to deployers, not protocol revenue) and priority gas (HYPE) over the last 1, 7 and 30 complete UTC days, plus the current (partial) UTC day separately and an annualized run-rate from the trailing 7 complete days. Computed from the three /api/gossip/info series on flowscan.xyz.
Inputs: fields.
flowscan_spot_stocksTokenized stocks on Hyperliquid spot (xStocks, Dinari)ARead-only
The /spot-stocks page: tokenized stocks on Hyperliquid SPOT: NVDAX, SPYX, QQQX, SKHYX, MUX, SNDKX, SPCXX, TSLAX, AAPLX, CRCLX (xStocks) and SPCXD (Dinari). Per-token price, 24h/all-time volume, holders and liquidity ARE served. section='current' (default): summary + per-token stats. 'timeseries': daily volume/holders/traders/value per token (30 days default). 'liquidity': cumulative depth within 2/5/10/25 bps in tokens and USD. 'topHolders': largest holders.
Inputs: days, limit, token, fields, +2 more.
flowscan_stablecoin_marginStablecoin spot balances & perp marginCRead-only
Homepage 'Stablecoin Perp Margin': total stablecoin value on HyperCore split into spot balances and perp margin (with unique holders/traders), and per token (USDC, USDT, USDE, USDH) spot/perp balances, holders, average/median, total value and market share %. USD.
Inputs: fields.
flowscan_staking_eventsValidator staking eventsARead-only
Staking page validator activity: most recent delegation/undelegation events for one validator, newest first (user, amount in HYPE, isUndelegate, tx hash, time ms + ISO). validator is an address or a validator name. The upstream currency field reads 'USDC' but staking amounts are HYPE.
Inputs: validator (required), limit, fields.
flowscan_staking_overviewStaking overview & validator listARead-only
The /validators (Staking) page: total HYPE staked, delegator count, validator count, and every validator (~35) with name, address, commission (bps), total delegated HYPE, staker count and jailed flag (descriptions only with includeDescription). Filter by name/address, drop jailed validators, sort ascending or descending: e.g. sortBy=commission_bps, order=asc, excludeJailed=true finds the cheapest active validator.
Inputs: limit, order, fields, offset, +4 more.
flowscan_validator_stakersValidator detail with its stakersARead-only
Staking page validator drill-down: one validator's summary (name, commission, total delegated, staker count, jailed) plus its delegators (stakers) as {address, amount HYPE}, largest first. validator is an address or a validator name (e.g. 'Hyper Foundation 2'). Large validators have thousands of stakers; use limit/offset or search.
Inputs: validator (required), limit, fields, offset, +1 more.
flowscan_weekend_coin_changesWeekend trading: one market's history across weekendsARead-only
Weekend page coin drill-down: one HIP-3 TradFi market's Friday-close -> Sunday-close move (pct and dollar) for every tracked weekend, newest first. Only DEX-prefixed TradFi markets have data; a bare symbol like 'TSLA' is resolved to 'xyz:TSLA' (crypto like 'BTC' has no weekend data). Timestamps come with ISO twins.
Inputs: coin (required), fields.
flowscan_weekend_positionsWeekend trading: positioning changes since Friday closeBRead-only
Weekend page positioning panel: per perp market (crypto and HIP-3 TradFi, ~330), long/short counts and notional at Friday close vs the latest snapshot, new/closed longs and shorts, net long/short changes, and optionally the top 5 address-level position changes per market.
Inputs: week, limit, fields, market, +3 more.
flowscan_weekend_pricesWeekend trading: Friday close vs current/Monday pricesARead-only
Weekend page price table: for HIP-3 TradFi perps (e.g. 'xyz:TSLA', 'xyz:GOLD'; stocks, indices, commodities, FX), the Friday-close prices, Sunday-close prices (once the weekend is over), live current prices (during an active weekend), and weekendChanges {pct, dollar} per market, plus status and price counts.
Inputs: week, fields, market.
flowscan_weekend_weeksWeekend trading: available weekends & scheduleARead-only
The /weekend-trading selector: tracked weekends, newest first (fridayCloseTs = week id, sundayCloseTs, ISO twins, status, avg % change, risers/fallers, market count, data availability). includeSchedule adds the next ~12 weekend/holiday sessions.
Inputs: limit, fields, offset, includeSchedule.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 44 tools
Tools map to distinct pages/sections and descriptions frequently cross-reference each other (e.g. flowscan_perp_markets vs flowscan_hip3_markets, flowscan_builder_revenue vs flowscan_builders_leaderboard), which strongly reduces misselection. There is still overlap among the many HIP-3 and builder analytics tools, but explicit guidance makes boundaries mostly clear.
Names follow a predictable flowscan_ + snake_case convention with descriptive verb/noun groups. Minor inconsistency appears in singular/plural forms (flowscan_builders_leaderboard vs flowscan_builder_dashboard) and noun-only names like flowscan_coverage and flowscan_peers, but the pattern remains readable.
44 tools is very heavy for a single server, well beyond the typical 3-15 range, and many are narrow slices of individual pages or widget sections. The broad analytics scope partially explains it, but the selection burden is high and related tools could be consolidated.
The surface covers a wide range of Hyperliquid analytics: address detail, staking, revenue, HIP-3, HIP-4, builders, spot stocks, weekend data, peers and stablecoin margin. It also documents non-served areas (block/tx lookups, prices) via flowscan_coverage, leaving only minor potential gaps such as general crypto perp price history.
Related MCP Connectors
Read-only Hyperliquid analytics: orderflow, liquidation levels, whale positioning, funding.
Read-only Hyperliquid wallet, market and portfolio research with source timestamps and coverage.
Live Hyperliquid wallet positions, recent trades with PnL, and fill alerts to Discord/Telegram.
Live crypto market data and Hyperliquid wallet reports for AI agents, paid per call with x402.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI agents to interact with Hyperliquid perpetual futures exchange for market analysis, account management, and risk-managed trading.51MIT
- AlicenseCqualityDmaintenanceA read-only Model Context Protocol server for Hyperliquid that exposes over 30 tools to query public market data and user state via the Hyperliquid Info API, without requiring a private key.41MIT
- AlicenseAqualityCmaintenanceRead-only Hyperliquid and cross-exchange market research for AI agents, providing structured tools for live market data without requiring authentication.990 npmMIT
- AlicenseNot gradedqualityDmaintenanceProvides live cryptocurrency prices, price history, and symbol listing tools for AI agents via the Hyperliquid API.53 PyPI1MIT