{"openapi":"3.1.0","info":{"title":"Studyplanner API","version":"0.1.0","description":"A fully local exam-study-schedule generator: real backward-planned, difficulty-weighted, spaced day-by-day study schedules from an exam date and topic list.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://studyplanner.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/studyplanner/docs"},"termsOfService":"https://connectorbay.com/studyplanner/terms"},"servers":[{"url":"https://studyplanner.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/studyplanner/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/generate_study_schedule":{"post":{"operationId":"generate_study_schedule","summary":"Backward-plans a real, computed day-by-day study schedule from an exam date and a rated topic list:","description":"Backward-plans a real, computed day-by-day study schedule from an exam date and a rated topic list:\n    harder/less-familiar topics get measurably more sessions (largest-remainder apportionment), sessions are\n    interleaved round-robin across the available days to avoid massing one topic together, and the day before\n    the exam is reserved as a full-topic final review day. Use for \"build me a study schedule for my exam\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"exam_date":{"description":"The exam date, ISO date (YYYY-MM-DD).","title":"Exam Date","type":"string"},"topics":{"description":"List of {\"name\": str, \"familiarity\": 1-5} objects. familiarity: 1=least familiar/hardest, 5=most familiar/easiest. Defaults to 3 if omitted.","items":{"additionalProperties":true,"type":"object"},"title":"Topics","type":"array"},"today":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Override 'today' for planning purposes, ISO date. Defaults to the current date.","title":"Today"},"sessions_per_day":{"default":1,"description":"Study sessions to schedule per day (1-4). Default 1.","maximum":4,"minimum":1,"title":"Sessions Per Day","type":"integer"}},"required":["exam_date","topics"],"title":"generate_study_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}}}}