Skip to main content
Glama

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_mcp

Claude 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

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

See CONTRIBUTING.md to add a tool.

License

MIT. Not affiliated with Flowscan or Hyperliquid.

Available Tools

44 tools
flowscan_address_extrasAddress extras: approved builders, borrow/lend, rate limit, TWAP fillsB
Read-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 fillsA
Read-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 updatesA
Read-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 ordersA
Read-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)A
Read-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 & historyB
Read-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)A
Read-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-accountsB
Read-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)A
Read-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 builderA
Read-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 & categoriesA
Read-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 summaryA
Read-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 nameA
Read-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)A
Read-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)A
Read-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)A
Read-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 categoryA
Read-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 builderA
Read-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 useA
Read-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)A
Read-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 DEXsA
Read-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)A
Read-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 totalsA
Read-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 comparisonA
Read-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 shareA
Read-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 labelA
Read-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)A
Read-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 candlesA
Read-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 peersA
Read-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 marketA
Read-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 marketA
Read-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 DEXA
Read-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)A
Read-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 usersA
Read-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)A
Read-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)A
Read-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 marginC
Read-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 eventsA
Read-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 listA
Read-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 stakersA
Read-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 weekendsA
Read-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 closeB
Read-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 pricesA
Read-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 & scheduleA
Read-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

    A3.6/5.0

    Scored across 44 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count2/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables AI agents to interact with Hyperliquid perpetual futures exchange for market analysis, account management, and risk-managed trading.
      5
      1
      MIT
    • A
      license
      C
      quality
      D
      maintenance
      A 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.
      41
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Read-only Hyperliquid and cross-exchange market research for AI agents, providing structured tools for live market data without requiring authentication.
      9
      90 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides live cryptocurrency prices, price history, and symbol listing tools for AI agents via the Hyperliquid API.
      53 PyPI
      1
      MIT