Casandra (repo: oraculo-radiohead)

Oráculo de inversión MCP para agentes de IA: estado de cartera, contexto de mercado y riesgo transparente. Sin alucinaciones.

Llamada así por Casandra, la profetisa. Construido para Aleph Hackathon 2026 — Santa Cruz (EMI / Ethereum Bolivia).
Impulsado por especificaciones: specs/constitution.md · TASKS.md

Problema / Solución

Los agentes de IA inventan precios y "opiniones de riesgo". Casandra expone herramientas MCP que devuelven cotizaciones en vivo, estado de la cartera, una puntuación de riesgo (0-100) documentada y viñetas breves de contexto de mercado, con marcas de tiempo. El mismo núcleo impulsa la demo web para los jueces.

Related MCP server: Enterprise Crypto MCP Gateway

Equipo

Aleph 2026

Herramientas MCP

Algoritmo de riesgo v1 (casandra-risk-v1)

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

• Bandas: 0-33 baja · 34-66 media · 67-100 alta

• Cuanto más USDT haya en la cartera → menor contribución al riesgo

• Desglose completo de factores devuelto en JSON

Inicio rápido

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

Configuración de MCP en Cursor

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

Pregunta: "¿Cuál es el riesgo de mi cartera? Usa las herramientas de Casandra."

Demo en vivo: despliega con npx vercel --prod (requiere vercel login) — pega aquí la URL.
Repositorio: 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

En cadena (CasandraRegistry)

Registro mínimo de instantáneas de riesgo para Aleph (Hacki requiere dirección si se despliega).

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

Consulta contracts/README.md. Tras el despliegue, configura VITE_CASANDRA_REGISTRY_* en packages/demo-web/.env y pega la dirección abajo.

Dirección del contrato (Base Sepolia): faucet pendiente → npm run contracts:deploy:base
Explorador: TBD

Aviso legal

No es asesoramiento financiero. Casandra no ejecuta operaciones ni predice rendimientos.

Licencia

MIT