# TradingCalendars (remote · api.tradingcalendars.com)

Business days, T+N settlement dates and holidays for FX, banks, payments and exchanges.

- Trust score: 68/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-05

## Components

- remote · `api.tradingcalendars.com`: 68/100 (this document), [markdown](https://verifymcp.io/servers/com-tradingcalendars-holidays/api.md), [page](https://verifymcp.io/servers/com-tradingcalendars-holidays/api)

## Channel facts

- Endpoint: `https://api.tradingcalendars.com/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.1.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-05.

- **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. Every tool declares its destructiveHint and none is destructive, so open access doesn't expose one.
  - 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**: 67/100
  - AI-judged instruction clarity (good).
  - Tool/resource definitions use about 1360 tokens (~80/item across 17 items; 17 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 7/100
  - Stability observed for 2 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 67/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 0% 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 17 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 18 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

### How do I install the TradingCalendars MCP server?

TradingCalendars is a hosted endpoint at https://api.tradingcalendars.com/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 com-tradingcalendars-holidays 'https://api.tradingcalendars.com/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "com-tradingcalendars-holidays": {
      "url": "https://api.tradingcalendars.com/mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "com-tradingcalendars-holidays": {
      "type": "http",
      "url": "https://api.tradingcalendars.com/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.com-tradingcalendars-holidays]
url = "https://api.tradingcalendars.com/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "com-tradingcalendars-holidays": {
      "type": "remote",
      "url": "https://api.tradingcalendars.com/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add com-tradingcalendars-holidays --url 'https://api.tradingcalendars.com/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  com-tradingcalendars-holidays:
    url: "https://api.tradingcalendars.com/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "com-tradingcalendars-holidays": {
      "Transport": "http",
      "Url": "https://api.tradingcalendars.com/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add com-tradingcalendars-holidays -t streamable-http -u 'https://api.tradingcalendars.com/mcp'
```

### Other

```json
{
  "mcpServers": {
    "com-tradingcalendars-holidays": {
      "type": "http",
      "url": "https://api.tradingcalendars.com/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-05 (score 68, +7)

- [security improvement] Authorization: unverified → partial
- [security] The server rewrote its instructions, which are the text every model session reads
- [cosmetic] Tool “add_business_days” changed its title: Add business days (T+N date)
- [cosmetic] Tool “bank_holidays” changed its title: Bank holidays
- [cosmetic] Tool “business_days_between” changed its title: Business days between two dates
- [cosmetic] Tool “currency_non_clearing_days” changed its title: Currency settlement (non-clearing) days
- [cosmetic] Tool “fx_market_holidays” changed its title: FX market holidays
- [cosmetic] Tool “get_holidays” changed its title: Holidays for a calendar
- [cosmetic] Tool “get_weekends” changed its title: Weekend definitions
- [cosmetic] Tool “is_business_day” changed its title: Is it a business day?
- [cosmetic] Tool “list_calendars” changed its title: List calendars
- [cosmetic] Tool “list_currencies” changed its title: List currencies
- [cosmetic] Tool “list_exchanges” changed its title: List exchanges
- [cosmetic] Tool “list_financial_centres” changed its title: List financial centres
- [cosmetic] Tool “list_payment_systems” changed its title: List payment systems
- [cosmetic] Tool “market_status” changed its title: Market open/closed status
- [cosmetic] Tool “payment_system_holidays” changed its title: Payment system holidays
- [cosmetic] Tool “settlement_holidays” changed its title: Exchange settlement holidays
- [cosmetic] Tool “trading_holidays” changed its title: Exchange trading holidays

### 2026-11-04 (score 61, +1)

- [functional improvement] Stability: unverified → 0.03

### 2026-11-03 (score 60)

First indexed and scored.

## MCP tools (17)

### `list_calendars` (~63 tokens)

List calendars

List published holiday calendars available to your plan. Optional calendar_type filters by family (CURRENCY_FX, CURRENCY_NON_CLEARING, FINANCIAL_CENTRE, PAYMENT_SYSTEM, EXCHANGE_TRADING, EXCHANGE_SETTLEMENT).

Input parameters:

- `calendar_type`

### `get_holidays` (~81 tokens)

Holidays for a calendar

Holidays for one calendar by code (e.g. USD.FX). start defaults to today; pass an earlier start for historical holidays, end to bound forward dates. Rows carry original_date when a holiday is observed on a shifted date, plus half-day and early-close details.

Input parameters:

- `calendar` (string, required)
- `end`
- `start`

### `fx_market_holidays` (~60 tokens)

FX market holidays

FX market holidays for a currency (ISO 4217, e.g. USD): days the FX market for that currency does not trade. start defaults to today.

Input parameters:

- `currency` (string, required)
- `end`
- `start`

### `currency_non_clearing_days` (~65 tokens)

Currency settlement (non-clearing) days

Currency non-clearing days (ISO 4217, e.g. USD): days the currency cannot clear or settle. Use to validate FX value dates. start defaults to today.

Input parameters:

- `currency` (string, required)
- `end`
- `start`

### `bank_holidays` (~60 tokens)

Bank holidays

Bank holidays for a financial centre (UN/LOCODE, e.g. USNYC): days retail and commercial banks are closed. start defaults to today.

Input parameters:

- `end`
- `financial_centre` (string, required)
- `start`

### `payment_system_holidays` (~55 tokens)

Payment system holidays

Payment system holidays (e.g. TARGET2, FEDWIRE): days the system does not process or settle. start defaults to today.

Input parameters:

- `end`
- `payment_system` (string, required)
- `start`

### `trading_holidays` (~71 tokens)

Exchange trading holidays

Exchange trading holidays for a market (ISO 10383 MIC, e.g. XNYS): days the exchange is closed for trading, including shortened sessions (half_day and early_close_time fields). start defaults to today.

Input parameters:

- `end`
- `market` (string, required)
- `start`

### `settlement_holidays` (~59 tokens)

Exchange settlement holidays

Exchange settlement holidays for a market (ISO 10383 MIC, e.g. XNYS): days clearing and settlement cannot take place. start defaults to today.

Input parameters:

- `end`
- `market` (string, required)
- `start`

### `list_currencies` (~24 tokens)

List currencies

List covered currencies (ISO 4217) with issuing country and issuer.

### `list_exchanges` (~27 tokens)

List exchanges

List covered exchanges (ISO 10383 MIC) with country, city, and timezone.

### `list_financial_centres` (~26 tokens)

List financial centres

List covered financial centres (UN/LOCODE) with country and timezone.

### `list_payment_systems` (~24 tokens)

List payment systems

List covered payment systems with operator, type, currency, and country.

### `get_weekends` (~54 tokens)

Weekend definitions

Weekend definitions and working weekends for one calendar code (e.g. USD.FX). weekend_days is the definition in force today (ISO weekday numbers); weekend_definitions carries the full history.

Input parameters:

- `calendar` (string, required)

### `market_status` (~85 tokens)

Market open/closed status

Live open/half/closed status for exchanges, evaluated against real trading hours and today's trading holidays in each exchange's timezone. Includes next_open_at and next_close_at timestamps. Pass a MIC (e.g. XNYS) for one market or omit it for all. Requires a plan with exchange trading data (Free, Exchange, or All-in-one).

Input parameters:

- `market`

### `is_business_day` (~147 tokens)

Is it a business day?

Is a date a business day? Answers for one or several calendars at once and says why not (holiday name, weekend) or flags a half day / early close. calendars: one or more calendar codes from list_calendars, e.g. ["USD.FX", "EUR.FX"] for a EUR/USD FX trade, ["XNYS.SETTLE"] for NYSE settlement, ["TARGET2.PAY"] for euro payments, ["GBLON.BANK"] for London banks. A date counts as a business day only when it is open in every calendar given. date defaults to today (yyyy-mm-dd).

Input parameters:

- `calendars` (array, required)
- `date`

### `add_business_days` (~185 tokens)

Add business days (T+N date)

Date that is N business days after (or before, with negative days) a start date: settlement and value dates (T+1 = 1, T+2 = 2), payment due dates, deadlines. days = 0 rolls a non-business start forward to the next business day. Lists every non-business day skipped and why. calendars: one or more calendar codes from list_calendars, e.g. ["USD.FX", "EUR.FX"] for a EUR/USD FX trade, ["XNYS.SETTLE"] for NYSE settlement, ["TARGET2.PAY"] for euro payments, ["GBLON.BANK"] for London banks. A date counts as a business day only when it is open in every calendar given. date defaults to today.

Input parameters:

- `calendars` (array, required)
- `date`
- `days` (integer, required)

### `business_days_between` (~144 tokens)

Business days between two dates

Number of business days between two dates (start counted, end not counted, like numpy.busday_count), with the non-business days in between and why. calendars: one or more calendar codes from list_calendars, e.g. ["USD.FX", "EUR.FX"] for a EUR/USD FX trade, ["XNYS.SETTLE"] for NYSE settlement, ["TARGET2.PAY"] for euro payments, ["GBLON.BANK"] for London banks. A date counts as a business day only when it is open in every calendar given.

Input parameters:

- `calendars` (array, required)
- `end` (string, required)
- `start` (string, required)

## Diagnostics

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

## Score history

- 2026-11-05: 68
- 2026-11-04: 61
- 2026-11-03: 60

## Common questions

### What is the TradingCalendars MCP server?

TradingCalendars is an MCP server listed in the public MCP registry as com.tradingcalendars/holidays. Business days, T+N settlement dates and holidays for FX, banks, payments and exchanges. This page covers its hosted endpoint (https://api.tradingcalendars.com/mcp).

### Is the TradingCalendars MCP server safe to use?

TradingCalendars scores 68 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 TradingCalendars MCP server expose?

TradingCalendars exposes 17 tools: list_calendars, get_holidays, fx_market_holidays, currency_non_clearing_days, bank_holidays, and 12 more. Their descriptions and schemas cost roughly 1,230 tokens of context every time the server is loaded.

### Does the TradingCalendars MCP server require authentication?

No. We connected to TradingCalendars without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

### Is the TradingCalendars MCP server still maintained?

TradingCalendars is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

## Links

- Remote endpoint: https://api.tradingcalendars.com/mcp
- Website: https://tradingcalendars.com/
- Changelog RSS feed: https://verifymcp.io/servers/com-tradingcalendars-holidays/api.xml
- Changelog JSON feed: https://verifymcp.io/servers/com-tradingcalendars-holidays/api.json
- HTML version of this page: https://verifymcp.io/servers/com-tradingcalendars-holidays/api
