Trading Calendar & Public Holidays (x402)
Server Details
Stock exchange trading days, hours, live market status (28 exchanges) and holidays (247 countries).
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 5 tools
market_status and trading_day overlap significantly: both can answer whether an exchange is open now and return next open/close details. business_day and public_holidays also overlap on holiday/date questions. Descriptions provide useful cues, but an agent still needs care to choose the right tool.
All names use consistent snake_case two-word noun compounds, with clear parallels like business_day/trading_day and trading_calendar. They are predictable, though noun-only naming rather than verb_noun makes the action less explicit.
Five tools is well-scoped for a trading calendar and public holidays service. Each tool covers a meaningful slice of the domain without excessive fragmentation.
The surface covers country business-day logic, yearly public holiday lists, yearly exchange calendars, single-exchange day checks, and live multi-exchange status. No major gaps are apparent for the stated domain.
Available Tools
5 toolsbusiness_dayPublic Holidays & Business DaysARead-onlyInspect
Use when an agent must know if a date is a business day in a country, or compute a due date: weekend or holiday (with name), previous/next business day, date plus N business days (add=), business days until a date (to=). 247 countries, 2026-2028, optional state/province (region=), local weekends (e.g. Fri-Sat). Bad input: HTTP 400, no charge. Price: 0.002 USDC per successful call (x402).
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Optional end date YYYY-MM-DD (>= date): count business days from date to it, both included. | |
| add | No | Optional: number of business days to add (negative = go back), -260 to 260. | |
| date | No | Day as YYYY-MM-DD. Optional, default: today (UTC). | |
| region | No | Optional state/province for regional holidays, e.g. BY or DE-BY (Bavaria), CA (California), 9 (Vienna). Listed per country in GET /v1/holiday-countries. | |
| country | Yes | 2-letter ISO country code, e.g. AT, DE, US, GB, FR, JP, IN, BR, AE. 247 countries; free list: GET /v1/holiday-countries. |
market_statusExchange Trading CalendarARead-onlyInspect
Use when an agent needs to know right now which stock exchanges are open: open, lunch break, pre-market, after-hours or closed (with holiday name), local time, exact next open and close in UTC. One call checks up to 28 exchanges (default all) incl. NYSE, Nasdaq, LSE, Xetra, Euronext, Tokyo, HKEX, Shanghai, ASX. Official exchange calendars only; unknown exchange: HTTP 400, no charge. Price: 0.002 USDC per successful call (x402).
| Name | Required | Description | Default |
|---|---|---|---|
| exchanges | No | Comma-separated MIC codes or names, e.g. XNYS,XETR,XTKS. Optional, default: all exchanges. |
public_holidaysPublic Holidays & Business DaysARead-onlyInspect
Use when an agent needs all public holidays of a country for a year (planning deliveries, payments, deadlines, staffing). 247 countries, 2026-2028, optional state/province (region=) for regional holidays. English and local names, weekend days of the country, moon-dependent dates flagged as estimated. Bad input: HTTP 400 before payment, no charge. Price: 0.002 USDC per successful call (x402).
| Name | Required | Description | Default |
|---|---|---|---|
| year | No | Year, e.g. 2027. Optional, default: current year. Covered: 2026-2028. | |
| region | No | Optional state/province for regional holidays, e.g. BY or DE-BY (Bavaria), CA (California), 9 (Vienna). Listed per country in GET /v1/holiday-countries. | |
| country | Yes | 2-letter ISO country code, e.g. AT, DE, US, GB, FR, JP, IN, BR, AE. 247 countries; free list: GET /v1/holiday-countries. |
trading_calendarExchange Trading CalendarARead-onlyInspect
Use when an agent plans ahead and needs every closure of a stock exchange for a whole year: holiday names, half days, late openings, regular hours, count of trading days. 28 exchanges incl. NYSE, Nasdaq, LSE, Xetra, Euronext, SIX, Tokyo, HKEX, Shanghai, ASX. Official exchange calendars only; bad input or uncovered year: HTTP 400, no charge. Price: 0.002 USDC per successful call (x402).
| Name | Required | Description | Default |
|---|---|---|---|
| year | No | Year, e.g. 2026. Optional, default: current year. | |
| exchange | Yes | Exchange MIC code, e.g. XNYS (NYSE), XNAS (Nasdaq), XLON (London), XETR (Xetra), XPAR (Paris), XTKS (Tokyo), XHKG (Hong Kong). Common names also work (NYSE, Xetra, LSE). Free list: GET /v1/exchanges. |
trading_dayExchange Trading CalendarARead-onlyInspect
Use when an agent needs to know if a stock exchange trades on a given day (default today) before scheduling orders, reports or alerts. 28 exchanges incl. NYSE, Nasdaq, LSE, Xetra, Euronext, SIX, Tokyo, HKEX, Shanghai, ASX. Returns holiday name, hours in local time + UTC, half days, lunch breaks, pre/after-market (Nasdaq, Xetra), live status, next open/close, previous/next trading day. Official exchange calendars only; bad input: HTTP 400, no charge. Price: 0.002 USDC per successful call (x402).
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | Day as YYYY-MM-DD. Optional, default: today in the exchange's time zone. | |
| exchange | Yes | Exchange MIC code, e.g. XNYS (NYSE), XNAS (Nasdaq), XLON (London), XETR (Xetra), XPAR (Paris), XTKS (Tokyo), XHKG (Hong Kong). Common names also work (NYSE, Xetra, LSE). Free list: GET /v1/exchanges. |
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
5 tool updates
- First observed
business_day - First observed
market_status - First observed
public_holidays - First observed
trading_calendar - First observed
trading_day
Related MCP Connectors
Read-only trading hours for 30 stock exchanges — open now, next open, holidays, sessions.
Business days, holidays and settlement dates for ACH, TARGET2, Bacs, 28 exchanges and 247 countries
Public holidays, business days and long weekends for about 250 countries, in each local time zone.
Business days, T+N settlement dates and holidays for FX, banks, payments and exchanges.
Related MCP Servers
- AlicenseAqualityCmaintenanceProvides correct trading day and settlement date calculations for multiple exchanges, with no external API calls.610 npmMIT
- AlicenseNot gradedqualityCmaintenanceProvides real-time Indian stock market intelligence including NSE market status, company ticker lookup, and market hours for AI assistants.MIT
- AlicenseNot gradedqualityDmaintenanceReal public/bank/school holiday lookup for 206 countries via a rule-based calendar engine (moveable holidays like Easter computed astronomically, not guessed). Priced per call via x402/USDC on Base.MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to calculate business days and public holidays for 29 countries, including adding business days, counting business days between dates, checking whether a date is a business day, and listing holidays and supported countries.MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.