Plumbline
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HOST | No | Host/interface to bind in streamable HTTP mode (e.g. 0.0.0.0 to expose). | 127.0.0.1 |
| PORT | No | Port for streamable HTTP mode (used with --http). | 8081 |
| PLUMBLINE_PAYMENTS | No | Set to 1 to enable pay-per-call metering on a self-hosted HTTP instance (off by default). | 0 |
| PLUMBLINE_STORE_URL | No | Preview store URL for the store tools, for testing only. Requires PLUMBLINE_ALLOW_PREVIEW_STORE=1. | |
| PLUMBLINE_TIMEOUT_MS | No | Request timeout in milliseconds. | 8000 |
| PLUMBLINE_GRAPHQL_URL | No | Sui GraphQL endpoint used to read live Pool objects (fees and pool parameters). | https://graphql.mainnet.sui.io/graphql |
| PLUMBLINE_INDEXER_URL | No | URL of the DeepBook indexer used for books, trades, volume and candles. | https://deepbook-indexer.mainnet.mystenlabs.com |
| PLUMBLINE_ALLOW_PREVIEW_STORE | No | Set 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
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
| market_snapshot | Summarize one DeepBook pool: mid, spread, 1% depth, 24h volume and fees |
| compare_pools | Compare spread, depth and volume across several DeepBook pools |
| liquidity_check | Estimate how much size sits near mid on a DeepBook pool before a hypothetical order |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| guide | Pool naming, tools, data sources and disclaimer |
| disclaimer | Education-only disclaimer for all The Spice Melange Trading Desk data |
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.