{"openapi":"3.1.0","info":{"title":"CollegeFund API","version":"0.1.0","description":"A US 529/education-savings calculator: a compound-growth-with-inflation college cost projection, a required-monthly-contribution reverse calculator and matching forward projection, a 529 plan basics reference, and a glossary — all local.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://collegefund.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/collegefund/docs"},"termsOfService":"https://connectorbay.com/collegefund/terms"},"servers":[{"url":"https://collegefund.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/collegefund/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/college_cost_projection":{"post":{"operationId":"college_cost_projection","summary":"Compound-growth-with-inflation projection of college cost for each enrollment year, plus a total. Use","description":"Compound-growth-with-inflation projection of college cost for each enrollment year, plus a total. Use\n    for \"what will a $30,000/year college cost in 10 years, over a 4-year degree\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"current_annual_cost":{"description":"Today's annual cost (tuition + fees, or full cost of attendance) at the school in question.","exclusiveMinimum":0,"title":"Current Annual Cost","type":"number"},"years_until_enrollment":{"description":"Years from now until the student enrolls.","minimum":0,"title":"Years Until Enrollment","type":"number"},"inflation_rate_pct":{"default":5.0,"description":"Assumed annual college-cost inflation rate, %. Defaults to 5% (College Board long-run historical average).","title":"Inflation Rate Pct","type":"number"},"years_of_enrollment":{"default":4,"description":"How many enrollment years to project (each one further inflated), e.g. 4 for a bachelor's degree.","maximum":10,"minimum":1,"title":"Years Of Enrollment","type":"integer"}},"required":["current_annual_cost","years_until_enrollment"],"title":"college_cost_projectionArguments","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/required_monthly_contribution":{"post":{"operationId":"required_monthly_contribution","summary":"Reverse calculator: the flat monthly contribution needed to reach a target by a given date, given","description":"Reverse calculator: the flat monthly contribution needed to reach a target by a given date, given\n    current savings and an assumed return — real ordinary-annuity math. Use for \"how much do I need to save\n    monthly for $200,000 in 15 years starting from $10,000\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"target_amount":{"description":"The savings target (e.g. from college_cost_projection's total_projected_cost).","exclusiveMinimum":0,"title":"Target Amount","type":"number"},"years_until_enrollment":{"description":"Years from now until the money is needed.","exclusiveMinimum":0,"title":"Years Until Enrollment","type":"number"},"current_savings":{"default":0.0,"minimum":0,"title":"Current Savings","type":"number"},"expected_annual_return_pct":{"default":6.0,"description":"Expected annual investment return, %. Defaults to 6%.","title":"Expected Annual Return Pct","type":"number"}},"required":["target_amount","years_until_enrollment"],"title":"required_monthly_contributionArguments","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/college_savings_projection":{"post":{"operationId":"college_savings_projection","summary":"Forward projection of a 529 balance given current savings, a monthly contribution, and an assumed","description":"Forward projection of a 529 balance given current savings, a monthly contribution, and an assumed\n    return, with a yearly schedule — uses the same ordinary-annuity math as required_monthly_contribution, so\n    the two are consistent. Use for \"what will $10,000 now plus $300/month at 6% grow to in 15 years\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"current_savings":{"minimum":0,"title":"Current Savings","type":"number"},"monthly_contribution":{"minimum":0,"title":"Monthly Contribution","type":"number"},"years_until_enrollment":{"exclusiveMinimum":0,"title":"Years Until Enrollment","type":"number"},"expected_annual_return_pct":{"default":6.0,"description":"Expected annual investment return, %. Defaults to 6%.","title":"Expected Annual Return Pct","type":"number"}},"required":["current_savings","monthly_contribution","years_until_enrollment"],"title":"college_savings_projectionArguments","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/plan_529_basics":{"post":{"operationId":"plan_529_basics","summary":"A 529 plan reference: federal tax treatment, the federal annual gift tax exclusion and 5-year","description":"A 529 plan reference: federal tax treatment, the federal annual gift tax exclusion and 5-year\n    superfunding election (contribution limits themselves are state-specific and flagged, not guessed),\n    qualified expenses (including 2026's expanded K-12 limit and new credentialing expenses), the 529-to-Roth\n    IRA rollover, and FAFSA financial-aid impact. Use for \"what happens if I withdraw 529 money for something\n    else\", \"how does a 529 affect financial aid\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"plan_529_basicsArguments","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/collegefund_glossary":{"post":{"operationId":"collegefund_glossary","summary":"Definitions of common 529/education-savings terms (qualified expenses, superfunding, Student Aid Index,","description":"Definitions of common 529/education-savings terms (qualified expenses, superfunding, Student Aid Index,\n    529-to-Roth rollover, ...). Use for \"what's superfunding\", \"what's the Student Aid Index\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific term to look up; omit to list all.","title":"Term"}},"title":"collegefund_glossaryArguments","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}}}}