Skip to main content
Glama

The Spice Melange Trading Desk: DeepBook market data connector

by io.github.SajanMelcher
OverviewDiscussionsAdmin

Server Details

A Mentat's eye on Sui DeepBook v3: read-only market data plus desk template tools. No keys.

If you are the author of this connector, you can claim ownership by verifying the domain or GitHub account it belongs to. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
Repository
SajanMelcher/plumbline-mcp
GitHub Stars
0

TDQS

Score is being calculated.

Available Tools

16 tools
check_template_orderVerify payment / get download
Idempotent
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
tokenYesPrivate order token from create_template_order (smt_...). Sent only to the store, in a header.
digestNoSui transaction digest of your exact USDC payment
order_idYesOrder id from create_template_order (SM-...)
create_template_orderCreate a template orderInspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
skuYesTemplate sku from list_templates, e.g. dune-saga-collection or fish-speakers
emailNoOptional receipt email
estimate_feesFee estimate (input token vs DEEP)
Read-onlyIdempotent
Inspect

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. Free: 100 calls/day per client, then 0.002 USDC per call on Sui mainnet, prepaid in batches of about 0.01 USDC (the payment-required response gives an exact amount and a payment_token).

ParametersJSON Schema
NameRequiredDescriptionDefault
qtyYesBase quantity
poolYesDeepBook pool name BASE_QUOTE, e.g. SUI_USDC (case-insensitive; '/' or '-' also accepted)
roleNotaker
priceNoPrice; defaults to the current mid
payment_txNoOnly after the free tier: Sui transaction digest of your exact USDC payment for payment_token (see the payment-required response)
payment_tokenNoOnly after the free tier: the private payment_token from the payment-required response; it holds your prepaid calls
get_bm_fillsFill history for a balance manager
Read-onlyIdempotent
Inspect

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. Free: 100 calls/day per client, then 0.002 USDC per call on Sui mainnet, prepaid in batches of about 0.01 USDC (the payment-required response gives an exact amount and a payment_token).

ParametersJSON Schema
NameRequiredDescriptionDefault
poolYesDeepBook pool name BASE_QUOTE, e.g. SUI_USDC (case-insensitive; '/' or '-' also accepted)
roleNomaker
hoursNoLook-back window in hours (default 168 = 7 days)
limitNo
payment_txNoOnly after the free tier: Sui transaction digest of your exact USDC payment for payment_token (see the payment-required response)
payment_tokenNoOnly after the free tier: the private payment_token from the payment-required response; it holds your prepaid calls
balance_manager_idYesDeepBook BalanceManager object id (0x + 64 hex)
get_desk_rhythmDesk rhythm (signed guidance)
Read-onlyIdempotent
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

get_indexer_statusData source health
Read-onlyIdempotent
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

get_mid_priceMid price
Read-onlyIdempotent
Inspect

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. Free: 100 calls/day per client, then 0.002 USDC per call on Sui mainnet, prepaid in batches of about 0.01 USDC (the payment-required response gives an exact amount and a payment_token).

ParametersJSON Schema
NameRequiredDescriptionDefault
poolYesDeepBook pool name BASE_QUOTE, e.g. SUI_USDC (case-insensitive; '/' or '-' also accepted)
payment_txNoOnly after the free tier: Sui transaction digest of your exact USDC payment for payment_token (see the payment-required response)
payment_tokenNoOnly after the free tier: the private payment_token from the payment-required response; it holds your prepaid calls
get_ohlcvOHLCV candles
Read-onlyIdempotent
Inspect

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. Free: 100 calls/day per client, then 0.002 USDC per call on Sui mainnet, prepaid in batches of about 0.01 USDC (the payment-required response gives an exact amount and a payment_token).

ParametersJSON Schema
NameRequiredDescriptionDefault
poolYesDeepBook pool name BASE_QUOTE, e.g. SUI_USDC (case-insensitive; '/' or '-' also accepted)
limitNoNumber of candles (1-500, default 24)
end_timeNoUnix timestamp in SECONDS
intervalNo1h
payment_txNoOnly after the free tier: Sui transaction digest of your exact USDC payment for payment_token (see the payment-required response)
start_timeNoUnix timestamp in SECONDS
payment_tokenNoOnly after the free tier: the private payment_token from the payment-required response; it holds your prepaid calls
get_order_bookOrder book depth
Read-onlyIdempotent
Inspect

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. Free: 100 calls/day per client, then 0.002 USDC per call on Sui mainnet, prepaid in batches of about 0.01 USDC (the payment-required response gives an exact amount and a payment_token).

ParametersJSON Schema
NameRequiredDescriptionDefault
poolYesDeepBook pool name BASE_QUOTE, e.g. SUI_USDC (case-insensitive; '/' or '-' also accepted)
levelsNoPrice levels to return per side (1-100, default 10)
payment_txNoOnly after the free tier: Sui transaction digest of your exact USDC payment for payment_token (see the payment-required response)
within_pctNoDepth bands as % distance from mid, e.g. [0.5, 1, 2]
payment_tokenNoOnly after the free tier: the private payment_token from the payment-required response; it holds your prepaid calls
get_pool_paramsFees and pool parameters
Read-onlyIdempotent
Inspect

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. Free: 100 calls/day per client, then 0.002 USDC per call on Sui mainnet, prepaid in batches of about 0.01 USDC (the payment-required response gives an exact amount and a payment_token).

ParametersJSON Schema
NameRequiredDescriptionDefault
poolYesDeepBook pool name BASE_QUOTE, e.g. SUI_USDC (case-insensitive; '/' or '-' also accepted)
payment_txNoOnly after the free tier: Sui transaction digest of your exact USDC payment for payment_token (see the payment-required response)
payment_tokenNoOnly after the free tier: the private payment_token from the payment-required response; it holds your prepaid calls
get_pool_statsPool scorecard stats
Read-onlyIdempotent
Inspect

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. Free: 100 calls/day per client, then 0.002 USDC per call on Sui mainnet, prepaid in batches of about 0.01 USDC (the payment-required response gives an exact amount and a payment_token).

