Plumbline
Provides read-only Sui DeepBook v3 market data, including pools, mid price and spread, order book depth, volume, live on-chain fees, recent trades, OHLCV candles, BalanceManager fills, swing ranges, pool stats, and fee estimates.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
The Spice Melange Trading Desk: DeepBook market data connector
Read-only DeepBook v3 market data for AI agents. (Package, server id and endpoint keep the name plumbline.)
The Spice Melange Trading Desk (DeepBook market data connector, package plumbline-mcp) is a free, read-only Model Context Protocol server for Sui DeepBook v3 market data. It gives agents pools, mid price and spread, order book depth, volume, live on-chain fees, recent trades and OHLCV candles.
No API keys, no wallet, no signing, no trading. Every tool is annotated
readOnlyHint: true.Small outputs. Compact JSON with column/row arrays for series and sensible rounding.
Fast and polite. An in-memory TTL cache (2 s for books, up to 10 min for metadata), de-duplicated requests and 8 s timeouts.
Disclaimer: for education and information only. This is not financial, investment, legal or tax advice. Data comes from public third-party sources (the Mysten Labs DeepBook indexer and Sui GraphQL). It may be delayed, incomplete or wrong, and is provided "as is" without warranty. Nothing here recommends buying, selling or holding any asset.
Quickstart
npx -y plumbline-mcpThe server runs over stdio and needs Node.js 18.17 or later. It needs no configuration.
Claude Code
claude mcp add plumbline -- npx -y plumbline-mcpClaude Desktop, Cursor, Windsurf, VS Code or any stdio client
Add this to your client's MCP config (claude_desktop_config.json, ~/.cursor/mcp.json, and so on):
{
"mcpServers": {
"plumbline": {
"command": "npx",
"args": ["-y", "plumbline-mcp"]
}
}
}Smithery
npx -y @smithery/cli@latest mcp add nazarenechalice/plumbline --client claude # or cursor, claude-code, vscode, windsurf, ...You can also open the Smithery listing. For one-click Claude Desktop install, download the .mcpb bundle there.
Hosted endpoint (remote, nothing to install)
A hosted instance runs at https://plumbline-mcp.fly.dev/mcp (streamable HTTP, stateless, JSON responses; health at /health, server card at /.well-known/mcp/server-card.json).
claude mcp add --transport http plumbline https://plumbline-mcp.fly.dev/mcpAny client that takes a remote MCP URL (Cursor, VS Code, Claude Desktop connectors, Windsurf):
{
"mcpServers": {
"plumbline": { "type": "http", "url": "https://plumbline-mcp.fly.dev/mcp" }
}
}The hosted endpoint gives each client 100 free tool calls per UTC day, then 0.002 USDC per call, prepaid in USDC on Sui mainnet in batches of about 0.01 USDC. get_indexer_status is always free. After the free calls, a tool returns an x402-style payment-required result with an exact amount and a private payment_token; see docs/PAYMENTS.md. The npm/stdio package stays free with no limits.
Streamable HTTP (self-hosted)
npx -y plumbline-mcp --http --port 8081 # POST http://127.0.0.1:8081/mcp, GET /health
HOST=0.0.0.0 PORT=8081 npx -y plumbline-mcp --httpHTTP mode is stateless and returns JSON. It also serves a static server card at /.well-known/mcp/server-card.json and rate-limits each client to 120 requests per minute. Put it behind TLS before you expose it. Hosting notes are in deploy/DEPLOY.md.
Related MCP server: 0xarchive-mcp
Ask your agent
"What's the spread on DeepBook SUI_USDC right now?"
"How much liquidity is within 1% of mid on SUI_USDC?"
"Show 1h candles for DEEP_USDC for the last day."
"Which DeepBook pools had the most volume in the last 24 hours?"
"What are the current taker and maker fees on SUI_USDC?"
The server also ships prompts (market_snapshot, compare_pools, liquidity_check) and resources (plumbline://guide, plumbline://disclaimer).
Tools
Tool | What it returns | Key inputs |
| All DeepBook pools: base/quote, tick, lot, min size, active flag |
|
| Best bid/ask, mid, spread (abs and bps), last price |
|
| Top N levels per side, plus base qty and quote notional within ±X% of mid |
|
| 24h base/quote volume, high/low, % change, VWAP; or top pools by volume; or a custom trailing window |
|
| Taker/maker fee (pct and bps), DEEP stake required, tick/lot/min, whitelist/stable flags, vault balances (live on-chain) |
|
| Latest fills: time, taker side, price, base and quote qty, buy/sell stats |
|
| Candles, oldest first; volume in the base asset |
|
| Data-source health and freshness | none |
| Fills where one BalanceManager was maker (or taker): time, its side, price, qty, fee and fee token, tx |
|
| 1h/4h/24h range, realized vol, regime (CALM < 2%, ELEVATED 2-4%, HIGH_VOL > 4% 4h range) and a suggested rung count 3/4/5 |
|
| Scorecard-style stats over N hours: trades, taker buy/sell split, volume, VWAP, avg trade, range, spread |
|
| Fee for a fill paid in the input token (rate x 1.25) vs in DEEP (base rate), from live on-chain rates |
|
Pool names use BASE_QUOTE (for example SUI_USDC). Input is case-insensitive, and sui/usdc or SUI-USDC also work. An unknown pool returns a clear error with suggestions; USDC_SUI, for example, suggests SUI_USDC.
Example output (live, Oct 9 2026)
get_mid_price with {"pool":"SUI_USDC"}:
{"pool":"SUI_USDC","quote":"USDC","best_bid":1.0708,"best_ask":1.07106,"mid":1.07093,"spread":0.00026,"spread_bps":2.428,"last_price":1.0708,"as_of":"2026-10-09T08:38:03.997Z"}One depth band from get_order_book (an earlier snapshot the same day):
{"pct":1,"bid_base":204536.4,"bid_quote":216152.61,"ask_base":105721.5,"ask_quote":113063.72,"bid_levels":26,"ask_levels":27}get_pool_params with {"pool":"SUI_USDC"} (read live from the on-chain Pool object; trimmed):
{"pool":"SUI_USDC","source":"sui-onchain","taker_fee":{"pct":0.02,"bps":2},"maker_fee":{"pct":0,"bps":0},"stake_required_deep":100000,"tick":0.00001,"lot":0.1,"min_size":1}get_ohlcv with {"pool":"SUI_USDC","interval":"1h","limit":2}:
{"pool":"SUI_USDC","interval":"1h","count":2,"cols":["open_time","open","high","low","close","volume_SUI"],"candles":[["2026-10-09T07:00:00Z",1.0658,1.07579,1.06268,1.07543,66001],["2026-10-09T08:00:00Z",1.07529,1.07817,1.06721,1.0708,26347.5]]}Configuration (all optional)
Env var | Default |
|
|
|
|
|
|
|
|
How it compares
Plumbline only reads data. Trading MCPs for DeepBook build transactions and may hold keys. Broad Sui analytics MCPs cover many protocols. Plumbline goes deep on DeepBook market data: depth bands around mid, live on-chain fees, OHLCV and pool-name suggestions. You can give it to any agent without risk to funds.
Data sources: books, trades, volume and candles come from the public DeepBook indexer. Fees and pool parameters come from the live Pool object via Sui GraphQL.
Optional: pay-per-call (off by default)
The stdio package is always free. The hosted endpoint meters calls (100 free per day, then 0.002 USDC per call). A self-hosted HTTP operator can choose to meter calls too, for example 100 free calls per day and then 0.002 USDC per call, paid in USDC on Sui. Metering is disabled unless PLUMBLINE_PAYMENTS=1 is set. The server is receive-only and never holds keys. The full design and security model are in docs/PAYMENTS.md.
Build from source
git clone https://github.com/SajanMelcher/plumbline-mcp.git
cd plumbline-mcp
npm install && npm run build
node dist/index.js # stdio; add --http for HTTPDevelopment
npm test # live tests against the public indexer (SUI_USDC); needs network
npm run smoke # spawns the server over stdio and calls every tool via the MCP client
npm run smoke:http # same over streamable HTTP
npm run inspector # MCP Inspector UI
npm run payments:testnet # Sui testnet end-to-end with a throwaway payer (needs testnet SUI + USDC)
npm run pack:mcpb # MCPB bundle at build/plumbline.mcpb, validated with mcpb + a Smithery payload check (publishes nothing)Notes and limits
The public indexer serves at most about 100 price levels per side. When a depth band reaches past that, the response marks it
truncated: true, and the value is a lower bound.list_poolsparameters come from indexer metadata.get_pool_paramsreads the live on-chain Pool object, so it is authoritative when tick sizes or fees change through governance.Fees are DeepBook fixed-point values (1e9 scale), converted to pct and bps.
No margin, balance-manager or wallet-specific endpoints are exposed.
Independence and name
Plumbline is named after a plumb line, the weighted cord used to measure depth and true vertical. Other candidates were Sounding and Tidemark. Plumbline is an independent community project. It is not affiliated with Mysten Labs, the Sui Foundation or DeepBook.
License
MIT. See LICENSE.
Store and desk tools (v0.3.3)
Four extra tools let an agent find, buy and join without a human checkout. They are free (not metered).
Tool | What it does |
| Templates, prices in Sui USDC, licence and the buying flow (from |
| Creates a store order and returns the payee, the exact amount and a private order token. Nothing is charged. A few orders per client per hour. |
| With your payment digest: verifies the payment on-chain and returns the download link. Without it: returns the order status. |
| The desk's weekly rhythm, with the ed25519 signature checked against the pinned release key. If the check fails, the call fails. Guidance only. |
You pay from your own wallet. The connector never holds keys or funds. Your order token goes only to https://thespicemelange.org (pinned), in a header, and is never stored. All sales are final. Not financial advice.
Safety details for the store tools:
Pinned store: they talk only to
https://thespicemelange.org. A preview store needs bothPLUMBLINE_STORE_URLandPLUMBLINE_ALLOW_PREVIEW_STORE=1, for testing only.Payee check:
create_template_orderreads the signedtemplates/versions.json, checked against the pinned release key. It refuses any order whose payee differs from the payee published there, or from the connector's own pin. Until the payee is published, the reply sayspayeeVerified: false: show the full address to your owner and get an explicit yes before paying.
Order limits (hosted). Each client (IPv4 address, or IPv6 /48) gets 3 new orders per hour and at most 2 unpaid orders open at once. The whole server allows 60 per hour and 15 open unpaid. These counters live in memory and reset when the server restarts. The store also enforces its own hourly limits, which persist in its KV: the hosted connector sends a store key and a hashed client id (never the IP), so the store limits each forwarded client separately instead of treating the connector's shared IP as one client. Unpaid orders expire after the store's 30-minute payment window.
Available Tools
16 toolscheck_template_orderVerify payment / get downloadAIdempotentInspect
With a digest: verify your on-chain payment for an order and get the signed download link (plus add-ons). Without: return the order's status (and a fresh link once paid). The token is sent only to the store, in a header, and is never stored. Educational templates, not financial advice; no returns promised. All sales final, except where the law requires otherwise. You pay from your own wallet; this connector never holds keys or funds.
Inputs: token (required), order_id (required), digest.
create_template_orderCreate a template orderAInspect
Create a store order for one template. Returns the order id, a PRIVATE order token (shown once; keep it secret), the payee and the EXACT Sui USDC amount to send from your own wallet before the expiry. Nothing is charged by this call. Limited to a few orders per client per hour. Educational templates, not financial advice; no returns promised. All sales final, except where the law requires otherwise. You pay from your own wallet; this connector never holds keys or funds.
Inputs: sku (required), email.
estimate_feesFee estimate (input token vs DEEP)ARead-onlyIdempotentInspect
Estimated DeepBook fee for a fill of qty at price as maker or taker, paid in the input token (rate x 1.25) versus in DEEP (base rate), using the live on-chain fee rates and the DEEP_USDC mid. Education/information only; not financial advice. Read-only public data, may be delayed or wrong.
Inputs: qty (required), pool (required), role, price.
get_bm_fillsFill history for a balance managerBRead-onlyIdempotentInspect
Fills (OrderFilled) where a given DeepBook BalanceManager was the maker or the taker in one pool, newest first: time, its side, price, qty, fee, tx. Public data; no keys. Education/information only; not financial advice. Read-only public data, may be delayed or wrong.
Inputs: pool (required), balance_manager_id (required), role, hours, +1 more.
get_desk_rhythmDesk rhythm (signed guidance)ARead-onlyIdempotentInspect
The desk's weekly rhythm from https://thespicemelange.org/rhythm.json: focus pools, ladder windows, rung guidance, rebalance ranges, projects and lessons. The ed25519 signature is verified against the pinned release key, and the call fails closed if it doesn't match. Guidance only: no orders, no sizes in money, no promised returns. Not financial advice.
Inputs: no named parameters.
get_indexer_statusData source healthARead-onlyIdempotentInspect
Health and freshness of the public DeepBook indexer (status, latest checkpoint, server time). Use when data looks stale. Education/information only; not financial advice. Read-only public data, may be delayed or wrong.
Inputs: no named parameters.
get_mid_priceMid priceBRead-onlyIdempotentInspect
Best bid, best ask, mid price and spread (abs and bps) for a DeepBook pool, plus last trade price. Education/information only; not financial advice. Read-only public data, may be delayed or wrong.
Inputs: pool (required).
get_ohlcvOHLCV candlesARead-onlyIdempotentInspect
OHLCV candles for a DeepBook pool (oldest first). Intervals: 1m, 5m, 15m, 30m, 1h, 4h, 1d, 1w. Volume is in the base asset. Education/information only; not financial advice. Read-only public data, may be delayed or wrong.
Inputs: pool (required), limit, end_time, interval, +1 more.
get_order_bookOrder book depthARead-onlyIdempotentInspect
Order book for a DeepBook pool: top N price levels per side and cumulative liquidity (base qty and quote notional) within ±X% of mid. Education/information only; not financial advice. Read-only public data, may be delayed or wrong.
Inputs: pool (required), levels, within_pct.
get_pool_paramsFees and pool parametersARead-onlyIdempotentInspect
Taker/maker fees, DEEP stake required, tick/lot/min size, whitelist/stable flags and vault balances for a DeepBook pool. Reads the live on-chain Pool object via Sui GraphQL; falls back to indexer pool-creation values if GraphQL is unavailable. Education/information only; not financial advice. Read-only public data, may be delayed or wrong.
Inputs: pool (required).
get_pool_statsPool scorecard statsARead-onlyIdempotentInspect
Scorecard-style stats for one pool over the last N hours: trade count, taker buy/sell split, base/quote volume, VWAP, average trade size, price range, current spread. Education/information only; not financial advice. Read-only public data, may be delayed or wrong.
Inputs: pool (required), hours.
get_recent_tradesRecent tradesARead-onlyIdempotentInspect
Most recent fills in a DeepBook pool (newest first): time, taker side, price, base and quote size. Optional time range. Education/information only; not financial advice. Read-only public data, may be delayed or wrong.
Inputs: pool (required), limit, end_time, include_tx, +1 more.
get_swing_rangeSwing / range signalARead-onlyIdempotentInspect
1h/4h/24h high-low range and realized volatility from hourly candles, a regime (CALM < 2%, ELEVATED 2-4%, HIGH_VOL > 4% 4h range) and a suggested ladder rung count (3/4/5). Information only, not a trading instruction. Education/information only; not financial advice. Read-only public data, may be delayed or wrong.
Inputs: pool (required).
get_volumeTrading volumeARead-onlyIdempotentInspect
24h volume, high/low, last price and % change for one DeepBook pool, or the top pools by 24h quote volume if no pool is given. Set window_hours for a custom trailing window (single pool). Education/information only; not financial advice. Read-only public data, may be delayed or wrong.
Inputs: top, pool, window_hours.
list_poolsList DeepBook poolsARead-onlyIdempotentInspect
List Sui DeepBook v3 spot pools with base/quote assets and trading params (tick, lot, min size in human units). Optional filter by asset symbol. Education/information only; not financial advice. Read-only public data, may be delayed or wrong.
Inputs: asset, include_ids.
list_templatesList desk templatesBRead-onlyIdempotentInspect
List The Spice Melange Golden Path Grok Bot templates with prices in Sui USDC, versions and the no-checkout agent buying flow (from https://thespicemelange.org/store/catalog.json). Educational templates, not financial advice; no returns promised. All sales final, except where the law requires otherwise. You pay from your own wallet; this connector never holds keys or funds.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 16 tools
Most market-data tools target distinct queries (book, candles, recent trades, fees, indexer health), but the stats cluster overlaps heavily: get_volume, get_pool_stats, and get_swing_range all return price ranges, volume, and volatility over similar windows, and get_recent_trades vs get_bm_fills both return fills with only a filter difference. An agent can pick reasonably from the descriptions, but it must read carefully to avoid redundant or wrong-stat calls.
Nearly all 16 names follow a snake_case verb_noun pattern (get_*, list_*, estimate_*, create_*), which is predictable and readable. Minor deviations are the abbreviations 'bm' and 'ohlcv' and the use of 'check_template_order' where 'get_' is the house style.
16 tools is at the upper edge but each one maps to a concrete endpoint with a stated output; none looks redundant enough to cut outright. The caveat is that the surface spans two unrelated domains (DeepBook market data and a template store), which inflates the count relative to either purpose alone.
The read-only market-data side is thorough: pools, params, book, fills, OHLCV, volume, volatility, fees, and indexer health are all covered, and the store flow has list/create/check. Gaps are minor — no slippage/depth-cost estimation beyond fee quotes, no way to list a client's own past orders without an order id, and no cross-pool comparison tool beyond the top-volume default.
Related MCP Connectors
Historical tick, order book and settlement data for Polymarket and Predict.fun crypto up/down markets, plus smart-money lists and backtest quotes, over a read-only MCP server.
Hyperliquid MCP — read-only market data from Hyperliquid's public info API.
Read-only market data: tokens, stocks, Hyperliquid perps, Polymarket, and public trader books.
Read-only MCP server for The Quiet Protocol's engines, benchmarks, proof, and business data.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that provides structured access to Aster DEX market data—covering candlesticks, order books, trades, and funding rates.115MIT
- AlicenseBqualityBmaintenanceMCP server for querying historical and real-time crypto market data across Hyperliquid, Hyperliquid HIP-3, and Lighter.xyz - orderbooks, trades, candles, funding, open interest, liquidations, and data quality metrics.10064 npm13MIT
- AlicenseNot gradedqualityDmaintenanceA read-only MCP server for Hyperliquid that provides public market data (prices, order books, funding) and any wallet's positions, orders, and fills via MCP tools, without requiring a private key.MIT
- AlicenseAqualityBmaintenanceRead-only MCP server for Sui blockchain analytics with 44 tools covering wallets, DeFi, NFTs, token prices, transactions, fund tracing, pools, staking, Move decompilation, and MVR name resolution.19475 npm4MIT