Skip to content
MCP server

Trading Calendar & Public Holidays (x402)

Stock exchange trading days, hours and live status plus public holidays, pay per call

Install
Pricing
Paid
Platforms
API
Runs
Remotely
Version
1.0.0
Listing updated
5 days ago

Similar MCP servers

About Trading Calendar & Public Holidays (x402)

Trading Calendar & Public Holidays (x402) is a paid MCP server for finance and payments. It runs as a hosted remote server, so there is nothing to install locally.

Meant for agents that schedule orders, reports or alerts, this data service answers whether an exchange trades on a given day. The trading-day endpoint covers 28 exchanges including NYSE, Nasdaq, LSE, Xetra, Euronext, SIX, Tokyo, HKEX, Shanghai and ASX. It returns the holiday name, local and UTC hours, half days, lunch breaks, pre- and after-market sessions for some exchanges, live status, next open or close and the previous or next trading day.

A companion set covers public holidays and business days for 247 countries. Exchanges are selected by MIC code, such as XNYS or XNAS, and common names also work. Every answer names its official source.

There is no account, key or subscription. Payment is per request with x402 in USDC on Base: the trading-day call costs 0.002 USDC. Unpaid requests get HTTP 402 with payment requirements; bad input is rejected with 400 before payment, and 404 and outage errors are never charged. Only part of the endpoint list was available.

Install

Run in a terminal

claude mcp add --transport http handelskalender-api https://handelskalender-api.pages.dev/mcp

Add to Settings → Connectors → Add custom connector

https://handelskalender-api.pages.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "handelskalender-api": {
      "url": "https://handelskalender-api.pages.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "handelskalender-api": {
      "type": "http",
      "url": "https://handelskalender-api.pages.dev/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "handelskalender-api": {
      "serverUrl": "https://handelskalender-api.pages.dev/mcp"
    }
  }
}

Add to Grok Bot desktop app → Connect apps → Add a custom connector

https://handelskalender-api.pages.dev/mcp

Enter a Name (for example "Trading Calendar & Public Holidays (x402)"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

Full Grok Bot setup guide

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "handelskalender-api": {
      "type": "http",
      "url": "https://handelskalender-api.pages.dev/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

What it does

28 exchanges
Trading days, hours and half days for major exchanges.
Live market status
Open or closed now, with next open and close.
247 countries of holidays
Public holidays and business-day logic.
Official sources
Each answer names its source.
No account
Pay per request with x402.

Good for

  • Check whether NYSE is open before scheduling orders
  • Find the next trading day for a report
  • Skip alerts on public holidays
  • Find pre-market hours for Xetra

Pricing

Paid

Pay per call; trading-day lookup 0.002 USDC via x402

Prices change. Check handelskalender-api.pages.dev before you buy.

Trading Calendar & Public Holidays (x402) FAQ

How is it paid for?

Per request with x402 using USDC on Base; no account or key.

What does a trading-day call cost?

0.002 USDC.

Are errors charged?

No. Bad input returns 400 before payment, and 404 and outages are not charged.

How are exchanges identified?

By MIC code, and common names also work.

Is Trading Calendar & Public Holidays (x402) free?

No. Trading Calendar & Public Holidays (x402) is a paid product.

How do I add Trading Calendar & Public Holidays (x402) to Claude Code?

Run this command in your terminal: claude mcp add --transport http handelskalender-api https://handelskalender-api.pages.dev/mcp

What are the best alternatives to Trading Calendar & Public Holidays (x402)?

The closest alternatives to Trading Calendar & Public Holidays (x402) are TradingCalendars, Business Day Calendars, Public Holidays & Business Days (200+ countries), Date Math and Bankday.

Where this comes from

  • Description: written from the project's README and the project's website.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers