Skip to main content
Glama

The Spice Melange Trading Desk: DeepBook market data connector

Server Details

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

Ownership verified
Status
Healthy
Uptime
100.0% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
Server Listing
Plumbline
ChatGPT
–
Claude
–

TDQS

A3.5/5.0

Scored across 31 tools

Disambiguation4/5

Most tools have distinct purposes, but there is notable overlap among market-data reads: get_book_depth and get_order_book both return order-book depth, and get_volume, get_pool_stats, and get_swing_range overlap on volume/range statistics. Descriptions help, but an agent could still misselect in these areas.

Naming Consistency4/5

Tool names are predominantly snake_case with verb_noun patterns (e.g., get_mid_price, build_swap_tx, list_pools), but three guides (wallet_setup_guide, walrus_store_guide, golden_path_market_read) deviate from the verb-first convention. The mix is minor but noticeable.

Tool Count2/5

31 tools is excessive for a single MCP server, especially one named a 'market data connector' that also bundles transaction builders, store/e-commerce, Walrus storage, and guide tools. This breadth suggests scope creep and could overwhelm an agent.

Completeness4/5

The surface covers market data, trading transaction building, wallet setup, and storage well, but gaps remain: no tool to query open orders or BalanceManager balances, and no order-status check for trading orders (only for templates). These are minor but could cause dead ends for active traders.

Available Tools

31 tools
build_bm_deposit_txBuild: deposit into my BalanceManagerA
Read-only
Inspect

Deposit a coin from your wallet into your own BalanceManager. Returns UNSIGNED tx bytes (simulated against mainnet). Non-custodial: the desk never sees or holds keys and never moves funds; it returns quotes and UNSIGNED transactions only. Spot only, no leverage. Education only, not financial advice.

Inputs: coin (required), amount (required), sender (required), balance_manager_id (required).

build_bm_withdraw_txBuild: withdraw from my BalanceManagerA
Read-only
Inspect

Withdraw a coin from your own BalanceManager back to your address (always to the owner). Returns UNSIGNED tx bytes (simulated against mainnet). Non-custodial: the desk never sees or holds keys and never moves funds; it returns quotes and UNSIGNED transactions only. Spot only, no leverage. Education only, not financial advice.

Inputs: coin (required), amount (required), sender (required), balance_manager_id (required).

build_cancel_order_txBuild: cancel DeepBook order(s)A
Read-only
Inspect

Cancel one order (order_id) or all your orders in a pool, and withdraw settled amounts into your BalanceManager. Returns UNSIGNED tx bytes (simulated against mainnet). Non-custodial: the desk never sees or holds keys and never moves funds; it returns quotes and UNSIGNED transactions only. Spot only, no leverage. Education only, not financial advice.

Inputs: pool (required), sender (required), balance_manager_id (required), order_id.

build_create_balance_manager_txBuild: create my DeepBook BalanceManagerA
Read-only
Inspect

Create and share a DeepBook v3 BalanceManager owned by your address (needed for limit orders). Returns UNSIGNED tx bytes (simulated against mainnet). Non-custodial: the desk never sees or holds keys and never moves funds; it returns quotes and UNSIGNED transactions only. Spot only, no leverage. Education only, not financial advice.

Inputs: sender (required).

build_limit_order_txBuild: DeepBook limit orderA
Read-only
Inspect

Place a spot limit order on a DeepBook v3 pool from your BalanceManager (fees in the input coin, no DEEP needed). Validates tick/lot/min size. Optional deposit_first funds it in the same tx. No leverage. Returns UNSIGNED tx bytes (simulated against mainnet). Non-custodial: the desk never sees or holds keys and never moves funds; it returns quotes and UNSIGNED transactions only. Spot only, no leverage. Education only, not financial advice.

Inputs: pool (required), side (required), price (required), sender (required), +6 more.

build_swap_txBuild UNSIGNED swap transactionA
Read-only
Inspect

Build base64 UNSIGNED Sui transaction bytes for a swap on the chosen venue, with the sender set to your address and an on-chain minimum-out from slippage_bps. The bytes are simulated against mainnet before return. You sign locally and submit yourself; nothing is executed by the desk. Non-custodial: the desk never sees or holds keys and never moves funds; it returns quotes and UNSIGNED transactions only. Spot only, no leverage. Education only, not financial advice.

Inputs: to (required), from (required), venue (required), amount (required), +4 more.

build_walrus_register_txBuild: Walrus register blobA
Read-only
Inspect

Encode your public text (receipt/note) and build the Walrus register-blob tx paid in WAL by you; returns the blob_id. Then upload+certify locally (see walrus_store_guide). Refuses content that looks like a secret. Returns UNSIGNED tx bytes (simulated against mainnet). Non-custodial: the desk never sees or holds keys and never moves funds; it returns quotes and UNSIGNED transactions only. Spot only, no leverage. Education only, not financial advice.

Inputs: sender (required), content (required), epochs.

check_holderThe Secret Journals holder checkA
Read-onlyIdempotent
Inspect

Check on chain (Sui mainnet) whether an address holds the The Secret Journals license token. Holders unlock extra read-only education tools (golden_path_market_read). Non-holders keep every basic tool. Non-custodial: the desk never sees or holds keys and never moves funds; it returns quotes and UNSIGNED transactions only. Spot only, no leverage. Education only, not financial advice.

