# gotimer-mcp

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add hazoservices/gotimer-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list hazoservices/gotimer-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get hazoservices/gotimer-mcp list_timer_types

# Call a tool
npx -y @smithery/cli@latest tool call hazoservices/gotimer-mcp list_timer_types '{}'
```

## Direct MCP Connection

Endpoint: `https://gotimer-mcp--hazoservices.run.tools`

## Tools (10)

- `list_timer_types` — Returns all available timer types in GoTimer with their names, descriptions, and default configurations.
- `list_timer_presets` — Lists pre-configured timer presets (e.g. Pomodoro, HIIT, Meditation, Film Development). Optionally filter by category.
- `list_public_challenges` — Lists all public challenges on GoTimer with participant counts and scores.
- `get_leaderboard` — Gets the leaderboard and game history for a specific GoTimer challenge.
- `create_challenge` — Creates a new GoTimer challenge. Requires an API key configured via GOTIMER_API_KEY.
- `join_challenge` — Joins a GoTimer group challenge using a join code. Requires an API key configured via GOTIMER_API_KEY.
- `create_timer` — Creates a live timer on GoTimer and returns a shareable URL. Accepts strategy types (countdown, chess-clock, etc.) and …
- `create_pomodoro` — Creates a Pomodoro focus timer. Default: 25 min work, 5 min break, 4 rounds.
- `get_timer_url` — Returns a URL to a GoTimer page with pre-filled configuration (timer does NOT auto-start).
- `get_embed_code` — Generates HTML embed code for a GoTimer widget. Returns an iframe snippet.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get hazoservices/gotimer-mcp <tool-name>
```

## Prompts (5)

- `start_pomodoro` (work_minutes, break_minutes, rounds, label) — Start a Pomodoro focus session with shareable timer URL.
- `plan_hiit_workout` (work_seconds, rest_seconds, rounds) — Create a HIIT interval workout timer.
- `start_meditation` (minutes) — Start a quiet meditation countdown timer.
- `setup_film_developing` (process, temperature_c) — Set up a film development timer for a chosen process (C-41, B&W, E-6, etc.).
- `start_presentation_timer` (total_minutes, topic) — Create a presentation countdown timer with a topic label.