market-depth-lab-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MDL_REJECT_STALE | No | Return an error instead of labeled stale data | false |
| MDL_HTTP_TIMEOUT_MS | No | Per-request network timeout in milliseconds | 15000 |
| MDL_POSITION_INDEX_URL | No | Remote read-only position index URL | https://data.marketdepthlab.com/v1/positions/latest |
| MDL_POSITION_INDEX_PATH | No | Load a local JSON snapshot instead of the remote index | |
| MDL_MAX_SNAPSHOT_AGE_HOURS | No | Mark a position snapshot stale after this age | 24 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| calculate_hyperliquid_feesA | Estimate Hyperliquid spot or perpetual trading fees from notional, maker/taker role, fee tier, discounts, asset multiplier, maker rebate, and builder fee. This is a transparent estimate, not an exchange quote. |
| get_hype_market_snapshotA | Fetch a live HYPE spot/perpetual snapshot from Hyperliquid and convert either HYPE to USD or USD to HYPE. Reports spot-perp basis, 24h spot change, and 24h spot notional when available. |
| analyze_hyperliquid_walletA | Read the public main-account state for one Hyperliquid address: perpetual positions, spot balances, open orders, recent fills, exposure, leverage, PnL and fee totals. No private key, signature or wallet connection is requested. |
| hyperliquid_summarize_large_trader_positionsA | Aggregate current long and short exposure by market within Market Depth Lab's rolling monitored-address cohort. This is not a protocol-wide holder census or a simultaneous snapshot of every address. |
| hyperliquid_list_top_position_holdersA | List the largest current positions for one canonical market inside Market Depth Lab's monitored public-address cohort. Rankings are cohort-relative and the index retains only the published top positions per market. |
| list_active_hyperliquid_twapsA | List publicly visible active Hyperliquid TWAP schedules and estimate current notional using live market references. Schedule time is known; execution progress and unfilled quantity are not inferred. |
| hyperliquid_list_funding_ratesA | List current main-perpetual and HIP-3 funding, open interest, 24h notional and basis. Optionally computes exact trailing-24h funding for only the returned page to limit upstream requests. |
| scan_cross_exchange_funding_spreadsA | Compare current perpetual funding on Binance USD-M, OKX and Hyperliquid. For each symbol, the scanner pairs a long on the lower hourly funding rate with a short on the higher rate, normalizes different settlement intervals, and estimates gross carry, user-supplied costs and break-even time. It does not place orders or describe the result as risk-free arbitrage. |
| scan_cross_exchange_perp_price_spreadsA | Compare best bid and ask quotes for selected perpetual symbols on Binance USD-M, OKX and Hyperliquid. The engine ranks the cheapest cross-venue buy against the richest cross-venue sell, reports top-of-book capacity and subtracts configurable taker-fee estimates. It is a persistent-divergence screen, not a latency-arbitrage or order-execution tool. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| market-depth-lab-about | Project identity, website, scope and safety boundaries for this MCP server. |
TDQS
Scored across 9 tools
Each tool has a clearly distinct purpose: snapshot, fee estimation, wallet analysis, positions, top holders, TWAPs, funding rates, and cross-exchange spreads. No overlapping functionality.
Most tools follow a verb_noun pattern (e.g., get_hype_market_snapshot, calculate_hyperliquid_fees), but some include the server name as prefix (e.g., hyperliquid_summarize_large_trader_positions), causing minor inconsistency.
9 tools is well-scoped for a market depth lab covering Hyperliquid and cross-exchange analysis. Each tool serves a distinct function without redundancy.
The tool set covers major operations: snapshots, fees, wallet, positions, funding, and spreads. Minor gaps like historical data or order book depth are absent but not critical for the stated purpose.