TradingCalendars

com.tradingcalendarsPublished by tradingcalendars.comOfficial publisherv1.1.0Updated Nov 3, 2026

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

VerifiedStreamable HTTPWeb executable

Overview

TradingCalendars's hosted MCP server (api.tradingcalendars.com), published by tradingcalendars.com; optional API key; Streamable HTTP; 17 tools.

No AI overview yet: these facts come from the registry entry and the server itself.

Publisher
tradingcalendars.com
Endpoint
api.tradingcalendars.com
Last checked

Installation

In SourceWeft

  1. Open TradingCalendars in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.tradingcalendars%2Fholidays/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "tradingcalendars": {
      "type": "http",
      "url": "https://api.tradingcalendars.com/mcp"
    }
  }
}

Tools

17

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

Parameterscalendar_type

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.

Parametersendstartcalendarrequired

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.

Parametersendstartcurrencyrequired

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.

Parametersendstartcurrencyrequired

bank_holidays

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

Parametersendstartfinancial_centrerequired

payment_system_holidays

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

Parametersendstartpayment_systemrequired

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.

Parametersendstartmarketrequired

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.

Parametersendstartmarketrequired

list_currencies

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

Takes no parameters.

list_exchanges

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

Takes no parameters.

list_financial_centres

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

Takes no parameters.

list_payment_systems

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

Takes no parameters.

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.

Parameterscalendarrequired

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

Parametersmarket

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

Parametersdatecalendarsrequired

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.

Parametersdatedaysrequiredcalendarsrequired

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.

Parametersendrequiredstartrequiredcalendarsrequired

Version history

2
  1. v1.1.0LatestNov 3, 2026
  2. v1.0.0Nov 3, 2026

Score

72% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts

    Publish an icon in the registry entry.

  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.