NestDaddy

TradingCalendars

com.tradingcalendars/holidays · v1.1.0

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

Connect Remote server

Terminal
claude mcp add --transport http holidays https://api.tradingcalendars.com/mcp --header "Authorization: Bearer <YOUR_API_KEY>"
~/.cursor/mcp.json
{
  "mcpServers": {
    "holidays": {
      "url": "https://api.tradingcalendars.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "holidays": {
      "type": "http",
      "url": "https://api.tradingcalendars.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}
Claude Desktop
Settings > Connectors > Add custom connector
URL: https://api.tradingcalendars.com/mcp

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools 17 found in our last check

  • 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).

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

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

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

  • bank_holidays

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

  • payment_system_holidays

    Payment system holidays (e.g. TARGET2, FEDWIRE): days the system does not process or settle. 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.

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

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

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

  • 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…

  • 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 NYS…

  • 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. calen…

  • 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 NY…

Headers

NameDescription
Authorization
Optional, secret
Optional: 'Bearer YOUR_API_KEY'. Without it the server runs a short keyless trial. Free key: https://tradingcalendars.com/signup?ref=mcp-registry

Details

Endpointhttps://api.tradingcalendars.com/mcp (Streamable HTTP)
First published3 Nov 2026
Last updated3 Nov 2026
Registry namecom.tradingcalendars/holidays

More finance and crypto servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.