Market Depth Lab

Name: Market Depth Lab
Author: derkcc

by derkccversion 0.2.2i★ –iRuns on your computer

Registry nameio.github.derkcc/market-depth-lab

Install

Overview

Description from the maker (original English)

Read-only Hyperliquid, funding-rate and cross-exchange perpetual spread tools.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Other

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
You fill in yourself: MDL_POSITION_INDEX_URL, MDL_POSITION_INDEX_PATH

You need

npmNode.js installed (for the npx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "market-depth-lab": {
      "command": "npx",
      "args": [
        "-y",
        "market-depth-lab-mcp-server"
      ],
      "env": {
        "MDL_POSITION_INDEX_URL": "your-value",
        "MDL_POSITION_INDEX_PATH": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add market-depth-lab --env MDL_POSITION_INDEX_URL=your-value --env MDL_POSITION_INDEX_PATH=your-value -- npx -y market-depth-lab-mcp-server

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "market-depth-lab": {
      "command": "npx",
      "args": [
        "-y",
        "market-depth-lab-mcp-server"
      ],
      "env": {
        "MDL_POSITION_INDEX_URL": "your-value",
        "MDL_POSITION_INDEX_PATH": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "market-depth-lab": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "market-depth-lab-mcp-server"
      ],
      "env": {
        "MDL_POSITION_INDEX_URL": "your-value",
        "MDL_POSITION_INDEX_PATH": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

MDL_POSITION_INDEX_URL env
Optional remote read-only Market Depth Lab position index URL.
MDL_POSITION_INDEX_PATH env
Optional local position-index JSON path. Overrides the remote URL.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 7, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account derkcc, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Otheri

More stars than 0% of the other 32725 servers in this category
Published to the registry more recently than 20% of the other 32725 servers in this category
Basic checks equal to or better than 100% of the other 32725 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Market Depth Lab safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.2.2) reached the registry 3 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: Spec Driven Development, Remote Desktop Commander, Signoff

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Spec Driven Development

by formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

Runs on your computer★ 440MITUpdated 14 months ago

Install

Remote Desktop Commander

by desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

Runs in the cloud★ 211Updated 2 days ago

Install

Signoff

by ayuanxx-max

Five gates that make an agent's 'done' provable: run them, read the verdict, audit the record.

Runs on your computerUpdated today

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Market Depth Lab MCP

Read-only Hyperliquid and cross-exchange market research for AI agents.

🌐 Project website and live dashboards: [marketdepthlab.com](https://marketdepthlab.com)

Every MCP result points back to [Market Depth Lab](https://marketdepthlab.com), 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

Useful on the first call: live HYPE, funding, wallet, TWAP and cross-exchange spread queries.
Read-only by design: no order placement, signing or wallet mutation.
Honest coverage: monitored-address rankings are labeled as a cohort, not a protocol-wide holder census.
Agent-friendly output: each tool returns concise text and stable structuredContent.
Traceable: results include source, time/coverage boundaries and one stateful link to the corresponding Market Depth Lab tool.

Tools

Tool	What it answers
`list_active_hyperliquid_twaps`	Which public TWAP schedules are active, and what is their estimated current notional?
`analyze_hyperliquid_wallet`	What positions, balances, orders, leverage and PnL are visible for this public address?
`calculate_hyperliquid_fees`	What would the estimated fee be for this notional, role and fee tier?
`get_hype_market_snapshot`	What is HYPE worth now, and how do spot and perps compare?
`hyperliquid_summarize_large_trader_positions`	How is the monitored large-trader cohort positioned by market?
`hyperliquid_list_top_position_holders`	Which monitored addresses have the largest positions in one market?
`hyperliquid_list_funding_rates`	Who pays funding now, and what is the exact trailing-24h sum for the returned markets?
`scan_cross_exchange_funding_spreads`	Where is the largest normalized funding difference across Binance USD-M, OKX and Hyperliquid, after a user-supplied cost estimate?
`scan_cross_exchange_perp_price_spreads`	Where do current perpetual best bids and asks diverge across venues, after fee estimates and a visible top-of-book capacity check?

Funding rate and spread engines

The three concepts are deliberately separate:

hyperliquid_list_funding_rates describes the current Hyperliquid main and HIP-3 funding universe, including exact trailing-24h sums for the returned page.
scan_cross_exchange_funding_spreads normalizes one-hour and eight-hour settlement intervals, then compares a lower-funding long leg with a higher-funding short leg. Its annualized number is a comparison, not a forecast.
scan_cross_exchange_perp_price_spreads compares public top-of-book 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.

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

Install with npm

The public package is market-depth-lab-mcp-server.

Use this configuration in an MCP client that supports local stdio servers:

"mcpServers": { "market-depth-lab": { "command": "npx", "args": ["-y", "market-depth-lab-mcp-server"] } } }

npx downloads the published package and starts the local read-only MCP process. No exchange login, wallet connection or API key is required.

Install from source

git clone https://github.com/derkcc/market-depth-lab-mcp.git

cd market-depth-lab-mcp npm ci npm run build

Use the absolute path to dist/index.js in your MCP client:

"mcpServers": { "market-depth-lab": { "command": "node", "args": ["/absolute/path/to/market-depth-lab-mcp/dist/index.js"] } } }

Use the source checkout when you want to review or modify the implementation; use the npm configuration above for the shortest installation path.

Example prompts

Show the five Hyperliquid markets with the highest absolute current funding.

Include trailing 24h funding and explain who pays whom.

Compare BTC, ETH, SOL and HYPE funding on Binance, OKX and Hyperliquid.

Assume a 24-hour holding period and 12 bps of total round-trip costs. Show the current annualized spread, projected net carry and break-even hours.

Scan BTC, ETH and SOL perpetual top-of-book spreads across Binance, OKX and

Hyperliquid. Use round-trip taker fees, require at least $5,000 visible at the selected levels, and explain every non-execution boundary.

Analyze 0x... on Hyperliquid. Summarize gross exposure, effective leverage,

largest position and recent realized PnL. Do not give trading advice.

Within the monitored cohort, list the top BTC positions and separate longs

from shorts. State the cohort boundary before the ranking.

Estimate round-trip taker fees for a $25,000 tier-zero perpetual position.

Data and privacy

Capability	Data path
HYPE, wallet and Hyperliquid funding	Your local MCP process → public Hyperliquid `info` API
Cross-exchange funding spreads	Your local MCP process → public Binance USD-M, OKX and Hyperliquid market-data APIs
Cross-exchange price spreads	Your local MCP process → public Binance USD-M and OKX book-ticker APIs plus Hyperliquid `l2Book`
Active TWAPs	Your local MCP process → public HypurrScan endpoint, plus Hyperliquid price references
Large positions and top holders	Your local MCP process → Market Depth Lab's rolling read-only position index
Fee calculator	Runs locally; no network request

The server has no analytics or telemetry. A wallet address submitted to analyze_hyperliquid_wallet is sent directly from your machine to the public Hyperliquid API. Position-index calls use https://data.marketdepthlab.com/v1/positions/latest.

Public exchange endpoints can be unavailable in some regions. Both cross-exchange tools expose per-venue available, partial or unavailable coverage and their error messages. They never silently claim that a two-venue or three-venue comparison was complete.

Position-index boundary

Market Depth Lab rotates through a monitored pool of public addresses. The index is useful for cohort-level market structure, but it is:

not a list of every Hyperliquid account;
not a simultaneous snapshot of all monitored addresses;
not proof of who controls an address;
not a recommendation to copy any address.

Every position tool reports the snapshot time, age, monitored-address count, staleness state and coverage boundary.

Configuration

All variables are optional.

Variable	Default	Purpose
`MDL_POSITION_INDEX_URL`	`https://data.marketdepthlab.com/v1/positions/latest`	Remote read-only position index
`MDL_POSITION_INDEX_PATH`	unset	Load a local JSON snapshot instead of the remote index
`MDL_MAX_SNAPSHOT_AGE_HOURS`	`24`	Mark a position snapshot stale after this age
`MDL_REJECT_STALE`	`false`	Return an error instead of labeled stale data
`MDL_HTTP_TIMEOUT_MS`	`15000`	Per-request network timeout

When MDL_POSITION_INDEX_PATH is set, the two position tools do not make a network request. Other live-data tools still use public upstream APIs.

Development

npm ci

npm run check npm test npm pack --dry-run

The test suite performs an in-memory MCP handshake, verifies the nine tool definitions and calls the local fee tool through the protocol. Live upstream smoke tests should be run before each release, but are intentionally excluded from deterministic CI.

Public project links

Website: https://marketdepthlab.com
Live tools: https://marketdepthlab.com
Issues: GitHub Issues
Security: SECURITY.md
Contributing: CONTRIBUTING.md

License

MIT

Market Depth Lab

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Otheri

Common questions

Alternatives

Spec Driven Development

Remote Desktop Commander

Signoff

README from the maker

Market Depth Lab MCP

Why this server

Tools

Funding rate and spread engines

Requirements

Install with npm

Install from source

Example prompts

Data and privacy

Position-index boundary

Configuration

Development

Public project links

License