Open source · MIT

Plumbline for DeepBook

A free, read-only Model Context Protocol server for Sui DeepBook v3 market data. Give any AI agent pools, mid and spread, order-book depth, volume, live fees, trades and candles. No API keys, no wallet, no signing, no trading.

View on GitHub Smithery listing See it live

Install

One line, no configuration

Runs over stdio and needs Node.js 18.17 or later.

npx

npx -y plumbline-mcp

Claude Code

claude mcp add plumbline -- npx -y plumbline-mcp

Smithery CLI

npx -y @smithery/cli@latest mcp add nazarenechalice/plumbline --client cursor

Cursor, Claude Desktop, VS Code, Windsurf (mcp.json)

{
  "mcpServers": {
    "plumbline": {
      "command": "npx",
      "args": ["-y", "plumbline-mcp"]
    }
  }
}

npm
plumbline-mcp
Smithery
nazarenechalice/plumbline
MCP Registry
io.github.SajanMelcher/plumbline-mcp
GitHub
SajanMelcher/plumbline-mcp

Tools

Eight read-only tools

Every tool is annotated readOnlyHint. Outputs are compact JSON, cached briefly, with 8-second timeouts.

Plumbline tools, what they return and their key inputs
Tool	Returns	Key inputs
list_pools	All DeepBook pools: base/quote, tick, lot, min size, active flag	asset?, include_ids?
get_mid_price	Best bid/ask, mid, spread (abs and bps), last price	pool
get_order_book	Top N levels per side, plus liquidity within ±X% of mid	pool, levels, within_pct
get_volume	24h volume, high/low, % change, VWAP; or top pools by volume	pool?, window_hours, top
get_pool_params	Live on-chain taker/maker fees, DEEP stake, tick/lot/min size	pool
get_recent_trades	Latest fills: time, side, price, size, buy/sell stats	pool, limit, start_time?, end_time?
get_ohlcv	OHLCV candles, oldest first	pool, interval, limit
get_indexer_status	Data-source health and freshness	—

Try asking your agent: “What’s the spread on DeepBook SUI_USDC right now?” or “How much liquidity is within 1% of mid?”

Pricing

Free, with optional pay-per-call later

Local (stdio)

Free

The npm package is always free. Run it on your own machine with no account and no keys.

Coming soon

Hosted HTTP

100 free calls/day

Then 0.002 USDC per call, paid in USDC on Sui. Receive-only: the server never holds keys. Not live until a hosted endpoint launches.