API & MCP

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

HTTP API

• GET https://focusroom.usefulweb.app/api/v1/tools – catalog
• GET https://focusroom.usefulweb.app/api/v1/tools/{id} – inputs, output schema, examples
• POST https://focusroom.usefulweb.app/api/v1/tools/{id}/calculate – run a tool
• GET https://focusroom.usefulweb.app/api/v1/workflows · POST https://focusroom.usefulweb.app/api/v1/workflows/{id}/run
• OpenAPI 3.1: /openapi.json · /openapi.yaml
• Errors: application/problem+json; 422 includes per-field errors.

Tools on Focus Room

• Focus Room Playlist Renderer – Mix a playlist of generated ambience scenes with crossfades and master effects into a WAV. focusroom_playlist_render
• Focus Room Focus Timer Planner – Plan Pomodoro, 52/17 or custom focus blocks and export them as a calendar file. focusroom_focus_timer
• Ambience Generator (rain, wind, stream, fire, hum, drone) – Synthesize rain, wind, water, fire, room hum or a drone as a seamless-loop WAV. soundscape_ambience_generator
• Noise Generator (white, pink, brown) – Make white, pink, brown, blue or violet noise as a WAV file and check its spectrum. soundscape_noise_generator
• Room Reverb for WAV Files – Add room, hall, cathedral or cave reverb to a WAV file with a known reverberation time. soundscape_reverb

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://focusroom.usefulweb.app/mcp – protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake).
• Tools: focusroom_playlist_render, focusroom_focus_timer, soundscape_ambience_generator, soundscape_noise_generator, soundscape_reverb
• Local stdio connector: node src/mcp-stdio.ts

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