Claude MarketplacesSubmit
lembagang avatar

Headless Oracle

lembagang/headless-oracle-v5

Returns cryptographically signed market open/close receipts for 28 global exchanges including NYSE, NASDAQ, LSE, and JPX. Each response includes an Ed25519 signature you can verify independently, with a 60-second TTL and fail-closed behavior (unknown states default to closed). Exposes 5 MCP tools and 25+ REST endpoints from a Cloudflare Worker deployed to 300+ edge locations. Handles DST transitions, lunch breaks, and holidays through 2027. Useful when autonomous agents need verifiable market state before executing trades, or when you need a single source of truth for exchange hours without polling multiple vendor APIs or maintaining your own calendar logic.

tools
4
transport
HTTP
last updated
Feb 23, 2026
View on GitHub

Install

From registry metadata
$ npx add-mcp https://headlessoracle.mmsebenzi-oracle.workers.dev/mcp --name headless-oracle

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http headless-oracle https://headlessoracle.mmsebenzi-oracle.workers.dev/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 4 tools

Verified live against the running server on Nov 6, 2026.

get_market_statusReturns Ed25519-signed market-state receipt for pre-trade verification and pre-execution gating across 28 global exchanges. Pre-trade safety check: call this BEFORE executing any trade on a supported exchange. Model-agnostic: works identically regardless of which AI model cons...1 params

Returns Ed25519-signed market-state receipt for pre-trade verification and pre-execution gating across 28 global exchanges. Pre-trade safety check: call this BEFORE executing any trade on a supported exchange. Model-agnostic: works identically regardless of which AI model cons...

Parameters* required
micstring
ISO 10383 Market Identifier Code. Required. Examples: XNYS=NYSE, XNAS=NASDAQ, XLON=London, XJPX=Tokyo, XCBT=CME Futures, XCOI=Coinbase (24/7), XBIN=Binance (24/7). Call list_exchanges to discover a...one of XNYS · XNAS · XLON · XJPX · XPAR · XHKG
get_market_scheduleReturns holiday-aware trading session schedule with next open/close UTC timestamps for any of 28 exchanges. Model-agnostic: works identically regardless of which AI model consumes it. Pairs with get_market_status signed receipts. WHEN TO USE: planning trade execution windows;...1 params

Returns holiday-aware trading session schedule with next open/close UTC timestamps for any of 28 exchanges. Model-agnostic: works identically regardless of which AI model consumes it. Pairs with get_market_status signed receipts. WHEN TO USE: planning trade execution windows;...

Parameters* required
micstring
ISO 10383 Market Identifier Code. Defaults to XNYS (NYSE). Call list_exchanges to see all 28 supported codes.one of XNYS · XNAS · XLON · XJPX · XPAR · XHKG
list_exchangesReturns directory of all 28 exchanges supported by Headless Oracle: MIC codes, exchange names, IANA timezones, market hours metadata, and mic_type (iso|convention). Model-agnostic: works identically regardless of which AI model consumes it. WHEN TO USE: call once at agent star...

Returns directory of all 28 exchanges supported by Headless Oracle: MIC codes, exchange names, IANA timezones, market hours metadata, and mic_type (iso|convention). Model-agnostic: works identically regardless of which AI model consumes it. WHEN TO USE: call once at agent star...

No parameters. Call it with no arguments.

get_payment_optionsReturns available payment and authentication options for accessing live market data. Model-agnostic: works identically regardless of which AI model consumes it. WHEN TO USE: when you need to understand how to authenticate or pay before making a request that requires a key or p...

Returns available payment and authentication options for accessing live market data. Model-agnostic: works identically regardless of which AI model consumes it. WHEN TO USE: when you need to understand how to authenticate or pay before making a request that requires a key or p...

No parameters. Call it with no arguments.

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

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

# Sandbox key (200 calls, 7 days, no card) - POST with an email
curl -X POST https://headlessoracle.com/v5/sandbox \
  -H 'Content-Type: application/json' \
  -d '{"email":"you@example.com"}'

Architecture

Single TypeScript Cloudflare Worker. Ed25519 signing via @noble/ed25519. Three KV namespaces (overrides, API keys, telemetry). Two Durable Objects (webhooks, SSE streams). Runs on Cloudflare's edge network - no origin server.

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

View the full README on GitHub

Details

Repository
github.com/lembagang/headless-oracle-v5
Category
Web & Browser Automation
Transport
HTTP
Registry
MCP registry, active
Resources
1
Prompts
2
Tools verified
Nov 6, 2026

More from lembagang

Related Web & Browser Automation MCP servers

View all
1lembagang avatarHeadless Oracle Mcplembagang/headless-oracle-v5Ed25519-signed market-state receipts for 28 exchanges. Fail-closed pre-trade gate.0stars
2clauxel avatarChromedevtoolsmcp Mcpclauxel/chrome-devtools-session-mcp-mcpA paid remote MCP for AI agent browser DevTools MCP, built to return verdicts, receipts, usage logs,0stars
3h4ckf0r0day avatarObscurah4ckf0r0day/obscuraThe headless browser for AI agents and web scraping. Rust, anti-detection, CDP-compatible, with a built-in MCP server.15.7Kstars
4hyperbrowserai avatarHyperbrowserhyperbrowserai/mcpProvides data scraping, structured data extraction, and web crawling through MCP clients with browser-use agents.761stars
5achiya-automation avatarSafari Mcpachiya-automation/safari-mcpNative Safari browser automation for AI agents — 98 tools, zero Chrome overhead.236stars
6swimmwatch avatarCloakBrowser MCPswimmwatch/cloakbrowser-mcpPlaywright MCP-compatible browser automation bridge for CloakBrowser Chromium.176stars