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 MCP

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

Claude (claude.ai, Claude Desktop) — Settings → Connectors → Add custom connector
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.

ChatGPT with your API key — custom connector (developer mode)
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 Code
claude mcp add --transport http tradingcalendars \
  https://api.tradingcalendars.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"
Cursor — .cursor/mcp.json
{
  "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_day Is a date open in one or several calendars, and if not, why
  • add_business_days T+N settlement, value and payment dates, listing every skipped day
  • business_days_between Business days between two dates across calendars

Holidays

  • fx_market_holidays FX market holidays for a currency
  • currency_non_clearing_days Days a currency cannot clear or settle
  • bank_holidays Bank holidays for a financial centre
  • payment_system_holidays TARGET2, Fedwire, CHAPS and other payment systems
  • trading_holidays Exchange trading holidays, half days and early closes
  • settlement_holidays Exchange settlement holidays
  • get_holidays Any calendar by code
  • get_weekends Weekend definitions, including historical changes

Live

  • market_status Open, half day or closed right now, with next open and close

Reference

  • list_calendars Every published calendar code
  • list_currencies Covered currencies (ISO 4217)
  • list_exchanges Covered exchanges (ISO 10383 MIC)
  • list_financial_centres Covered financial centres (UN/LOCODE)
  • list_payment_systems Covered 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.