{"openapi":"3.1.0","info":{"title":"Scholarshipsearch API","version":"0.1.0","description":"A fully local scholarship-search STRATEGY and methodology guide (NOT a live scholarship database): a strategy framework, an application-capacity calculator, an essay-prompt-types reference, and a scholarship-scam red-flags checklist.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://scholarshipsearch.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/scholarshipsearch/docs"},"termsOfService":"https://connectorbay.com/scholarshipsearch/terms"},"servers":[{"url":"https://scholarshipsearch.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/scholarshipsearch/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/strategy_framework":{"post":{"operationId":"strategy_framework","summary":"Where to actually look for scholarships — school counselor, local/community organizations, employer,","description":"Where to actually look for scholarships — school counselor, local/community organizations, employer,\n    major- or background-specific awards, national databases, and institutional aid — with real\n    competitiveness and typical-award-size tradeoffs for each tier. NOT a live scholarship listing. Use for\n    \"how should I search for scholarships\", \"where do I find scholarships besides the big national sites\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"strategy_frameworkArguments","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/application_capacity_calculator":{"post":{"operationId":"application_capacity_calculator","summary":"Computes a real, arithmetic estimate of how many scholarship applications are realistically achievable","description":"Computes a real, arithmetic estimate of how many scholarship applications are realistically achievable\n    given hours per week and weeks available, plus a breakdown across light/standard/heavy effort tiers for\n    comparison. Use for \"how many scholarships can I apply to with 5 hours a week for 2 months\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"hours_per_week":{"description":"Hours per week you can realistically spend on scholarship applications.","exclusiveMinimum":0,"title":"Hours Per Week","type":"number"},"weeks_available":{"description":"Number of weeks available before your target deadline(s).","exclusiveMinimum":0,"title":"Weeks Available","type":"number"},"effort_level":{"default":"standard","description":"light | standard | heavy — typical effort per application. Ignored if avg_hours_per_application is given.","title":"Effort Level","type":"string"},"avg_hours_per_application":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Override: your own estimated average hours per application, instead of a named effort_level.","title":"Avg Hours Per Application"}},"required":["hours_per_week","weeks_available"],"title":"application_capacity_calculatorArguments","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/essay_prompt_types":{"post":{"operationId":"essay_prompt_types","summary":"A hand-curated reference of common underlying scholarship-essay prompt categories (financial need,","description":"A hand-curated reference of common underlying scholarship-essay prompt categories (financial need,\n    career goals, overcoming a challenge, community impact, leadership, diversity/perspective, field-of-study\n    interest, role model) with a tip for each. Use for \"what are common scholarship essay topics\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"essay_prompt_typesArguments","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/scam_red_flags":{"post":{"operationId":"scam_red_flags","summary":"A hand-curated, important checklist of scholarship-scam warning signs — paying to apply, being told you","description":"A hand-curated, important checklist of scholarship-scam warning signs — paying to apply, being told you\n    won something you never entered, high-pressure urgency, requests for bank/SSN info, and more — with what to\n    do about each. Use for \"is this scholarship offer a scam\", \"how do I spot a fake scholarship\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"scam_red_flagsArguments","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}}}}