@bundie/sol-mcp

Bundie is an oracle that agents read to price the future. This MCP server is how an AI agent reads Bundie.

Existing oracles price the present — BTC right now, ETH right now, USDC right now. Bundie prices what's about to happen: stablecoin depegs, cloud-provider outages, protocol TVL drops, oracle deviations. Every measurable event has a market on Bundie, the YES price is the live consensus probability, and an agent can read it for ~$0.001 a call over x402.

@bundie/sol-mcp exposes those reads as MCP tools. Wire it once; your agent gains five tools that give it eyes on what's coming.

Tools

| Tool | What it does | |---|---| | list_events | Enumerate every event market on Bundie with current YES price, depth, and status. Start here. | | read_price | The hero read. Returns the YES consensus probability for an event, plus depth, 24h TWAP, recent move, resolver track record, and an ed25519 signed attestation. | | get_event_detail | Full metadata for a market — resolver class, outcome definitions, on-chain market address, resolver config. Use this when the agent needs to reason about HOW a market resolves. | | verify_attestation | Locally verify that a read_price response was signed by Bundie. Public key is fetched + cached automatically. | | resolver_track_record | Read the resolver's { total, disputed, lost } counts so the agent knows how much to trust the settlement path. |

Prompts

| Prompt | Use when | |---|---| | wire-bundie-circuit-breaker | You're building an agent that holds protocol exposure and want Bundie's consensus to gate its de-risk decisions. | | discover-bundie-markets | You want to browse what Bundie can price for you, grouped by category and ranked by depth. |

Install

No API keys needed during devnet beta.

Option 1: claude.ai (easiest — no software required)

1. Open claude.ai → Settings → Integrations → Add custom integration
2. Name: Bundie (Solana) · URL: https://mcp.solana.bundie.fi
3. Start a new conversation and ask: "What can Bundie price for me right now?"

(URL goes live once the HTTP transport for this server ships. Until then, use stdio below.)

Option 2: Claude Desktop / Cursor / any stdio MCP client (Node 18+)

Add to your MCP client config:

{
  "mcpServers": {
    "bundie-sol": {
      "command": "npx",
      "args": ["-y", "@bundie/sol-mcp"]
    }
  }
}

That's it. Start a new conversation: "Use Bundie to check if USDC is at risk of depegging this month."

Option 3: From source

git clone https://github.com/bundie-fi/mcp
cd mcp/solana
npm install
npm run build
node dist/index.js

Configuration

| Env var | Default | When to set | |---|---|---| | BACKEND_URL | https://backend.solana.bundie.fi | Override to point at a local backend (http://localhost:3001) during development. | | BACKEND_AUTH | unset | Bearer token forwarded to the backend on every read. Leave unset during devnet beta. Required once x402-gated reads ship. | | TRANSPORT | stdio | http is planned (mirrors the EVM server's HTTP+OAuth path); not yet implemented. |

How an agent uses this

agent startup
  ├─ list_events                         ← what can Bundie price for me?
  └─ get_event_detail (for each candidate) ← what triggers a YES?
agent steady state (every 30s)
  ├─ read_price (for the markets I gated my decisions on)
  └─ verify_attestation                  ← did this come from Bundie?
agent decision
  └─ de-risk / open position / circuit-break based on the YES probability

The agent pays roughly $0.001 × calls/month for the read. Polling 5 markets every 30 seconds for 30 days is ~$13. A single avoided liquidation pays back the year.

Companion artifacts

• Trader app: solana.bundie.fi — same markets, same resolver, retail UX
• Write CLI: @bundie/sol-cli — prepare-only commands for an agent that wants to act on Bundie (create markets, place bets, resolve)
• EVM yield MCP: @bundie/evm-mcp — different product (yield routing across EVM chains), shares the brand

License

MIT. Built with @modelcontextprotocol/sdk and tweetnacl. Designed for Claude Code, Claude Desktop, Cursor, Codex, and any MCP-compatible agent.