ParametersJSON Schema
NameRequiredDescriptionDefault
poolYesDeepBook pool name BASE_QUOTE, e.g. SUI_USDC (case-insensitive; '/' or '-' also accepted)
hoursNo
payment_txNoOnly after the free tier: Sui transaction digest of your exact USDC payment for payment_token (see the payment-required response)
payment_tokenNoOnly after the free tier: the private payment_token from the payment-required response; it holds your prepaid calls
get_recent_tradesRecent trades
Read-onlyIdempotent
Inspect

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. Free: 100 calls/day per client, then 0.002 USDC per call on Sui mainnet, prepaid in batches of about 0.01 USDC (the payment-required response gives an exact amount and a payment_token).

ParametersJSON Schema
NameRequiredDescriptionDefault
poolYesDeepBook pool name BASE_QUOTE, e.g. SUI_USDC (case-insensitive; '/' or '-' also accepted)
limitNoNumber of trades (1-200, default 20)
end_timeNoUnix timestamp in SECONDS
include_txNoInclude transaction digests (longer output)
payment_txNoOnly after the free tier: Sui transaction digest of your exact USDC payment for payment_token (see the payment-required response)
start_timeNoUnix timestamp in SECONDS
payment_tokenNoOnly after the free tier: the private payment_token from the payment-required response; it holds your prepaid calls
get_swing_rangeSwing / range signal
Read-onlyIdempotent
Inspect

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. Free: 100 calls/day per client, then 0.002 USDC per call on Sui mainnet, prepaid in batches of about 0.01 USDC (the payment-required response gives an exact amount and a payment_token).

ParametersJSON Schema
NameRequiredDescriptionDefault
poolYesDeepBook pool name BASE_QUOTE, e.g. SUI_USDC (case-insensitive; '/' or '-' also accepted)
payment_txNoOnly after the free tier: Sui transaction digest of your exact USDC payment for payment_token (see the payment-required response)
payment_tokenNoOnly after the free tier: the private payment_token from the payment-required response; it holds your prepaid calls
get_volumeTrading volume
Read-onlyIdempotent
Inspect

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. Free: 100 calls/day per client, then 0.002 USDC per call on Sui mainnet, prepaid in batches of about 0.01 USDC (the payment-required response gives an exact amount and a payment_token).

ParametersJSON Schema
NameRequiredDescriptionDefault
topNoWhen no pool is given: how many pools to return (default 10)
poolNoDeepBook pool name BASE_QUOTE, e.g. SUI_USDC (case-insensitive; '/' or '-' also accepted)
payment_txNoOnly after the free tier: Sui transaction digest of your exact USDC payment for payment_token (see the payment-required response)
window_hoursNoTrailing window in hours (default 24). Non-24 values need a pool.
payment_tokenNoOnly after the free tier: the private payment_token from the payment-required response; it holds your prepaid calls
list_poolsList DeepBook pools
Read-onlyIdempotent
Inspect

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. Free: 100 calls/day per client, then 0.002 USDC per call on Sui mainnet, prepaid in batches of about 0.01 USDC (the payment-required response gives an exact amount and a payment_token).

ParametersJSON Schema
NameRequiredDescriptionDefault
assetNoOnly pools containing this asset symbol, e.g. SUI or USDC
payment_txNoOnly after the free tier: Sui transaction digest of your exact USDC payment for payment_token (see the payment-required response)
include_idsNoInclude pool object IDs and coin types (longer output)
payment_tokenNoOnly after the free tier: the private payment_token from the payment-required response; it holds your prepaid calls
list_templatesList desk templates
Read-onlyIdempotent
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 16 tool updates
    • First observedcheck_template_order
    • First observedcreate_template_order
    • First observedestimate_fees
    • First observedget_bm_fills
    • First observedget_desk_rhythm
    • First observedget_indexer_status
    • First observedget_mid_price
    • First observedget_ohlcv
    • First observedget_order_book
    • First observedget_pool_params
    • First observedget_pool_stats
    • First observedget_recent_trades
    • First observedget_swing_range
    • First observedget_volume
    • First observedlist_pools
    • First observedlist_templates

Related MCP Connectors

Related MCP Servers

  • dydx-agent-gateway

    alekskram
    A
    license
    A
    quality
    A
    maintenance
    Analytics-only MCP gateway to dYdX v4. 22 read-only tools: market data, funding heatmap, verified trader PnL with deposit-adjusted metrics and identity reconciliation (phantom-data detector), leaderboards with farmer flags, liquidation cascade detection, OI anomaly alerts, cross-asset correlation/beta, CVD, ATR risk plans. Zero keys, zero setup, pip install and go.
    22
    36 PyPI
    1
    MIT

  • markettrace-agent-feed

    MarketTrace
    A
    license
    Not graded
    quality
    B
    maintenance
    Read-only crypto perps microstructure for AI agents: normalized cross-exchange market state (funding + multi-year percentile, OI, volume, CVD, order-book imbalance, liquidations, basis), OHLCV, 15-min state history, and measured conditional outcomes (historical base rates, not predictions) — 6 assets across Binance, Bybit, OKX and Hyperliquid, every metric with self-declared coverage and freshness
    MIT

  • market-depth-lab-mcp

    derkcc
    A
    license
    A
    quality
    B
    maintenance
    Read-only Hyperliquid and cross-exchange market research for AI agents, providing structured tools for live market data without requiring authentication.
    9
    43 npm
    MIT
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources