{"openapi":"3.1.0","info":{"title":"ScreenTime API","version":"0.1.0","description":"Screen-time breakdown analysis, a gradual reduction-schedule calculator, and a digital-wellbeing tips reference — all local.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://screentime.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/screentime/docs"},"termsOfService":"https://connectorbay.com/screentime/terms"},"servers":[{"url":"https://screentime.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/screentime/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/breakdown_analysis":{"post":{"operationId":"breakdown_analysis","summary":"Real percentage breakdown of self-reported screen time by category, compared against approximate,","description":"Real percentage breakdown of self-reported screen time by category, compared against approximate,\n    commonly cited general benchmarks. Use for \"how does my screen time compare to average\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"categories":{"additionalProperties":{"type":"number"},"description":"Minutes per day by category, e.g. {'social_media': 120, 'work': 300, 'entertainment': 90}.","title":"Categories","type":"object"}},"required":["categories"],"title":"breakdown_analysisArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/reduction_schedule":{"post":{"operationId":"reduction_schedule","summary":"A real week-by-week gradual reduction schedule (equal linear step-down, landing exactly on the target by","description":"A real week-by-week gradual reduction schedule (equal linear step-down, landing exactly on the target by\n    the final week) — not an abrupt cutoff. Use for \"help me cut my screen time by 30% over 6 weeks\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"current_total_minutes":{"description":"Current total screen time, in minutes per day.","exclusiveMinimum":0,"title":"Current Total Minutes","type":"number"},"target_reduction_pct":{"description":"Target reduction, as a percent of the current total (e.g. 30 for a 30% cut).","exclusiveMinimum":0,"maximum":100,"title":"Target Reduction Pct","type":"number"},"weeks":{"description":"Number of weeks to phase the reduction in over.","maximum":52,"minimum":1,"title":"Weeks","type":"integer"}},"required":["current_total_minutes","target_reduction_pct","weeks"],"title":"reduction_scheduleArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/wellbeing_tips":{"post":{"operationId":"wellbeing_tips","summary":"Concrete digital-wellbeing tips by category. Use for \"tips for fewer notifications\", \"how do I build in","description":"Concrete digital-wellbeing tips by category. Use for \"tips for fewer notifications\", \"how do I build in\n    screen-free time\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"notifications | app_limits | screen_free_blocks | sleep_bedtime | mindful_use. Omit for all categories.","title":"Category"}},"title":"wellbeing_tipsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}