TradingCalendars is answering right now. Last checked 8 min ago. It exposes 17 tools.
Business days, T+N settlement dates and holidays for FX, banks, payments and exchanges.
Uptime history
4 days of history
4 days agonow
100.0%
Uptime 24h
91 of 91 checks
17
Tools
read from the server
327 ms
Response time
average over 24h
open, no key
Access
streamable-http
Nothing serious here today
Today is the operative word: we check TradingCalendars every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.
Connect this server
Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 8 min ago.
run in your terminal
claude mcp add holidays --transport http https://api.tradingcalendars.com/mcpSettings → Connectors → Add custom connector, then paste this address
https://api.tradingcalendars.com/mcp~/.codex/config.toml
[mcp_servers.holidays]
url = "https://api.tradingcalendars.com/mcp".cursor/mcp.json
{
"mcpServers": {
"holidays": {
"url": "https://api.tradingcalendars.com/mcp"
}
}
}.vscode/mcp.json
{
"servers": {
"holidays": {
"type": "http",
"url": "https://api.tradingcalendars.com/mcp"
}
}
}Available tools 17
Read directly from the server with tools/list, grouped by what they act on.
If a tool disappears, we record the date.
business
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.
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.
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).
market
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.
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
list_payment_systems
List covered payment systems with operator, type, currency, and country.
payment_system_holidays
Payment system holidays (e.g. TARGET2, FEDWIRE): days the system does not process or settle. start defaults to today.
bank
bank_holidays
Bank holidays for a financial centre (UN/LOCODE, e.g. USNYC): days retail and commercial banks are closed. start defaults to today.
calendars
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).
currencies
list_currencies
List covered currencies (ISO 4217) with issuing country and issuer.
currency
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.
exchanges
list_exchanges
List covered exchanges (ISO 10383 MIC) with country, city, and timezone.
financial
list_financial_centres
List covered financial centres (UN/LOCODE) with country and timezone.
holidays
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.
settlement
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
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.
weekends
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.
Endpoints
| URL | Transport | State | Latency | Checked |
|---|---|---|---|---|
| https://api.tradingcalendars.com/mcp | streamable-http | answering | 309 ms | 8 min ago |
Alternatives to TradingCalendars
same job, measured the same wayJapan Business Calendar MCP
by donniertf-hub
Japanese business days, holiday checks and invoice due dates for your AI agent.
US Business Calendar MCP
by donniertf-hub
US federal holidays, business-day maths, invoice due dates and IRS deadlines.
Canada Business Calendar MCP
by donniertf-hub
Canadian federal and provincial holidays, business-day maths and invoice due dates.
Trend0x
by trend0xai
AI trading terminal: market data, backtests, strategies and portfolio for crypto and stock exchanges
Revolut MCP
by jeff-nasseri
MCP server for the Revolut Business API: accounts, transactions, payments, FX, and more.
TradeTi.me — Market Hours
by nicolaijohannesen
Read-only trading hours for 30 stock exchanges — open now, next open, holidays, sessions.
China Futures Clock
by futuresclock
China futures trading days, session hours, contract expiries and exchange rule changes.
MCP Ebanx
by codespar
MCP server for EBANX — cross-border payments, payouts, exchange rates
TradingCalendars — questions
Answers built from our own checks of this server.
What can TradingCalendars do?
It exposes 17 tools, read directly from the server on our last check. Among them: add_business_days, bank_holidays, business_days_between, currency_non_clearing_days, fx_market_holidays, get_holidays and 11 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README.
How MCP servers expose tools in the first place →
What is TradingCalendars mostly used for?
Its tools cluster around business, market and payment. That is what this server is built to work with — the grouping comes from the actual tool names, not from a category we assigned.
Is TradingCalendars working right now?
We send a real MCP handshake every 15 minutes. Over the last 24 hours 91 of 91 checks got a reply (100.0%), average response time 327 ms. The bar chart above shows every period we have measured.
How do I connect TradingCalendars?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.
Does TradingCalendars need an API key?
No. TradingCalendars completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 17 of them are readable on this page. This is what we observed, not what the docs claim.
How fast is TradingCalendars?
It answers our handshake in 327 ms on average, which is faster than 44% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.