Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
HOSTNoHost/interface to bind in streamable HTTP mode (e.g. 0.0.0.0 to expose).127.0.0.1
PORTNoPort for streamable HTTP mode (used with --http).8081
PLUMBLINE_PAYMENTSNoSet to 1 to enable pay-per-call metering on a self-hosted HTTP instance (off by default).0
PLUMBLINE_STORE_URLNoPreview store URL for the store tools, for testing only. Requires PLUMBLINE_ALLOW_PREVIEW_STORE=1.
PLUMBLINE_TIMEOUT_MSNoRequest timeout in milliseconds.8000
PLUMBLINE_GRAPHQL_URLNoSui GraphQL endpoint used to read live Pool objects (fees and pool parameters).https://graphql.mainnet.sui.io/graphql
PLUMBLINE_INDEXER_URLNoURL of the DeepBook indexer used for books, trades, volume and candles.https://deepbook-indexer.mainnet.mystenlabs.com
PLUMBLINE_ALLOW_PREVIEW_STORENoSet to 1 to allow the preview store URL for the store tools (testing only).

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}
resources
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
list_poolsA

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.

get_mid_priceB

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.

get_order_bookA

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.

get_volumeA

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.

get_pool_paramsA

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.

get_recent_tradesA

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.

get_ohlcvA

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.

get_indexer_statusA

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.

get_bm_fillsB

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.

get_swing_rangeA

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.

get_pool_statsA

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.

estimate_feesA

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.

list_templatesB

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.

create_template_orderA

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.

check_template_orderA

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.

get_desk_rhythmA

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.

Prompts

Interactive templates invoked by user choice

NameDescription
market_snapshotSummarize one DeepBook pool: mid, spread, 1% depth, 24h volume and fees
compare_poolsCompare spread, depth and volume across several DeepBook pools
liquidity_checkEstimate how much size sits near mid on a DeepBook pool before a hypothetical order

Resources

Contextual data attached and managed by the client

NameDescription
guidePool naming, tools, data sources and disclaimer
disclaimerEducation-only disclaimer for all The Spice Melange Trading Desk data

TDQS

A3.7/5.0

Scored across 16 tools

Disambiguation3/5

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.

Naming Consistency4/5

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.

Tool Count4/5

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.

Completeness4/5

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.