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.

How to use Headless Oracle?

Install via npm with the command npx headless-oracle-mcp, then configure and invoke the available MCP tools according to your integration needs.

Key features of Headless Oracle

Ed25519-signed market-state receipts
Supports 28 global exchanges
5 MCP tools for market data and verification
Fail-closed: UNKNOWN state treated as CLOSED
60-second TTL for receipt freshness
x402 micropayments on Base

Use cases of Headless Oracle

—

FAQ from Headless Oracle

What does “fail-closed” mean?

When the market state is UNKNOWN, it is treated as CLOSED to ensure conservative decision-making.

How long is a receipt valid?

Each receipt has a time-to-live (TTL) of 60 seconds.

What payment mechanism is used?

Micropayments are handled via x402 on the Base network.

How many exchanges are covered?

The oracle covers 28 global exchanges.

What are the available MCP tools?

The five tools are: get_market_status, get_market_schedule, list_exchanges, verify_receipt, and get_payment_options.

Comments

More Databases MCP servers

mcp-server-qdrant: A Qdrant MCP server

qdrant

An official Qdrant Model Context Protocol (MCP) server implementation

637

mcp_mysql_server

wenb1n-dev

Model Context Protocol (MCP) server that supports secure interaction with MySQL databases and has anomaly analysis capabilities.更加牛逼！更加好用！不仅止于mysql的增删改查功能；还包含了数据库异常分析能力；且便于开发者们进行个性化的工具扩展

245