{"_id":"@bundie/sol-mcp","_rev":"3-4102c8d498df2d70989def9904f85682","name":"@bundie/sol-mcp","dist-tags":{"latest":"0.2.2"},"versions":{"0.2.0":{"name":"@bundie/sol-mcp","version":"0.2.0","keywords":["mcp","model-context-protocol","bundie","solana","oracle","prediction-market","event-market","x402","ai-agent","claude","cursor"],"author":{"url":"https://solana.bundie.fi","name":"Bundie","email":"engineering@bundie.fi"},"license":"MIT","_id":"@bundie/sol-mcp@0.2.0","maintainers":[{"name":"bundie-eng","email":"info@bundie.fi"}],"homepage":"https://solana.bundie.fi","bugs":{"url":"https://github.com/bundie-fi/mcp/issues"},"bin":{"bundie-sol-mcp":"dist/index.js"},"dist":{"shasum":"417da7f303ebf60cc24320d3283b04a34fa42650","tarball":"https://registry.npmjs.org/@bundie/sol-mcp/-/sol-mcp-0.2.0.tgz","fileCount":20,"integrity":"sha512-Ee9+jPNTRDf+rjcCUtVMhL8vJJM/FuKC6/1ocrgrIDO8mW9/z41k9YajmYrVUif1vPOtQwy4auCS7jQ5s5JWcA==","signatures":[{"sig":"MEUCIQDJjoQeRW0SLvxkkRIJA3NUa5m7WswFtnOm6VjrSOhiRAIgf/UeqQqzv37fhBO6OIKlu+b5RzOzTdyuqW6YYS8uhYk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":39527},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"a68d4eb8b39a52b83adba5193130d29c5f28a378","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js","typecheck":"tsc --noEmit"},"_npmUser":{"name":"bundie-eng","email":"info@bundie.fi"},"repository":{"url":"git+https://github.com/bundie-fi/mcp.git","type":"git","directory":"solana"},"_npmVersion":"11.8.0","description":"Bundie Solana MCP server — the oracle agents read to price the future. Tools for browsing event markets, reading live consensus prices, verifying attestations, and reading resolver track records over x402. Supports both stdio and HTTP (StreamableHTTP) tra","directories":{},"_nodeVersion":"24.13.1","dependencies":{"zod":"^3.24.4","tweetnacl":"^1.0.3","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.4","typescript":"^5.8.3","@types/node":"^22.15.17"},"_npmOperationalInternal":{"tmp":"tmp/sol-mcp_0.2.0_1779669540906_0.5850958190316815","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@bundie/sol-mcp","version":"0.2.1","keywords":["mcp","model-context-protocol","bundie","solana","oracle","prediction-market","event-market","x402","ai-agent","claude","cursor"],"author":{"url":"https://solana.bundie.fi","name":"Bundie","email":"engineering@bundie.fi"},"license":"MIT","_id":"@bundie/sol-mcp@0.2.1","maintainers":[{"name":"bundie-eng","email":"info@bundie.fi"}],"homepage":"https://solana.bundie.fi","bugs":{"url":"https://github.com/bundie-fi/mcp/issues"},"bin":{"bundie-sol-mcp":"dist/index.js"},"dist":{"shasum":"10ff3150569b9dbaf522b8c15f62de3e9d91a9e9","tarball":"https://registry.npmjs.org/@bundie/sol-mcp/-/sol-mcp-0.2.1.tgz","fileCount":20,"integrity":"sha512-UYIHHCtTXvL8axE2EKgBsRIldR1wAUBND9WYuyZfAaMfxFho8rja5+cw9fttknhIjhi3irlFAvPmhREjDP9zng==","signatures":[{"sig":"MEUCIBM5yvVi0XZSWML3lx+raTJbfFKL+b3Ck9aSp3DWgU2jAiEA+ntLUW8ukQJrJ5KkNzd/ZDvEzwopTQLQfBkXYXzgUko=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":40354},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"bf0fc3025335220c2bbcce02876aaa3001e2de9b","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js","typecheck":"tsc --noEmit"},"_npmUser":{"name":"bundie-eng","email":"info@bundie.fi"},"repository":{"url":"git+https://github.com/bundie-fi/mcp.git","type":"git","directory":"solana"},"_npmVersion":"11.8.0","description":"Bundie Solana MCP server — the oracle agents read to price the future. Tools for browsing event markets, reading live consensus prices, verifying attestations, and reading resolver track records over x402. Supports both stdio and HTTP (StreamableHTTP) tra","directories":{},"_nodeVersion":"24.13.1","dependencies":{"zod":"^3.24.4","tweetnacl":"^1.0.3","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.4","typescript":"^5.8.3","@types/node":"^22.15.17"},"_npmOperationalInternal":{"tmp":"tmp/sol-mcp_0.2.1_1779669895714_0.96441077807937","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@bundie/sol-mcp","version":"0.2.2","description":"Bundie Solana MCP server — the oracle agents read to price the future. Tools for browsing event markets, reading live consensus prices, verifying attestations, and reading resolver track records over x402. Supports both stdio and HTTP (StreamableHTTP) tra","type":"module","main":"dist/index.js","bin":{"bundie-sol-mcp":"dist/index.js"},"scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js","typecheck":"tsc --noEmit"},"keywords":["mcp","model-context-protocol","bundie","solana","oracle","prediction-market","event-market","x402","ai-agent","claude","cursor"],"homepage":"https://solana.bundie.fi","repository":{"type":"git","url":"git+https://github.com/bundie-fi/mcp.git","directory":"solana"},"bugs":{"url":"https://github.com/bundie-fi/mcp/issues"},"author":{"name":"Bundie","email":"engineering@bundie.fi","url":"https://solana.bundie.fi"},"license":"MIT","publishConfig":{"access":"public"},"dependencies":{"@modelcontextprotocol/sdk":"^1.29.0","tweetnacl":"^1.0.3","zod":"^3.24.4"},"devDependencies":{"@types/node":"^22.15.17","tsx":"^4.19.4","typescript":"^5.8.3"},"engines":{"node":">=18.0.0"},"gitHead":"82014e6863aeb0aa8deb6516c838e337d05a9241","types":"./dist/index.d.ts","_id":"@bundie/sol-mcp@0.2.2","_nodeVersion":"24.13.1","_npmVersion":"11.8.0","dist":{"integrity":"sha512-1Vmn2wUthGzm7Xdypf1hIBjMRd7GJgSVDtYStbpEqBqsYZhwzQJhknhxN4JTSV0r00m7UaTXawnoFjIIIKjQsw==","shasum":"88967e10d9762480c91d03d24d63c23567770381","tarball":"https://registry.npmjs.org/@bundie/sol-mcp/-/sol-mcp-0.2.2.tgz","fileCount":20,"unpackedSize":39812,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIEtv8BDZxYYqyfnZoXiw0nL1AXUCvuWJYC65Dn/KDy3aAiEAmQBx2Ot4sc88C+8FikohnSd+h5/mhPVAJ+Nbq1kR+BI="}]},"_npmUser":{"name":"bundie-eng","email":"info@bundie.fi"},"directories":{},"maintainers":[{"name":"bundie-eng","email":"info@bundie.fi"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sol-mcp_0.2.2_1779670173531_0.6789322003372302"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-25T00:39:00.743Z","modified":"2026-05-25T00:49:33.790Z","0.2.0":"2026-05-25T00:39:01.037Z","0.2.1":"2026-05-25T00:44:55.854Z","0.2.2":"2026-05-25T00:49:33.664Z"},"bugs":{"url":"https://github.com/bundie-fi/mcp/issues"},"author":{"name":"Bundie","email":"engineering@bundie.fi","url":"https://solana.bundie.fi"},"license":"MIT","homepage":"https://solana.bundie.fi","keywords":["mcp","model-context-protocol","bundie","solana","oracle","prediction-market","event-market","x402","ai-agent","claude","cursor"],"repository":{"type":"git","url":"git+https://github.com/bundie-fi/mcp.git","directory":"solana"},"description":"Bundie Solana MCP server — the oracle agents read to price the future. Tools for browsing event markets, reading live consensus prices, verifying attestations, and reading resolver track records over x402. Supports both stdio and HTTP (StreamableHTTP) tra","maintainers":[{"name":"bundie-eng","email":"info@bundie.fi"}],"readme":"# @bundie/sol-mcp\n\n> **Bundie is an oracle that agents read to price the future.**\n> This MCP server is how an AI agent reads Bundie.\n\nExisting 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.\n\n`@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.\n\n## Tools\n\n| Tool | What it does |\n|---|---|\n| `list_events` | Enumerate every event market on Bundie with current YES price, depth, and status. Start here. |\n| `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. |\n| `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. |\n| `verify_attestation` | Locally verify that a `read_price` response was signed by Bundie. Public key is fetched + cached automatically. |\n| `resolver_track_record` | Read the resolver's `{ total, disputed, lost }` counts so the agent knows how much to trust the settlement path. |\n\n## Prompts\n\n| Prompt | Use when |\n|---|---|\n| `wire-bundie-circuit-breaker` | You're building an agent that holds protocol exposure and want Bundie's consensus to gate its de-risk decisions. |\n| `discover-bundie-markets` | You want to browse what Bundie can price for you, grouped by category and ranked by depth. |\n\n## Install\n\nNo API keys needed during devnet beta.\n\n### Option 1: claude.ai (easiest — no software required)\n\n1. Open [claude.ai](https://claude.ai) → **Settings** → **Integrations** → **Add custom integration**\n2. **Name:** `Bundie (Solana)` · **URL:** `https://mcp.solana.bundie.fi`\n3. Start a new conversation and ask: *\"What can Bundie price for me right now?\"*\n\n(URL goes live once the HTTP transport for this server ships. Until then, use stdio below.)\n\n### Option 2: Claude Desktop / Cursor / any stdio MCP client (Node 18+)\n\nAdd to your MCP client config:\n\n```json\n{\n  \"mcpServers\": {\n    \"bundie-sol\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@bundie/sol-mcp\"]\n    }\n  }\n}\n```\n\nThat's it. Start a new conversation: *\"Use Bundie to check if USDC is at risk of depegging this month.\"*\n\n### Option 3: From source\n\n```bash\ngit clone https://github.com/bundie-fi/mcp\ncd mcp/solana\nnpm install\nnpm run build\nnode dist/index.js\n```\n\n## Configuration\n\n| Env var | Default | When to set |\n|---|---|---|\n| `BACKEND_URL` | `https://backend.solana.bundie.fi` | Override to point at a local backend (`http://localhost:3001`) during development. |\n| `BACKEND_AUTH` | unset | Bearer token forwarded to the backend on every read. Leave unset during devnet beta. Required once x402-gated reads ship. |\n| `TRANSPORT` | `stdio` | `http` is planned (mirrors the EVM server's HTTP+OAuth path); not yet implemented. |\n\n## How an agent uses this\n\n```\nagent startup\n  ├─ list_events                         ← what can Bundie price for me?\n  └─ get_event_detail (for each candidate) ← what triggers a YES?\nagent steady state (every 30s)\n  ├─ read_price (for the markets I gated my decisions on)\n  └─ verify_attestation                  ← did this come from Bundie?\nagent decision\n  └─ de-risk / open position / circuit-break based on the YES probability\n```\n\nThe 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.\n\n## Companion artifacts\n\n- **Trader app:** [solana.bundie.fi](https://solana.bundie.fi) — same markets, same resolver, retail UX\n- **Write CLI:** [`@bundie/sol-cli`](https://www.npmjs.com/package/@bundie/sol-cli) — prepare-only commands for an agent that wants to *act* on Bundie (create markets, place bets, resolve)\n- **EVM yield MCP:** [`@bundie/evm-mcp`](https://www.npmjs.com/package/@bundie/evm-mcp) — different product (yield routing across EVM chains), shares the brand\n\n## License\n\nMIT. Built with `@modelcontextprotocol/sdk` and `tweetnacl`. Designed for [Claude Code](https://claude.com/product/claude-code), Claude Desktop, Cursor, Codex, and any MCP-compatible agent.\n","readmeFilename":"README.md"}