bundie-fi Bundie Oracle Developer
Bundie is an oracle that agents read to price the future. 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; the YES price is the live consensus probability; an agent reads it for ~$0.001 a call over x402.
This skill teaches you how to wire that read into your own agent.
Intent Routing
| Developer Intent | Reference | Example |
|---|---|---|
| Find what Bundie can price | references/discover.md | "What event markets exist?", "Can Bundie price a USDC depeg?" |
| Read a live consensus price | references/read.md | "How do I read the YES probability?", "Wire read_price into my loop" |
| Build a de-risk trigger | references/circuit-breaker.md | "Pull liquidity when depeg risk > 5%", "Big Mario circuit breaker" |
| Verify a price is from Bundie | references/verify-attestation.md | "How do I trust the read?", "Check the signature" |
| Judge whether to act on a price | references/resolver-trust.md | "Is this resolver reliable?", "Should I bet on this market" |
Setup
Hosted (recommended — no API keys during devnet beta)
{
"mcpServers": {
"bundie-sol": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.bundie.fi/solana"]
}
}
}
Local stdio (Node 18+)
{
"mcpServers": {
"bundie-sol": {
"command": "npx",
"args": ["-y", "@bundie/sol-mcp"]
}
}
}
Self-hosted backend
BACKEND_URL=http://localhost:3001 \
BACKEND_AUTH=your-bearer-token \
npx @bundie/sol-mcp
How an agent uses Bundie
agent startup
├─ list_events ← what can Bundie price for me?
└─ get_event_detail (per candidate) ← what triggers a YES?
agent steady state (every ~30s)
├─ read_price (for the markets you gated on)
└─ verify_attestation ← did this come from Bundie?
agent decision
└─ de-risk / open position / circuit-break based on the YES probability
You pay roughly $0.001 × calls/month for the read. Polling 5 markets every 30s for 30 days is ~$13. A single avoided liquidation pays back the year.
Rules
- Always verify before acting on a price. The
read_priceresponse includes asigned_attestation. If you skipverify_attestationyou are trusting the transport, not Bundie. - Read the resolver track record before betting decisions on a market. A market with
{ total: 0 }settlements has no history. See references/resolver-trust.md. - Use
get_event_detailonce, cache it. Resolver config (Pyth feed, threshold, window) doesn't change between settlements — there's no point re-fetching it inside your hot loop. - Poll
read_price, notlist_events.list_eventsis for discovery at startup. The hot path isread_priceon the specific markets you care about. - Treat YES as a probability, not a verdict. A
priceof 0.04 means the market consensus is 4% — informative, not deterministic. Choose your action threshold. - Cache the attestation public key. It doesn't rotate within a deploy.
verify_attestationcaches it for you automatically; if you build your own verifier, do the same.