# TradingCalendars

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

- name: com.tradingcalendars/holidays
- version: 1.1.0
- connection class: R0 (autonomous)
- trust: 82/100 flags: no-repository
- quality: 92/100 (strong)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.tradingcalendars%2Fholidays
- tools: https://api.protogrid.dev/v1/servers/com.tradingcalendars%2Fholidays/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "holidays": {
      "type": "http",
      "url": "https://api.tradingcalendars.com/mcp",
      "headers": {
        "Authorization": "Bearer ${HOLIDAYS_TOKEN}"
      }
    }
  }
}
```

Placeholders to fill: `${HOLIDAYS_TOKEN}`.

## Trust

- hygiene: 80
- liveness: 98
- freshness: 100
- provenance: 55
- drivers: +dns-namespace +website +reachable +uptime-95% +updated-11d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 92/100 (strong)

### protocol: 88 (weight 25)

- pass `protocol.modern`: supports 2026-07-28 (server/discover)
- pass `protocol.stateless`: answers without a session
- pass `protocol.transport`: streamable HTTP
- warn `protocol.list_ttl`: tools/list declares ttlMs 0, so clients re-fetch it on every use

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 100 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 17 of 17 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 2,554 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump
- pass `tools.hidden_text`: no hidden text in tool names, descriptions, schemas or annotations

### stability: 83 (weight 15)

- warn `stability.changes`: 17 tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name
- pass `stability.new_links`: no tool change named a new site

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 17, about 2,554 tokens to load them all
- tool set hash: d79b6c319910ba8ef20d4ab6c329d275
- tools last changed: 2026-11-04T19:02:05.591Z
- badge: [![protogrid quality](https://protogrid.dev/badge/com.tradingcalendars/holidays.svg)](https://protogrid.dev/servers/com.tradingcalendars/holidays)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-11-04 `business_days_between` changed (title, annotations)
- 2026-11-04 `add_business_days` changed (title, annotations)
- 2026-11-04 `is_business_day` changed (title, annotations)
- 2026-11-04 `market_status` changed (title, annotations)
- 2026-11-04 `get_weekends` changed (title, annotations)
- 2026-11-04 `list_payment_systems` changed (title, annotations)
- 2026-11-04 `list_financial_centres` changed (title, annotations)
- 2026-11-04 `list_exchanges` changed (title, annotations)
- 2026-11-04 `list_currencies` changed (title, annotations)
- 2026-11-04 `settlement_holidays` changed (title, annotations)

Full history: https://api.protogrid.dev/v1/servers/com.tradingcalendars%2Fholidays/changes

## Remotes

- https://api.tradingcalendars.com/mcp (streamable-http, auth none, reachable true, uptime30d 0.95238096)

## Packages

_none_

## Tools (17)

- `add_business_days`: 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.
- `bank_holidays`: Bank holidays for a financial centre (UN/LOCODE, e.g. USNYC): days retail and commercial banks are closed. start defaults to today.
- `business_days_between`: 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.
- `currency_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.
- `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.
- `get_holidays`: 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.
- `get_weekends`: 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.
- `is_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).
- `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).
- `list_currencies`: List covered currencies (ISO 4217) with issuing country and issuer.
- `list_exchanges`: List covered exchanges (ISO 10383 MIC) with country, city, and timezone.
- `list_financial_centres`: List covered financial centres (UN/LOCODE) with country and timezone.
- `list_payment_systems`: List covered payment systems with operator, type, currency, and country.
- `market_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).
- `payment_system_holidays`: Payment system holidays (e.g. TARGET2, FEDWIRE): days the system does not process or settle. start defaults to today.
- `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.
- `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.
