@yosuku/deepbook-predict-mcp

The first MCP server for DeepBook Predict — give an LLM a Sui prediction market.

An MCP server that lets any LLM agent read live DeepBook Predict markets, price any strike, check house solvency, place a position, and crank gas-negative redeems — Sui's volatility-surface prediction market, as agent tools.

An LLM, pricing a live BTC binary in one call:

quote_market(oracle, strike: 62000)
→ BTC above $62,000 (forward $62,196): 63.5% fair · 64.5¢ to buy UP · 1.93% round-trip

Install

// in your MCP client config (Claude Desktop, Cursor, etc.)
{
  "mcpServers": {
    "deepbook-predict": {
      "command": "npx",
      "args": ["-y", "@yosuku/deepbook-predict-mcp"]
    }
  }
}

That's read-only. To let the agent trade on-chain, add a signer:

"env": {
  "PREDICT_AGENT_KEY": "suiprivkey…",   // the agent's key (testnet throwaway)
  "PREDICT_MANAGER_ID": "0x…"           // optional; auto-discovered by owner
}

Tools

| Tool | Signs? | What it does | |---|---|---| | list_markets | no | live BTC oracles — id, expiry, strike grid, status | | quote_market | no | fair probability + UP/DOWN cost at a strike (SVI → N(d2), matched to the chain) | | house_health | no | the PLP vault — value, MTM, max payout, utilization, share price | | market_activity | no | recent minted/redeemed positions (flow) | | open_position | yes* | open an UP/DOWN binary (executes if a key is set, else returns the unsigned tx) | | redeem_winners | yes* | the gas-negative permissionless redeem crank |

* Action tools execute on-chain only when PREDICT_AGENT_KEY is set. Without it they stay read/build-only — the safe default is safe.

Why

DeepBook Predict is Sui's prediction-market primitive, and Sui is betting on agent-native finance. This is the layer that lets an LLM act on it: one npx, and your agent can quote a market and place a bet through the same composable engine that powers @yosuku/deepbook-predict. Testnet today; the IDs are swappable for mainnet.

License

MIT