tradetime-mcp

npmjs.com/package/tradetime-mcp · v0.1.2 · MIT · npx -y tradetime-mcp

An MCP server for global stock-exchange trading hours. Ask any LLM agent (Claude, Cursor, …) "is the NYSE open right now?", "which markets are trading?", "when does Tokyo next open?" — plus holidays and session times. Read-only, no API key. Powered by TradeTi.me; the same engine behind api.tradeti.me.

Install

npx-run over stdio — nothing to install globally. Add the server to your MCP client, restart it, and the tradetime tools appear. No key, no account.

Claude Desktop — add to claude_desktop_config.json:

{
  "mcpServers": {
    "tradetime": {
      "command": "npx",
      "args": ["-y", "tradetime-mcp"]
    }
  }
}

Claude Code (CLI):

claude mcp add tradetime -- npx -y tradetime-mcp

VS Code:

code --add-mcp '{"name":"tradetime","command":"npx","args":["-y","tradetime-mcp"]}'

Cursor · Cline · Windsurf · any stdio client — paste the same mcpServers block into the client's MCP config.

Hosted remote server: a URL-based endpoint at https://mcp.tradeti.me/mcp (Streamable HTTP) — the same 8 tools for clients that connect to a URL instead of spawning npx. Keyless.

Tools

All eight tools are read-only and idempotent (annotated readOnlyHint / idempotentHint, openWorldHint:false) — a client can safely auto-approve them; the worst any call does is answer a question.

| Tool | Answers | |------|---------| | is_market_open | Is <exchange> open now (or at a given at time)? Open flag + status + time-to-close. | | get_exchange_status | Full live status (status enum, session type, hours-to-next, why-closed). | | markets_open_now | Which of the world's exchanges are open right now? | | time_until_next_open | Hours until <exchange> next opens (weekends & holidays skipped), or until it closes if open. | | list_exchanges | List exchanges (optionally by region) — discover valid ids. | | get_exchange | Full record: sessions, holidays, early closes, sources. | | get_holidays | Closure calendar (holidays + early closes). | | get_trading_sessions | Pre / main / post session hours in exchange-local time. |

exchange accepts an id (nyse, nasdaq, lse, nikkei, hkex, …) or a name/city ("New York Stock Exchange", "Tokyo"), case-insensitive. Pass at (ISO 8601, e.g. 2026-07-06T14:30:00Z) to any time-based tool to evaluate a specific moment — great for "will X be open at Y?".

Example call → response

is_market_open({ "exchange": "nyse" }) returns:

{
  "exchange": "nyse",
  "name": "NYSE",
  "open": true,
  "status": "main_open",
  "timeToNextHours": 0,
  "timeToCloseHours": 5.5,
  "closedReason": null,
  "asOf": "2026-07-06T14:30:00.000Z"
}

When closed, open is false, closedReason is "weekend" / "holiday" (or null after-hours on a trading day), and timeToNextHours counts to the next open with weekends and holidays already skipped.

Example conversation

You: Is the London Stock Exchange open right now, and if not when does it open? Agent (calls is_market_open → time_until_next_open): The LSE is currently closed; it next opens in about 12 hours (weekends and holidays skipped).

Notes

• Times are exchange-LOCAL facts — an exchange's open/close/holidays don't shift with your timezone.
• The data is a convenience, not an authoritative or real-time feed. It follows published trading calendars and doesn't know about unscheduled halts. Verify with the exchange before any time-sensitive or financial decision.
• License: MIT. Docs + REST API + a runnable playground: https://tradeti.me/developers/mcp.