Casandra (repo: oraculo-radiohead)

Investment oracle MCP for AI agents — portfolio state, market context, and transparent risk. Not hallucinations.

Named after Cassandra, the prophetess. Built for Aleph Hackathon 2026 — Santa Cruz (EMI / Ethereum Bolivia).
Spec-driven: specs/constitution.md · TASKS.md

Problem / Solution

AI agents invent prices and “risk opinions.” Casandra exposes MCP tools that return live quotes, portfolio state, a documented risk score (0–100), and short market-context bullets — with timestamps. Same core powers the web demo for judges.

Related MCP server: Enterprise Crypto MCP Gateway

Team

Aleph 2026

MCP tools

Risk algorithm v1 (casandra-risk-v1)

score = 0.45 * abs_change_component
      + 0.35 * relative_vol_vs_btc
      + 0.20 * (100 - usdt_share_pct)

• Bands: 0–33 low · 34–66 med · 67–100 high

• More USDT in the portfolio → lower risk contribution

• Full factor breakdown returned in JSON

Quick start

npm install
npm run build
npm run start:mcp    # MCP stdio
npm run dev:web      # http://localhost:5173

Cursor MCP config

{
  "mcpServers": {
    "casandra": {
      "command": "node",
      "args": ["D:/_Dev/Projects/Oraculo-radiohead/packages/mcp-server/dist/index.js"]
    }
  }
}

Ask: “What’s my portfolio risk? Use Casandra tools.”

Live demo: deploy with npx vercel --prod (needs vercel login) — paste URL here.
Repo: https://github.com/Kenyi001/oraculo-radiohead

Monorepo

packages/market-core   # prices, portfolio, risk, context
packages/mcp-server    # Casandra MCP
packages/demo-web      # judges UI
contracts/             # CasandraRegistry (Base Sepolia)
specs/                 # Speckit
TASKS.md               # human task board
docs/REQUIREMENTS.md   # Hacki + product checklist

On-chain (CasandraRegistry)

Minimal risk-snapshot registry for Aleph (Hacki requires address if deployed).

npm run contracts:compile
# fund wallet in contracts/deployments/baseSepolia.json → deployWallet
npm run contracts:deploy:base

See contracts/README.md. After deploy, set VITE_CASANDRA_REGISTRY_* in packages/demo-web/.env and paste address below.

Contract address (Base Sepolia): pending faucet → npm run contracts:deploy:base
Explorer: TBD

Disclaimer

Not financial advice. Casandra does not execute trades or predict returns.

License

MIT