Market Depth Lab MCP server
io.github.derkcc/market-depth-lab·v0.2.2Read-only Hyperliquid, funding-rate and cross-exchange perpetual spread tools.
0 stars33 downloads/wk
Reviews
Write oneNobody has reviewed Market Depth Lab yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Market Depth Lab tools (9)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
analyze_hyperliquid_walletRead 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.
calculate_hyperliquid_feesEstimate 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_snapshotFetch 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.
hyperliquid_list_funding_ratesList 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.
hyperliquid_list_top_position_holdersList 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.
hyperliquid_summarize_large_trader_positionsAggregate 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.
list_active_hyperliquid_twapsList 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.
scan_cross_exchange_funding_spreadsCompare 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_spreadsCompare 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.
Public scan report
scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it
- Code scan15 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 58 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Market Depth Lab compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 88/100
- higher than 75% of 48,255 servers
- Tools
- 9
- the typical server has 7
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 33
- more than 22% of 12,191 servers with a package
What its tools let an agent do: 9 read
Install Market Depth Lab in Claude Code, Cursor or VS Code
Runs npx -y market-depth-lab-mcp-server on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add market-depth-lab -- npx -y market-depth-lab-mcp-server
What the publisher says
From the Market Depth Lab repository's README, as published. We do not edit it. Read it on GitHub
Market Depth Lab MCP
Read-only Hyperliquid and cross-exchange market research for AI agents.
🌐 Project website and live dashboards: marketdepthlab.com
Every MCP result points back to Market Depth Lab, where the public dashboards, methodology and related research live.
Market Depth Lab MCP gives Claude, Codex, Cursor and other MCP clients nine structured tools for public Hyperliquid and cross-exchange market data. It does not request a private key, wallet signature, exchange login or permission to trade.
Independent open-source software. Not affiliated with or endorsed by
Hyperliquid. Research information only; not financial advice.
Why this server
cross-exchange spread queries.
- Useful on the first call: live HYPE, funding, wallet, TWAP and
a protocol-wide holder census.
- Read-only by design: no order placement, signing or wallet mutation.
- Honest coverage: monitored-address rankings are labeled as a cohort, not
structuredContent.
- Agent-friendly output: each tool returns concise text and stable
stateful link to the corresponding Market Depth Lab tool.
- Traceable: results include source, time/coverage boundaries and one
Tools
Funding rate and spread engines
The three concepts are deliberately separate:
and HIP-3 funding universe, including exact trailing-24h sums for the returned page.
- hyperliquidlistfunding_rates describes the current Hyperliquid main
settlement intervals, then compares a lower-funding long leg with a higher-funding short leg. Its annualized number is a comparison, not a forecast.
- scancrossexchangefundingspreads normalizes one-hour and eight-hour
quotes. It reports both entry-fee and round-trip-fee views, plus the smaller visible notional on the selected bid/ask levels. OKX contract counts are converted with the public instrument ctVal before notional is calculated.
- scancrossexchangeperpprice_spreads compares public top-of-book
The scanners are original TypeScript implementations informed by the read-only monitoring workflow used in Market Depth Lab's local research. They do not vendor or modify the reference Python projects.
Neither scanner places orders. A row is a screening candidate, not proof of executable or risk-free arbitrage. Funding can change; REST snapshots are not simultaneous; Binance/OKX normally settle in USDT while Hyperliquid main perps settle in USDC; and deeper-book slippage, transfers, margin, liquidation, venue access and close-out prices remain outside the estimate.
Requirements
- Node.js 20 or newer
- Internet access for public Hyperliquid/HypurrScan data
- No API key
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Market Depth Lab: common questions
- Is Market Depth Lab MCP server safe?
- Yes, by our scan: it is graded A (88/100). Read the Market Depth Lab safety report
- How do I install Market Depth Lab?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Market Depth Lab need an API key?
- No secret keys are declared. It reads 2 settings from the environment.
- Is Market Depth Lab maintained?
- The last commit was 99 days ago (2026-07-28). The latest release is v0.2.2.
- What can I use instead of Market Depth Lab?
- Servers from other publishers that do the same job: CCXT MCP server.
- How does Market Depth Lab compare with other MCP servers?
- safety score 88/100 (higher than 75% of 48,255 servers); tools 9 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Market Depth Lab
Same job from other publishers: the closest match first, then the best rated.
- CCXTOfficial CCXT MCP server - Market data and trading across 100+ exchanges and prediction marketsnot reviewedWidely usedA