{"openapi":"3.1.0","info":{"title":"Collegeapp API","version":"0.1.0","description":"A fully local US college-application planning toolkit: a backward-planned application-timeline generator, a Common Application components checklist, and grade-by-grade (9th-12th) timeline guidance.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://collegeapp.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/collegeapp/docs"},"termsOfService":"https://connectorbay.com/collegeapp/terms"},"servers":[{"url":"https://collegeapp.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/collegeapp/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/application_timeline":{"post":{"operationId":"application_timeline","summary":"Backward-plans a real, date-computed college-application checklist from a target deadline: college-list","description":"Backward-plans a real, date-computed college-application checklist from a target deadline: college-list\n    finalization, last recommended test date, recommendation-letter request date, essay drafting/revision\n    milestones, activities-list finalization, FAFSA opening/recommended-submit dates, and an approximate\n    decision date. Use for \"build me a timeline for my Nov 1 ED deadline\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"deadline_type":{"description":"early_decision | early_action | regular_decision | rolling","title":"Deadline Type","type":"string"},"deadline_date":{"description":"The application deadline, ISO date (YYYY-MM-DD).","title":"Deadline Date","type":"string"},"today":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Override 'today' for planning purposes, ISO date. Defaults to the current date.","title":"Today"}},"required":["deadline_type","deadline_date"],"title":"application_timelineArguments","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/common_app_checklist":{"post":{"operationId":"common_app_checklist","summary":"The standard Common Application components checklist: personal essay, supplemental essays, transcript,","description":"The standard Common Application components checklist: personal essay, supplemental essays, transcript,\n    recommendation letters, test scores, activities list, additional information, fee/waiver, and mid-year/\n    final transcripts. Use for \"what do I need for the Common App\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"common_app_checklistArguments","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/timeline_by_grade":{"post":{"operationId":"timeline_by_grade","summary":"General year-by-year college-prep guidance for grades 9-12 — what a college-bound student should","description":"General year-by-year college-prep guidance for grades 9-12 — what a college-bound student should\n    generally focus on that year. Use for \"what should a sophomore be doing for college prep\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"grade":{"description":"High school grade: 9, 10, 11, or 12.","maximum":12,"minimum":9,"title":"Grade","type":"integer"}},"required":["grade"],"title":"timeline_by_gradeArguments","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}}}}