Utilities

Pomodoro Timer

Classic Pomodoro technique: 25 minutes of focused work followed by 5 minutes of break to boost productivity

interactive· Interactive resultOpen tool

Quick start

Call this tool from your code in three languages.

cURL

curl -X POST 'https://api.elysiatools.com/en/api/tools/pomodoro-timer' \
  -H 'Content-Type: application/json' \
  -d '{"workMinutes":25,"breakMinutes":5,"longBreakMinutes":15,"sessionsUntilLongBreak":4,"taskName":"What are you working on?"}'

API reference

Send a POST request with your inputs as JSON. File parameters require a separate upload first.

Endpoint

HTTP

POST https://api.elysiatools.com/en/api/tools/pomodoro-timer

Parameters

Name	Type	Required	Description
workMinutes	number	No	Duration of each focused work session
breakMinutes	number	No	Duration of short breaks between work sessions
longBreakMinutes	number	No	Duration of long breaks after completing sessions
sessionsUntilLongBreak	number	No	How many work sessions to complete before a long break
taskName	text	No

MCP integration

Add this tool to your Model Context Protocol server so AI agents can list and call it.

Server configuration

Add this block to your MCP client configuration:

mcp.json

{
  "mcpServers": {
    "elysiatools-pomodoro-timer": {
      "name": "pomodoro-timer",
      "description": "Classic Pomodoro technique: 25 minutes of focused work followed by 5 minutes of break to boost productivity",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=pomodoro-timer",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

List available tools

After connecting to the SSE endpoint, list the exposed tools:

tools/list

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

Call this tool

Invoke the tool by its id, passing arguments built from its parameters:

tools/call

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "pomodoro-timer",
    "arguments": {
  "workMinutes": 25,
  "breakMinutes": 5,
  "longBreakMinutes": 15,
  "sessionsUntilLongBreak": 4,
  "taskName": "What are you working on?"
}
  }
}

Chain multiple tools in one session with a comma-separated toolId list, e.g. /mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp (max 20).

Questions or issues? Contact [email protected]

Browse tools Open tool

Response format

Interactive result

JSON

{
  "result": "Initial display content",
  "interactive": true,
  "components": [
    {
      "type": "timer",
      "id": "timer1",
      "config": {
        "label": "Countdown",
        "duration": 60
      }
    }
  ],
  "state": {
    "key": "value"
  },
  "actions": [
    {
      "type": "start",
      "id": "start-btn",
      "label": "Start"
    }
  ],
  "styles": "/* Custom CSS */",
  "scripts": "/* Client-side scripts */",
  "error": "Error message (optional)",
  "message": "Notification message (optional)",
  "metadata": {
    "key": "value"
  }
}