MCP server
Financial calendars for your AI assistant
Connect Claude, ChatGPT, Cursor or any MCP client to business days, T+1 / T+2 settlement dates, holidays and live market status for 50 currencies, 69 financial centres, 29 payment systems and 61 exchanges.
Works withClaudeChatGPTCursorvia MCPAsk calendar questions in plain English
Language models are bad at holidays: they mix up observed and original dates, miss one-off closures and know nothing about next year's exceptional days. The TradingCalendars.com MCP server answers from maintained calendars, and every answer names the holidays it skipped, so you can check it.
- “What's the T+2 settlement date for a EUR/USD trade done on 23 December?”
- “Is next Monday a business day for both USD and EUR payments?”
- “How many business days are there in January for GBP and SGD together?”
- “Is the New York Stock Exchange open right now, and when does it close today?”
- “Which days close TARGET2 in the next 90 days?”
- “List this year's half days and early closes on the London Stock Exchange.”
Connect your assistant
Server URL https://api.tradingcalendars.com/mcp (streamable HTTP). It works without a key on recent years; add your free API key for every year and your plan's daily limit.
Name: TradingCalendars
URL: https://api.tradingcalendars.com/mcp
Authentication: No sign-in
Request headers: Authorization = Bearer YOUR_API_KEY (optional)ChatGPT — add the app
TradingCalendars.com is in ChatGPT's app directory. Open it and add it to ChatGPT. No key is needed: it covers recent years, with a daily limit shared by all ChatGPT users.
Name: TradingCalendars
MCP server URL: https://api.tradingcalendars.com/mcp?api_key=YOUR_API_KEY
Authentication: No authentication
(needs developer mode; without a key, use the app above)This URL carries your key: treat it like a password.
claude mcp add --transport http tradingcalendars \
https://api.tradingcalendars.com/mcp \
--header "Authorization: Bearer YOUR_API_KEY"{
"mcpServers": {
"tradingcalendars": {
"url": "https://api.tradingcalendars.com/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}Other clients: add a remote MCP server with the URL above and the header Authorization: Bearer YOUR_API_KEY, or https://api.tradingcalendars.com/mcp?api_key=YOUR_API_KEY when the client can't set headers. Full reference: documentation.
17 read-only tools
Business days
is_business_dayIs a date open in one or several calendars, and if not, whyadd_business_daysT+N settlement, value and payment dates, listing every skipped daybusiness_days_betweenBusiness days between two dates across calendars
Holidays
fx_market_holidaysFX market holidays for a currencycurrency_non_clearing_daysDays a currency cannot clear or settlebank_holidaysBank holidays for a financial centrepayment_system_holidaysTARGET2, Fedwire, CHAPS and other payment systemstrading_holidaysExchange trading holidays, half days and early closessettlement_holidaysExchange settlement holidaysget_holidaysAny calendar by codeget_weekendsWeekend definitions, including historical changes
Live
market_statusOpen, half day or closed right now, with next open and close
Reference
list_calendarsEvery published calendar codelist_currenciesCovered currencies (ISO 4217)list_exchangesCovered exchanges (ISO 10383 MIC)list_financial_centresCovered financial centres (UN/LOCODE)list_payment_systemsCovered payment systems
The same calendars are available over the REST API and the open-source Python client. See the full data coverage and plans.
Questions
The Model Context Protocol (MCP) is an open standard that lets AI assistants such as Claude, ChatGPT and Cursor call outside tools. Our hosted MCP server gives them financial calendars, so they answer holiday and business-day questions from maintained data instead of guessing.