# Trading Calendar & Public Holidays (x402) (remote · handelskalender-api.pages.dev)

Stock exchange trading days, hours, live market status (28 exchanges) and holidays (247 countries).

- Trust score: 75/100 (medium)
- Change this week: +4
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-21

## Components

- remote · `handelskalender-api.pages.dev`: 75/100 (this document), [markdown](https://verifymcp.io/servers/vstockma-handelskalender-api/handelskalender-api.md), [page](https://verifymcp.io/servers/vstockma-handelskalender-api/handelskalender-api)

## Channel facts

- Endpoint: `https://handelskalender-api.pages.dev/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-21.

- **Endpoint Security**: 74/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - No authorisation is required to call this server. Nothing on it is marked destructive, but we can't show that an anonymous caller can only read: full credit needs the server to list at least one tool and every tool to be verifiably read-only. We use a best-effort check of tool names and descriptions to tell read-only tools from tools that change things, so some genuinely read-only tools may not get full credit. Names that start with a read verb (get, list, read, search and similar) and accurate readOnlyHint annotations help. Meet that to earn full credit, or require authorisation.
  - HTTPS is enforced; there's no plaintext access path.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 66/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1176 tokens (~235/item across 5 items; 5 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 37/100
  - Stability observed for 11 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 5 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 6 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### How do I install the Trading Calendar & Public Holidays (x402) MCP server?

Trading Calendar & Public Holidays (x402) is a hosted endpoint at https://handelskalender-api.pages.dev/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http vstockma-handelskalender-api 'https://handelskalender-api.pages.dev/mcp'
```

### Cursor

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

### VS Code

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

### Codex

```toml
[mcp_servers.vstockma-handelskalender-api]
url = "https://handelskalender-api.pages.dev/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "vstockma-handelskalender-api": {
      "type": "remote",
      "url": "https://handelskalender-api.pages.dev/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add vstockma-handelskalender-api --url 'https://handelskalender-api.pages.dev/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  vstockma-handelskalender-api:
    url: "https://handelskalender-api.pages.dev/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "vstockma-handelskalender-api": {
      "Transport": "http",
      "Url": "https://handelskalender-api.pages.dev/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add vstockma-handelskalender-api -t streamable-http -u 'https://handelskalender-api.pages.dev/mcp'
```

### Other

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

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-21 (score 75, +1)

No change was recorded against any check on this day. Stability & Change Management went from 33 to 37. That category is still filling its 30-day observation window: 10 days of observed history at the previous scan, 11 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-19 (score 74, +1)

No change was recorded against any check on this day. Stability & Change Management went from 27 to 30. That category is still filling its 30-day observation window: 8 days of observed history at the previous scan, 9 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-17 (score 73, +1)

No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-15 (score 72, +1)

No change was recorded against any check on this day. Stability & Change Management went from 13 to 17. That category is still filling its 30-day observation window: 4 days of observed history at the previous scan, 5 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-13 (score 71, +1)

No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-11 (score 70, +1)

- [functional improvement] Stability: unverified → 0.03

### 2026-11-10 (score 69)

First indexed and scored.

## MCP tools (5)

### `trading_day` (~241 tokens)

Exchange Trading Calendar

Use when an agent needs to know if a stock exchange trades on a given day (default today) before scheduling orders, reports or alerts. 28 exchanges incl. NYSE, Nasdaq, LSE, Xetra, Euronext, SIX, Tokyo, HKEX, Shanghai, ASX. Returns holiday name, hours in local time + UTC, half days, lunch breaks, pre/after-market (Nasdaq, Xetra), live status, next open/close, previous/next trading day. Official exchange calendars only; bad input: HTTP 400, no charge. Price: 0.002 USDC per successful call (x402).

Input parameters:

- `date` (string): Day as YYYY-MM-DD. Optional, default: today in the exchange's time zone.
- `exchange` (string, required): Exchange MIC code, e.g. XNYS (NYSE), XNAS (Nasdaq), XLON (London), XETR (Xetra), XPAR (Paris), XTKS (Tokyo), XHKG (Hong Kong). Common names also work (NYSE, Xetra, LSE). Free list: GET /v1/exchanges.

### `trading_calendar` (~208 tokens)

Exchange Trading Calendar

Use when an agent plans ahead and needs every closure of a stock exchange for a whole year: holiday names, half days, late openings, regular hours, count of trading days. 28 exchanges incl. NYSE, Nasdaq, LSE, Xetra, Euronext, SIX, Tokyo, HKEX, Shanghai, ASX. Official exchange calendars only; bad input or uncovered year: HTTP 400, no charge. Price: 0.002 USDC per successful call (x402).

Input parameters:

- `exchange` (string, required): Exchange MIC code, e.g. XNYS (NYSE), XNAS (Nasdaq), XLON (London), XETR (Xetra), XPAR (Paris), XTKS (Tokyo), XHKG (Hong Kong). Common names also work (NYSE, Xetra, LSE). Free list: GET /v1/exchanges.
- `year` (string): Year, e.g. 2026. Optional, default: current year.

### `market_status` (~154 tokens)

Exchange Trading Calendar

Use when an agent needs to know right now which stock exchanges are open: open, lunch break, pre-market, after-hours or closed (with holiday name), local time, exact next open and close in UTC. One call checks up to 28 exchanges (default all) incl. NYSE, Nasdaq, LSE, Xetra, Euronext, Tokyo, HKEX, Shanghai, ASX. Official exchange calendars only; unknown exchange: HTTP 400, no charge. Price: 0.002 USDC per successful call (x402).

Input parameters:

- `exchanges` (string): Comma-separated MIC codes or names, e.g. XNYS,XETR,XTKS. Optional, default: all exchanges.

### `public_holidays` (~232 tokens)

Public Holidays & Business Days

Use when an agent needs all public holidays of a country for a year (planning deliveries, payments, deadlines, staffing). 247 countries, 2026-2028, optional state/province (region=) for regional holidays. English and local names, weekend days of the country, moon-dependent dates flagged as estimated. Bad input: HTTP 400 before payment, no charge. Price: 0.002 USDC per successful call (x402).

Input parameters:

- `country` (string, required): 2-letter ISO country code, e.g. AT, DE, US, GB, FR, JP, IN, BR, AE. 247 countries; free list: GET /v1/holiday-countries.
- `region` (string): Optional state/province for regional holidays, e.g. BY or DE-BY (Bavaria), CA (California), 9 (Vienna). Listed per country in GET /v1/holiday-countries.
- `year` (string): Year, e.g. 2027. Optional, default: current year. Covered: 2026-2028.

### `business_day` (~289 tokens)

Public Holidays & Business Days

Use when an agent must know if a date is a business day in a country, or compute a due date: weekend or holiday (with name), previous/next business day, date plus N business days (add=), business days until a date (to=). 247 countries, 2026-2028, optional state/province (region=), local weekends (e.g. Fri-Sat). Bad input: HTTP 400, no charge. Price: 0.002 USDC per successful call (x402).

Input parameters:

- `add` (string): Optional: number of business days to add (negative = go back), -260 to 260.
- `country` (string, required): 2-letter ISO country code, e.g. AT, DE, US, GB, FR, JP, IN, BR, AE. 247 countries; free list: GET /v1/holiday-countries.
- `date` (string): Day as YYYY-MM-DD. Optional, default: today (UTC).
- `region` (string): Optional state/province for regional holidays, e.g. BY or DE-BY (Bavaria), CA (California), 9 (Vienna). Listed per country in GET /v1/holiday-countries.
- `to` (string): Optional end date YYYY-MM-DD (>= date): count business days from date to it, both included.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/vstockma-handelskalender-api/handelskalender-api#diagnostics

## Score history

- 2026-11-21: 75
- 2026-11-20: 74
- 2026-11-19: 74
- 2026-11-18: 73
- 2026-11-17: 73
- 2026-11-16: 72
- 2026-11-15: 72
- 2026-11-14: 71
- 2026-11-13: 71
- 2026-11-12: 70
- 2026-11-11: 70
- 2026-11-10: 69

## Common questions

### What is the Trading Calendar & Public Holidays (x402) MCP server?

Trading Calendar & Public Holidays (x402) is an MCP server listed in the public MCP registry as io.github.vstockma/handelskalender-api. Stock exchange trading days, hours, live market status (28 exchanges) and holidays (247 countries). This page covers its hosted endpoint (https://handelskalender-api.pages.dev/mcp).

### Is the Trading Calendar & Public Holidays (x402) MCP server safe to use?

Trading Calendar & Public Holidays (x402) scores 75 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Trading Calendar & Public Holidays (x402) MCP server expose?

Trading Calendar & Public Holidays (x402) exposes 5 tools: trading_day, trading_calendar, market_status, public_holidays, business_day. Their descriptions and schemas cost roughly 1,124 tokens of context every time the server is loaded.

### Does the Trading Calendar & Public Holidays (x402) MCP server require authentication?

No. We connected to Trading Calendar & Public Holidays (x402) without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

### Is the Trading Calendar & Public Holidays (x402) MCP server still maintained?

Trading Calendar & Public Holidays (x402) is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What did VerifyMCP test on the Trading Calendar & Public Holidays (x402) MCP server?

VerifyMCP ran 13 checks on Trading Calendar & Public Holidays (x402), covering TLS certificate, Authorization, HTTPS, HSTS header and 9 more. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- Remote endpoint: https://handelskalender-api.pages.dev/mcp
- Repository: https://github.com/vstockma/handelskalender-api
- Website: https://handelskalender-api.pages.dev/llms.txt
- Changelog RSS feed: https://verifymcp.io/servers/vstockma-handelskalender-api/handelskalender-api.xml
- Changelog JSON feed: https://verifymcp.io/servers/vstockma-handelskalender-api/handelskalender-api/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/vstockma-handelskalender-api/handelskalender-api.json
- HTML version of this page: https://verifymcp.io/servers/vstockma-handelskalender-api/handelskalender-api
