Business days, T+N settlement dates and holidays for FX, banks, payments and exchanges.
Connect Remote server
claude mcp add --transport http holidays https://api.tradingcalendars.com/mcp --header "Authorization: Bearer <YOUR_API_KEY>"
{
"mcpServers": {
"holidays": {
"url": "https://api.tradingcalendars.com/mcp",
"headers": {
"Authorization": "Bearer <YOUR_API_KEY>"
}
}
}
}
{
"servers": {
"holidays": {
"type": "http",
"url": "https://api.tradingcalendars.com/mcp",
"headers": {
"Authorization": "Bearer <YOUR_API_KEY>"
}
}
}
}
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_calendarsList 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_holidaysHolidays 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_holidaysFX 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_daysCurrency 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_holidaysBank holidays for a financial centre (UN/LOCODE, e.g. USNYC): days retail and commercial banks are closed. start defaults to today.
payment_system_holidaysPayment system holidays (e.g. TARGET2, FEDWIRE): days the system does not process or settle. start defaults to today.
trading_holidaysExchange 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_holidaysExchange settlement holidays for a market (ISO 10383 MIC, e.g. XNYS): days clearing and settlement cannot take place. start defaults to today.
list_currenciesList covered currencies (ISO 4217) with issuing country and issuer.
list_exchangesList covered exchanges (ISO 10383 MIC) with country, city, and timezone.
list_financial_centresList covered financial centres (UN/LOCODE) with country and timezone.
list_payment_systemsList covered payment systems with operator, type, currency, and country.
get_weekendsWeekend 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_statusLive 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_dayIs 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_daysDate 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_betweenNumber 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
| Name | Description |
|---|---|
AuthorizationOptional, 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
| Endpoint | https://api.tradingcalendars.com/mcp (Streamable HTTP) |
| First published | 3 Nov 2026 |
| Last updated | 3 Nov 2026 |
| Registry name | com.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.
