Headless Oracle
Headless Oracle
Certificaciones del estado del mercado firmadas con Ed25519 para 28 bolsas globales.
Qué hace
Los agentes de trading autónomos necesitan saber si una bolsa está abierta antes de ejecutar operaciones. Headless Oracle responde a esa pregunta con un recibo firmado criptográficamente que cualquier agente puede verificar de forma independiente; no se requiere confianza en el operador. Los estados UNKNOWN siempre se tratan como CLOSED (fail-closed).
Related MCP server: @getplexa/mcp
Inicio rápido
# MCP (Claude Desktop, Cursor, any MCP client)
npx headless-oracle-mcp
# REST API — demo receipt (no auth required)
curl https://headlessoracle.com/v5/demo?mic=XNYS
# Instant sandbox key (200 calls, 7 days, no signup)
curl https://headlessoracle.com/v5/sandboxArquitectura
Un único Cloudflare Worker en TypeScript (~14.000 líneas). Firma Ed25519 mediante @noble/ed25519. Tres espacios de nombres KV (anulaciones, claves API, telemetría). Dos Durable Objects (webhooks, flujos SSE). Desplegado en más de 300 ubicaciones de borde a nivel mundial.
Fail-closed de 4 niveles: comprobación de anulación KV -> motor de programación -> respaldo UNKNOWN -> fallo crítico sin firma.
Consulta docs/architecture/overview.md para ver la arquitectura completa.
API
5 herramientas MCP y más de 25 endpoints REST. Referencias completas:
Bolsas
23 mercados tradicionales (XNYS, XNAS, XLON, XJPX, XPAR, XHKG, XSES, XASX, XBOM, XNSE, XSHG, XSHE, XKRX, XJSE, XBSP, XSWX, XMIL, XIST, XSAU, XDFM, XNZE, XHEL, XSTO) más 5 extendidos (XCBT, XNYM, XCBO, XCOI, XBIN). El horario de verano (DST) se gestiona automáticamente mediante nombres de zona horaria IANA. Pausas para el almuerzo, medias jornadas y días festivos para 2026-2027.
Pruebas
npm test # 725+ unit/integration tests
npm run test:smoke # 11 live production smoke testsSeguridad
Firmas Ed25519 en cada respuesta. TTL de recibo de 60 segundos. Arquitectura fail-closed (UNKNOWN = CLOSED). Cabeceras de seguridad en todas las respuestas (HSTS, CSP, X-Content-Type-Options, X-Frame-Options).
Consulta SECURITY.md para conocer la política de divulgación responsable.
Documentación
Documentación completa organizada por audiencia:
Ingenieros: Arquitectura, Referencia de la API, ADRs
Operaciones: Despliegue, Monitorización, SLA
Legal: Términos de servicio, Política de privacidad, Propiedad intelectual
Negocio: Precios, Análisis competitivo
Consulta docs/README.md para ver el índice completo.
Licencia
MIT — consulta LICENSE
This server cannot be deployed
Maintenance
Related MCP Connectors
x402 MCP for agents: crypto prices, funding, DeFi yields, Polymarket, Base RPC + MCP security.
Pay-per-call DeFi and macro intel for AI agents. x402 USDC tools via streamable HTTP /api/mcp.
CrossingKey MCP for agent commerce, x402 payments, deterministic execution, and verifiable receipts.
Cross-asset market data and LLM inference for AI agents. Pay-per-call in USDC via x402.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server for pay-per-call DeFi and crypto data via x402 micropayments on Base. 8 endpoints: token prices, TVL, funding rates, token security, gas tracker, whale monitoring, wallet profiling, and yield scanning.823 npmMIT
- AlicenseAqualityBmaintenanceA Model Context Protocol server that gives any MCP client two economic-safety tools: realizable quote and pretrade check, paid per call in USDC with no accounts.2127 npmMIT
- AlicenseAqualityCmaintenancePay-per-call MCP server for market data with USDC micro-payments, featuring unique ML market-regime forecasts, news catalyst radar, and a live-verified algorithmic trading track record.1247 npmMIT
- FlicenseNot gradedqualityCmaintenanceCryptographically anchored, tamper-evident evidence receipts for AI agents — verified run receipts, existence-at-time proofs, and cited answers from an anchored public record. Remote MCP with proof-gated settlement; attests existence and integrity, never truth.-