protogrid
Sign inAdd to your agent

Search / com.tradingcalendars/holidays

TradingCalendars

R0· no sign-in

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

v1.1.0 · active · website · descriptor JSON · versions

An agent can connect right now, no human step.Remote endpoint, no authentication, reachable on the last probe.
Quality92strong
Trust82of 100
Uptime, 30 days95%
Latency p50335 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "holidays": {
      "type": "http",
      "url": "https://api.tradingcalendars.com/mcp",
      "headers": {
        "Authorization": "Bearer ${HOLIDAYS_TOKEN}"
      }
    }
  }
}
claude mcp add --transport http holidays https://api.tradingcalendars.com/mcp --header "Authorization: Bearer ${HOLIDAYS_TOKEN}"
[mcp_servers.holidays]
url = "https://api.tradingcalendars.com/mcp"
bearer_token_env_var = "HOLIDAYS_TOKEN"

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "holidays": {
      "type": "remote",
      "url": "https://api.tradingcalendars.com/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:HOLIDAYS_TOKEN}"
      }
    }
  }
}
{
  "mcpServers": {
    "holidays": {
      "type": "http",
      "url": "https://api.tradingcalendars.com/mcp",
      "headers": {
        "Authorization": "Bearer ${HOLIDAYS_TOKEN}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=holidays&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vYXBpLnRyYWRpbmdjYWxlbmRhcnMuY29tL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciAke0hPTElEQVlTX1RPS0VOfSJ9fQ%3D%3D"
}
{
  "servers": {
    "holidays": {
      "type": "http",
      "url": "https://api.tradingcalendars.com/mcp",
      "headers": {
        "Authorization": "Bearer ${HOLIDAYS_TOKEN}"
      }
    }
  }
}
{
  "mcpServers": {
    "holidays": {
      "httpUrl": "https://api.tradingcalendars.com/mcp",
      "headers": {
        "Authorization": "Bearer ${HOLIDAYS_TOKEN}"
      }
    }
  }
}
extensions:
  "holidays":
    enabled: true
    name: "holidays"
    type: streamable_http
    uri: "https://api.tradingcalendars.com/mcp"
    headers:
      "Authorization": "Bearer ${HOLIDAYS_TOKEN}"
    timeout: 300

Placeholders to fill from your own secret store: ${HOLIDAYS_TOKEN}. The registry never accepts secret values.

Quality 92 / 100strong

protocol88 · weight 25
  • pass
    protocol.modernsupports 2026-07-28 (server/discover)
  • pass
    protocol.statelessanswers without a session
  • pass
    protocol.transportstreamable HTTP
  • warn
    protocol.list_ttltools/list declares ttlMs 0, so clients re-fetch it on every use
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene100 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • pass
    tools.description_lengthdescriptions are concise
  • pass
    tools.schemasevery tool has an object input schema
  • pass
    tools.annotations17 of 17 tools declare readOnlyHint or destructiveHint
  • pass
    tools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
  • pass
    tools.token_costabout 2,554 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
  • pass
    tools.hidden_textno hidden text in tool names, descriptions, schemas or annotations
stability83 · weight 15
  • warn
    stability.changes17 tool changes in 30 days
  • pass
    stability.rug_pullno tool changed its meaning under the same name
  • pass
    stability.new_linksno tool change named a new site
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

17 tools, about 2,554 tokens to load them all · tool set d79b6c319910 · tools last changed 2026-11-04 · checked 2026-11-14 07:03 UTC

Tool changes

  • business_days_betweenchangedtitle, annotations
  • add_business_dayschangedtitle, annotations
  • is_business_daychangedtitle, annotations
  • market_statuschangedtitle, annotations
  • get_weekendschangedtitle, annotations
  • list_payment_systemschangedtitle, annotations
  • list_financial_centreschangedtitle, annotations
  • list_exchangeschangedtitle, annotations
  • list_currencieschangedtitle, annotations
  • settlement_holidayschangedtitle, annotations

Showing the latest 10. Full history: list_changes · trend: quality JSON.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 82 / 100

no-repository
provenance55
liveness98
freshness100
hygiene80

+dns-namespace +website +reachable +uptime-95% +updated-11d-ago -no-repository

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://api.tradingcalendars.com/mcp streamable-httpnoneyes95%335 ms2026-07-282026-11-14

Tools (17)

add_business_daysread-onlyDate 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.
bank_holidaysread-onlyBank holidays for a financial centre (UN/LOCODE, e.g. USNYC): days retail and commercial banks are closed. start defaults to today.
business_days_betweenread-onlyNumber 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.
currency_non_clearing_daysread-onlyCurrency 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.
fx_market_holidaysread-onlyFX market holidays for a currency (ISO 4217, e.g. USD): days the FX market for that currency does not trade. start defaults to today.
get_holidaysread-onlyHolidays 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.
get_weekendsread-onlyWeekend 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.
is_business_dayread-onlyIs 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).
list_calendarsread-onlyList 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).
list_currenciesread-onlyList covered currencies (ISO 4217) with issuing country and issuer.
list_exchangesread-onlyList covered exchanges (ISO 10383 MIC) with country, city, and timezone.
list_financial_centresread-onlyList covered financial centres (UN/LOCODE) with country and timezone.
list_payment_systemsread-onlyList covered payment systems with operator, type, currency, and country.
market_statusread-onlyLive 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_system_holidaysread-onlyPayment system holidays (e.g. TARGET2, FEDWIRE): days the system does not process or settle. start defaults to today.
settlement_holidaysread-onlyExchange settlement holidays for a market (ISO 10383 MIC, e.g. XNYS): days clearing and settlement cannot take place. start defaults to today.
trading_holidaysread-onlyExchange 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.

Schemas: list_tools.

Similar MCP servers

  • Business Day CalendarsR0quality 86
    dev.workers.quietworklabs.business-days/business-days

    NYSE, Federal Reserve, TARGET2 and UK business days, holidays and T+N settlement dates.

  • BankdayR1quality 83
    io.github.ParsingMAINFRAME/bankday

    Business days, holidays and settlement dates for ACH, TARGET2, Bacs, 28 exchanges and 247 countries

  • Business DaysR0quality 96
    com.profitpather.tools/business-days

    Public holidays and working-day maths for 200+ countries, cross-checked across three providers.

  • Date MathR0quality 78
    io.github.JowenDelaPena/date-math

    Date/time math for agents: business days, holidays, time zones, cron, RRULE. 25 free calls/day.

  • SA Business CalendarR0quality 78
    io.github.AliMora83/sa-business-calendar-mcp

    South African business days, public holidays and SARS EMP201/VAT201 deadlines.

  • Holiday CalendarR0quality 96
    com.modernmustardseed/holiday-calendar

    U.S. federal holidays with observed dates and business-day math. Example from an open-source kit.

Official server.json
{
  "name": "com.tradingcalendars/holidays",
  "title": "TradingCalendars",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://api.tradingcalendars.com/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "Authorization",
          "isSecret": true,
          "description": "Optional: 'Bearer YOUR_API_KEY'. Without it the server runs a short keyless trial. Free key: https://tradingcalendars.com/signup?ref=mcp-registry"
        }
      ]
    }
  ],
  "version": "1.1.0",
  "websiteUrl": "https://tradingcalendars.com",
  "description": "Business days, T+N settlement dates and holidays for FX, banks, payments and exchanges."
}