{
  "name": "timer.ly",
  "description": "Stateless countdown URLs. Build a duration timer, a target-date countdown, a since-counter, or a holiday countdown — all returned as public, shareable links. No authentication. Five locales (en, de, fr, es, it).",
  "version": "1.0",
  "vendor": "Sebastian Messingfeld",
  "contact": "https://to.messeb.com/contact",
  "logo": "https://www.timer.ly/favicon.png",
  "homepage": "https://www.timer.ly/",
  "documentation": "https://www.timer.ly/docs",
  "endpoints": {
    "mcp": "https://www.timer.ly/api/mcp",
    "mcp_alias": "https://www.timer.ly/mcp",
    "mcp_server_card": "https://www.timer.ly/.well-known/mcp/server-card.json",
    "mcp_discovery": "https://www.timer.ly/.well-known/mcp.json",
    "ask": "https://www.timer.ly/ask",
    "status": "https://www.timer.ly/api/status",
    "openapi": "https://www.timer.ly/openapi.json",
    "docs": "https://www.timer.ly/docs",
    "llms_full": "https://www.timer.ly/llms-full.txt",
    "sitemap": "https://www.timer.ly/sitemap.xml",
    "agent_card": "https://www.timer.ly/.well-known/agent-card.json",
    "agent_mode": "https://www.timer.ly/?mode=agent",
    "homepage_markdown": "https://www.timer.ly/index.md"
  },
  "transports": {
    "json_rpc": "https://www.timer.ly/api/mcp",
    "streamable_http_sse": "https://www.timer.ly/api/mcp (Accept: text/event-stream)",
    "nlweb_query": "https://www.timer.ly/ask",
    "nlweb_streaming": "https://www.timer.ly/ask (prefer.streaming: true)"
  },
  "rate_limit": {
    "policy": "soft",
    "limit": 600,
    "window_seconds": 60,
    "headers": ["RateLimit-Policy", "RateLimit-Limit", "RateLimit-Remaining", "RateLimit-Reset", "X-RateLimit-*"]
  },
  "auth": { "type": "none" },
  "capabilities": [
    "countdown.create.duration",
    "countdown.create.target",
    "countdown.create.since",
    "countdown.create.event",
    "countdown.parse",
    "holiday.lookup",
    "calendar.browse"
  ],
  "languages": ["en", "de", "fr", "es", "it"],
  "when_to_use": "When a user asks for a countdown link, a holiday date, a Pomodoro timer URL, a 'time since' counter, or any shareable countdown for chat, email, calendar invites, or social posts. The URL itself encodes the timer — no signup required for the recipient.",
  "examples": [
    {
      "request": "I need a 25-minute Pomodoro link",
      "tool": "build_duration_url",
      "arguments": { "minutes": 25 },
      "result": "https://www.timer.ly/in/25m"
    },
    {
      "request": "Countdown to Christmas 2026 in German",
      "tool": "build_event_url",
      "arguments": { "event": "christmas", "locale": "de" },
      "result": "https://www.timer.ly/de/bis/weihnachten"
    },
    {
      "request": "Time since pandemic was declared",
      "tool": "build_since_url",
      "arguments": { "iso": "2020-03-11" },
      "result": "https://www.timer.ly/since/2020-03-11"
    }
  ]
}