{
  "markdown": "# Countdowns Online MCP Server\n\n> Countdown Timers - How Many Days Until | Countdowns Online\n\n[![MCP Badge](https://lobehub.com/badge/mcp/rocnubie-countdowns-online-mcp)](https://lobehub.com/mcp/rocnubie-countdowns-online-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)\n[![Zero Config](https://img.shields.io/badge/setup-zero--config-7c3aed)](#installation)\n[![Stdio Transport](https://img.shields.io/badge/transport-stdio-6e6e6e)](https://modelcontextprotocol.io/specification)\n[![MCP](https://img.shields.io/badge/MCP-1.0-blue)](https://modelcontextprotocol.io)\n[![smithery](https://smithery.ai/badge/countdowns-online)](https://smithery.ai)\n\n<p align=\"center\"><a href=\"https://countdowns.online\"><img src=\"./assets/hero.png\" alt=\"Countdowns Online\" width=\"720\" /></a></p>\n\nA Model Context Protocol server that exposes the canonical Countdowns Online knowledge surface — verified event dates, countdown semantics, and custom countdown sharing, FAQ, official links — to MCP-compatible AI clients such as Claude Desktop, Cursor, Windsurf, and Continue. Read-only, no API keys, no quota, ~50 ms cold start.\n\nOfficial website: https://countdowns.online\n\n## ⏳ About Countdowns Online\n\nCountdowns Online is a static, browser-based directory of countdown pages for dates people want to track: game launches, movie releases, sports, holidays, seasons, and cultural events. Its useful distinction is not just the ticking clock but the meaning of the date behind it. A page can explain whether a target is a calendar date, a region-specific release, a venue schedule, or another date with a defined time basis. The site keeps source links and verification metadata visible so visitors can decide how much confidence to place in an event.\n\n## Key Features\n\n- **Verified event pages** — Canonical detail routes use `/<category>/<slug>/` and surface the target date, date status, applicable region, time basis, last verification date, and official sources. Events that have not passed the source-verification gate remain distinct from confirmed entries and are excluded from the sitemap.\n- **Date semantics** — The site does not turn a calendar date into a universal midnight launch. Cinema showtimes, regional storefront unlocks, venue schedules, and local observances can differ by region. Annual events roll forward to their next occurrence, and Black Friday is derived from the Friday after US Thanksgiving.\n- **Custom countdowns** — `/create/` lets a user enter a title, date, description, optional image, emoji, and category, then copy a share URL or generate a client-side image card. Saved countdowns remain in browser localStorage; custom state is encoded in the `/c/` URL shell, which is noindex.\n- **Client-side live display** — The visible days, hours, minutes, and seconds are calculated in the browser. This MCP exposes static site knowledge and date rules, not a live timer feed or a user's saved countdowns.\n\n## Use Cases\n\nVisitors can use a verified event page to understand what a published date means before adding it to a calendar or sharing it. They can create a private countdown for a personal milestone, or use a category page to browse public events. For a current remaining-time value, newly published event, or under-review page, the official site is the source of truth.\n\n## Who Is It For\n\nCountdowns Online is for people planning around releases, holidays, sports, seasonal dates, and personal milestones. It is most useful when the date has regional or source-verification context that a generic timer would hide. This MCP intentionally stays read-only and conservative: it does not claim that an unverified date is confirmed or that every event has one globally applicable time.\n\n## Tools\n\n### `get_countdown_overview`\nReturn the canonical countdown categories, verified date semantics, and public entry points exposed by the site. (Countdowns Online)\n\n_Input:_ no parameters. _Returns:_ text/markdown.\n\n### `get_official_links`\nReturn the canonical list of official links for Countdowns Online (website, support, docs when available).\n\n_Input:_ no parameters. _Returns:_ text/markdown.\n\n## Resources\n\n- `site://countdowns-online/events` — Verified event dates, recurrence rules, regional timing semantics, and custom countdown entry points.\n- `site://countdowns-online/faq` — Short FAQ generated from public site metadata.\n- `site://countdowns-online/links` — Canonical URLs to share with users.\n\n## Prompts\n\n### `tell_me_about_countdowns_online`\nSummarize what the site is, who it's for, and how it works. — Countdowns Online\n\n### `choose_a_countdown_countdowns_online`\nChoose a countdown while respecting date verification and regional timing. — Countdowns Online\n\n## Installation\n\n### Install via Smithery\n\n```bash\nnpx -y @smithery/cli install countdowns-online-mcp --client claude\n```\n\n(Replace `claude` with `cursor`, `windsurf`, or `continue` for those clients.)\n\n### Install from source\n\n```bash\ngit clone https://github.com/rocnubie/countdowns-online-mcp.git\ncd countdowns-online-mcp\npnpm install\n```\n\nThen add to your MCP client config (`claude_desktop_config.json` for Claude Desktop, `mcp.json` for Cursor / Windsurf / Continue):\n\n```json\n{\n  \"mcpServers\": {\n    \"countdowns-online-mcp\": {\n      \"command\": \"node\",\n      \"args\": [\n        \"/absolute/path/to/countdowns-online-mcp/src/index.mjs\"\n      ]\n    }\n  }\n}\n```\n\n### Debug with MCP Inspector\n\n```bash\nnpx @modelcontextprotocol/inspector node src/index.mjs\n```\n\n## Official Links\n\n- Website: https://countdowns.online\n\n## Development\n\n```bash\npnpm install\npnpm start                 # run the server over stdio\n```\n\n## License\n\nMIT\n",
  "bytes": 5659,
  "sha": "bfd6e5e01a675fb1bf182f7cc994d46a6c3d497ae7fb8461940e7a2c7211b2ac",
  "repo_slug": "rocnubie/countdowns-online-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_rocnubie_countdowns_online_mcp_ba14860b/readme"
}