# Trading Calendar & Public Holidays (x402)

> Trading Calendar & Public Holidays (x402) is a paid MCP server for finance and payments. Stock exchange trading days, hours and live status plus public holidays, pay per call. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API
- **Website:** https://handelskalender-api.pages.dev/llms.txt
- **Repository:** https://github.com/vstockma/handelskalender-api
- **MCP Registry name:** io.github.vstockma/handelskalender-api
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments), [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

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

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "handelskalender-api": {
      "url": "https://handelskalender-api.pages.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
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.

### Other clients (your client's MCP settings (most use this shape))

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

## 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.

## Alternatives

- [TradingCalendars](https://ai-powered.com/mcp/tradingcalendars): TradingCalendars is a freemium MCP server for finance and payments.
- [Business Day Calendars](https://ai-powered.com/mcp/business-day-calendars): Business Day Calendars is a freemium MCP server for finance and payments.
- [Public Holidays & Business Days (200+ countries)](https://ai-powered.com/mcp/public-holidays-and-business-days-200-countries): Public Holidays & Business Days (200+ countries) is a paid MCP server for productivity.
- [Date Math](https://ai-powered.com/mcp/date-math): Date Math is a freemium MCP server for developer tools.
- [Bankday](https://ai-powered.com/mcp/bankday): Bankday is a freemium MCP server for finance and payments.
- [Business-Day Oracle](https://ai-powered.com/mcp/business-day-oracle): Business-Day Oracle is a paid MCP server for finance and payments.
- [Crypto Derivatives Data API](https://ai-powered.com/mcp/crypto-derivatives-data-api): Crypto Derivatives Data API is a paid MCP server for finance and payments.
- [SA Business Calendar](https://ai-powered.com/mcp/sa-business-calendar): SA Business Calendar is a freemium MCP server for productivity.

---
Source: https://ai-powered.com/mcp/trading-calendar-and-public-holidays-x402