Inputs: address (required).

check_template_orderVerify payment / get downloadA
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.

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)A
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).

Inputs: qty (required), pool (required), role, price, +2 more.

get_bm_fillsFill history for a balance managerA
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).

Inputs: pool (required), balance_manager_id (required), role, hours, +3 more.

get_book_depthDeepBook depth (on-chain)C
Read-onlyIdempotent
Inspect

Level-2 depth around mid read on chain from a DeepBook v3 pool (bids/asks [price, qty]). Non-custodial: the desk never sees or holds keys and never moves funds; it returns quotes and UNSIGNED transactions only. Spot only, no leverage. Education only, not financial advice.

Inputs: pool (required), ticks.

get_cetus_poolCetus CLMM pool infoB
Read-onlyIdempotent
Inspect

Read-only Cetus CLMM pool state (coins, fee rate, tick spacing, liquidity, current tick, price) by pool_id, or discover the Cetus pools on the current from->to route. Non-custodial: the desk never sees or holds keys and never moves funds; it returns quotes and UNSIGNED transactions only. Spot only, no leverage. Education only, not financial advice.

Inputs: to, from, pool_id.

get_desk_rhythmDesk rhythm (signed guidance)A
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.

Inputs: no named parameters.

get_indexer_statusData source healthA
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.

Inputs: no named parameters.

get_mid_priceMid priceA
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).

Inputs: pool (required), payment_tx, payment_token.

get_ohlcvOHLCV candlesA
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).

Inputs: pool (required), limit, end_time, interval, +3 more.

get_order_bookOrder book depthA
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).

Inputs: pool (required), levels, payment_tx, within_pct, +1 more.

get_pool_paramsFees and pool parametersA
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).

Inputs: pool (required), payment_tx, payment_token.

get_pool_statsPool scorecard statsA
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).

Inputs: pool (required), hours, payment_tx, payment_token.

get_recent_tradesRecent tradesA
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).

Inputs: pool (required), limit, end_time, include_tx, +3 more.

get_swap_quoteSwap quote: DeepBook v3 vs Cetus aggregatorA
Read-only
Inspect

Quote a spot swap between SUI/USDC/WAL/DEEP/CETUS and compare DeepBook v3 pools directly (direct or 2-hop) with the Cetus aggregator. Returns the best route, expected output, price impact and fees. Non-custodial: the desk never sees or holds keys and never moves funds; it returns quotes and UNSIGNED transactions only. Spot only, no leverage. Education only, not financial advice.

Inputs: to (required), from (required), amount (required), sender (required).

get_swing_rangeSwing / range signalB
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).

Inputs: pool (required), payment_tx, payment_token.

get_volumeTrading volumeA
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).

Inputs: top, pool, payment_tx, window_hours, +1 more.

golden_path_market_readGolden Path market read (holders)A
Read-only
Inspect

For The Secret Journals holders (checked on chain from 'address'): a compact market read across SUI, WAL and DEEP on DeepBook (mid, spread, 24h volume, 1h/4h/24h range and regime) plus the Golden Path pre-trade checklist. Education only, not a signal to buy or sell, no return claims. Non-custodial: the desk never sees or holds keys and never moves funds; it returns quotes and UNSIGNED transactions only. Spot only, no leverage. Education only, not financial advice.

Inputs: address (required).

list_poolsList DeepBook poolsA
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).

Inputs: asset, payment_tx, include_ids, payment_token.

list_templatesList desk templatesB
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.

Inputs: no named parameters.

read_walrus_blobRead a Walrus blobB
Read-onlyIdempotent
Inspect

Read a public Walrus mainnet blob by id via the public aggregator (text, or base64 preview if binary; max 64 KB). Non-custodial: the desk never sees or holds keys and never moves funds; it returns quotes and UNSIGNED transactions only. Spot only, no leverage. Education only, not financial advice.

Inputs: blob_id (required), max_bytes.

wallet_setup_guideWallet setup guide (self-custody)A
Read-onlyIdempotent
Inspect

Exact steps and @mysten/sui code for an agent to create its OWN Sui Ed25519 keypair locally, fund it with SUI (gas) and USDC, and sign/submit transactions itself. Non-custodial: the desk never sees or holds keys and never moves funds; it returns quotes and UNSIGNED transactions only. Spot only, no leverage. Education only, not financial advice.

Inputs: no named parameters.

walrus_store_guideWalrus: store a public receipt/noteA
Read-onlyIdempotent
Inspect

How to store a PUBLIC trade receipt or strategy note on Walrus mainnet with your own key (receipt schema + @mysten/walrus code). Non-custodial: the desk never sees or holds keys and never moves funds; it returns quotes and UNSIGNED transactions only. Spot only, no leverage. Education only, not financial advice.

Inputs: no named parameters.

Tool Schema Changelog

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

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Read-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.
      19
      475 npm
      4
      MIT
    • A
      license
      A
      quality
      B
      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
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Connects Claude Desktop, Cursor, Windsurf, and autonomous agents to live prediction-market Level 2 orderbooks, cross-venue arbitrage scanning, quadratic fee calculations, whale trade monitoring, and multi-venue market search across seven venues.
      5
      MIT
    • A
      license
      Not graded
      quality
      C
      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
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.

    Resources