API & MCP

Everything a person can do on Focus Room Countdown, a program or AI agent can do with the same inputs and get the identical result.

HTTP API

POST https://focusroomcountdown.usefulweb.app/api/v1/calculate – run Focus Room Countdown
GET https://focusroomcountdown.usefulweb.app/api/v1/tool – inputs, output schema, examples
OpenAPI 3.1: /openapi.json · /openapi.yaml
Errors: application/problem+json; 422 includes per-field errors.

Focus Room Countdown

Counts down to a date and time in any IANA time zone: days, hours, minutes and seconds left, calendar days and working days before the event day (weekends of your choice and public holidays of 16 countries skipped), daylight-saving changes on the way, the same moment on other clocks, and an .ics calendar event. The “New Year in every time zone” mode lists when midnight arrives from Kiritimati to Baker Island. The Focus Room app shows the same countdown full screen.

Inputs of Focus Room Countdown
Field	Type	Default	Description
`event`	select (custom, new-year)	"custom"	Event
`title`	text	"Launch"	Title
`target`	datetime	"2027-03-15T09:00"	Date and time of the event. Wall-clock time in the event’s time zone. Not used for New Year.
`zone`	text	"Europe/Berlin"	Time zone of the event. IANA time-zone name such as Europe/Berlin, America/New_York, Asia/Kolkata or UTC.
`from`	datetime	—	Count from (optional). Wall-clock time in the event’s time zone. Empty = now (rounded down to the minute).
`country`	select (none, AT, AU, BE, CA, CH, DE, DK, ES, FR, GB, IE, IT, NL, PL, SE, US)	"none"	Public holidays. Holidays on weekdays are not counted as working days (data 2024–2030).
`subdivision`	text	—	Region (optional). ISO 3166-2 code such as DE-BY or US-CA for regional holidays.
`weekend`	select (sat-sun, fri-sat, sun, none)	"sat-sun"	Weekend days
`otherZones`	list	[]	Show the moment in these time zones. One IANA name per line.
`alarmMinutes`	integer	0	Reminder in the calendar file. 0 = no reminder.

Example request

Product launch in Berlin, German holidays, seen from New York and Tokyo

curl -X POST https://focusroomcountdown.usefulweb.app/api/v1/calculate -H 'content-type: application/json' -d '{"event":"custom","title":"Launch","target":"2027-03-15T09:00","zone":"Europe/Berlin","from":"2026-12-21T09:00","country":"DE","otherZones":["America/New_York","Asia/Tokyo"],"alarmMinutes":30}'

Every result contains

inputs (normalised, defaults applied), summary, result (validated against the published schema), units, assumptions, sources, warnings, computedAt and links.

MCP (Model Context Protocol)

Streamable HTTP endpoint: https://focusroomcountdown.usefulweb.app/mcp – protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake).
Tools: focusroom_countdown
Local stdio connector: node src/mcp-stdio.ts --tool=focusroom-countdown

{
  "mcpServers": {
    "focusroom-countdown": { "type": "http", "url": "https://focusroomcountdown.usefulweb.app/mcp" }
  }
}