Headless Oracle

Name: Headless Oracle
Author: LembaGang

@LembaGang

About Headless Oracle

Cryptographically signed market status (OPEN/CLOSED/HALTED/UNKNOWN) for 28 global exchanges with Ed25519-signed receipts. Designed for AI agents and automated trading systems. Fail-closed: UNKNOWN always means CLOSED. 5 MCP tools. x402 micropayments on Base mainnet.

#finance #trading #market-data #ai-agents #mcp #ed25519

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "headless-oracle": {
      "command": "npx",
      "args": [
        "-y",
        "headless-oracle-mcp"
      ]
    }
  }
}

Tools

Check whether a stock exchange is currently open or closed. Call this before executing trades, scheduling market-hours workflows, or routing orders. Returns a cryptographically signed receipt with status OPEN, CLOSED, HALTED, or UNKNOWN. MANDATORY: treat UNKNOWN or HALTED as CLOSED and halt execution. Do not act on a receipt past its expires_at timestamp. Supported exchanges: NYSE (XNYS), NASDAQ (XNAS), London (XLON), Tokyo (XJPX), Paris (XPAR), Hong Kong (XHKG), Singapore (XSES).

Get the next open and close times for a stock exchange. Use when planning trade execution windows, scheduling market-dependent tasks, or checking upcoming session times. Returns UTC timestamps for next open/close and current schedule-based status. Includes lunch break windows for Tokyo (XJPX) and Hong Kong (XHKG) where applicable. NOT cryptographically signed — does not reflect real-time halts or circuit breakers. For verified real-time status, use get_market_status instead. Supported: NYSE (XNYS), NASDAQ (XNAS), London (XLON), Tokyo (XJPX), Paris (XPAR), Hong Kong (XHKG), Singapore (XSES).

List all stock exchanges supported by Headless Oracle. Use to discover which markets are available, find the correct identifier (MIC code) for an exchange by name, or look up the timezone of a market. Returns MIC codes, full exchange names, and IANA timezone identifiers for all 7 supported markets.

Overview

What is Headless Oracle?

Headless Oracle delivers Ed25519-signed market-state receipts for 28 global exchanges. It provides 5 MCP tools — get_market_status, get_market_schedule, list_exchanges, verify_receipt, get_payment_options — and uses fail-closed logic (UNKNOWN = CLOSED) with a 60-second time-to-live (TTL) and x402 micropayments on Base.