1. Conduid
  2. Blockchain
  3. io.github.LembaGang/headless-oracle
MCP server · Blockchain

io.github.LembaGang/headless-oracle

by · github.com/LembaGang/headless-oracle-v5

Cryptographically signed market state verification for autonomous financial agents.

Unclaimed blockchain
InstallView source
34Low

Scored 7 months ago · breakdown

About io.github.LembaGang/headless-oracle

io.github.LembaGang/headless-oracle is an MCP server published by LembaGang in the Blockchain category: cryptographically signed market state verification for autonomous financial agents.

Recent commit activity is the strongest signal that reported issues will get attention.

Install

From source
git clone https://github.com/LembaGang/headless-oracle-v5

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about io.github.LembaGang/headless-oracle

Powered by Claude · Grounded in docs

I know everything about io.github.LembaGang/headless-oracle. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

Headless Oracle

Ed25519-signed market-state attestations for 28 global exchanges.

What It Does

Autonomous trading agents need to know if an exchange is open before executing trades. Headless Oracle answers that question with a cryptographically signed receipt that any agent can verify independently — no trust in the operator required. UNKNOWN states are always treated as CLOSED (fail-closed).

Quick Start

# 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

Architecture

Single TypeScript Cloudflare Worker (~14,000 lines). Ed25519 signing via @noble/ed25519. Three KV namespaces (overrides, API keys, telemetry). Two Durable Objects (webhooks, SSE streams). Deployed to 300+ edge locations globally.

4-tier fail-closed: KV override check -> schedule engine -> UNKNOWN fallback -> unsigned critical failure.

See docs/architecture/overview.md for the full architecture.

API

5 MCP tools and 25+ REST endpoints. Full references:

Exchanges

23 traditional markets (XNYS, XNAS, XLON, XJPX, XPAR, XHKG, XSES, XASX, XBOM, XNSE, XSHG, XSHE, XKRX, XJSE, XBSP, XSWX, XMIL, XIST, XSAU, XDFM, XNZE, XHEL, XSTO) plus 5 extended (XCBT, XNYM, XCBO, XCOI, XBIN). DST handled automatically via IANA timezone names. Lunch breaks, half-days, and holidays for 2026-2027.

Testing

npm test              # 725+ unit/integration tests
npm run test:smoke    # 11 live production smoke tests

Security

Ed25519 signatures on every response. 60-second receipt TTL. Fail-closed architecture (UNKNOWN = CLOSED). Security headers on all responses (HSTS, CSP, X-Content-Type-Options, X-Frame-Options).

See SECURITY.md for the responsible disclosure policy.

Documentation

Full documentation organized by audience:

See docs/README.md for the full index.

License

MIT — see LICENSE

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About io.github.LembaGang/headless-oracle

How do I install io.github.LembaGang/headless-oracle?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is io.github.LembaGang/headless-oracle safe to use with an AI agent?

Its trust score is 34 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is io.github.LembaGang/headless-oracle still maintained?

Yes — the last commit was 6 days ago. The repository has 0 stars and 1 forks.