Skip to main content
Glama
Sign In
deenesjakoruzh
Headless Oracle

Headless Oracle

by LembaGang
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

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: orchard-data-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/sandbox

Arquitectura

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 tests

Seguridad

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:

Consulta docs/README.md para ver el índice completo.

Licencia

MIT — consulta LICENSE

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityActive
ResponsivenessLimited data

Resources

Related MCP Connectors

Related MCP Servers

  • x402-api

    fernsugi
    A
    license
    A
    quality
    C
    maintenance
    Eight crypto and DeFi data tools for AI agents: prices, gas, one ParaSwap route quote, GoPlus token security and top-holder samples, DefiLlama yields, Hyperliquid/dYdX funding, and observed wallet balances. Inspect prices free; pay 0.001–0.008 USDC per call on Base through x402. No API key or subscription.
    8
    120 npm
    MIT

  • orchard-data-mcp

    letom1176-spec
    A
    license
    A
    quality
    C
    maintenance
    Pay-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.
    12
    128 npm
    MIT

  • AlphaPipeline

    parkyucheol-del
    A
    license
    A
    quality
    A
    maintenance
    Pay-per-call ($0.005-$0.03 USDC) market, on-chain, and prediction-market data API for AI agents and trading bots via x402 — no signup, no API key. Remote MCP server, 28 tools: token security (honeypot/liquidity/counterfeit checks), Hyperliquid oracle-gap risk, kimchi premium, funding APR, DEX slippage, Polymarket arbitrage/liquidity audits, Hyperliquid HIP-4 odds.
    2
    28
    1
    MIT