The Spice Melange Trading Desk: DeepBook market data connector MCP server

Plumbline: read-only DeepBook v3 market data for AI agents

Plumbline 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-mcp

The 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-mcp

Claude Desktop, Cursor, Windsurf, VS Code or any stdio client

Add this to your client's MCP config (claudedesktopconfig.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.

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 --http

HTTP 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.

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 (marketsnapshot, comparepools, liquidity_check) and resources (plumbline://guide, plumbline://disclaimer).

Tools

Shortened. The full README is on GitHub.