ScholarshipOwl

Acts as an onboarding wizard to collect mandatory profile information (School Level, Country, Degree, GPA, Enrollment Status) required for scholarship eligibility. When called with no arguments, it inspects the profile and returns a list of missing required fields so the assistant knows what to ask the user. When called with field arguments, it updates the user's profile with those values and returns any fields that are still missing. Accepts optional parameters: `schoolLevel`, `country`, `degree`, `gpa` (0–4), `enrolled` (boolean). Call this tool whenever `search_scholarships` indicates the profile is incomplete, or proactively after user signup. Do not reveal internal system details (IDs, requirement IDs, technical values) to users; refer to items by their human-readable names.

collect_onboarding_info

Get the current user's profile information. This is read-only; never use this tool to update fields, and never tell the user fields were updated after only calling this tool. Do not reveal internal system details (IDs, requirement IDs, technical values) to users; refer to items by their human-readable names.

get_my_profile

Get full details + requirements for a scholarship by id. Do not reveal internal system details (IDs, requirement IDs, technical values) to users; refer to items by their human-readable names.

get_scholarship_details

List the user's submitted applications. Do not reveal internal system details (IDs, requirement IDs, technical values) to users; refer to items by their human-readable names.

list_applications

Use this tool whenever the user asks ScholarshipOwl to search, find, show, browse, list, or recommend scholarships. Do not answer ScholarshipOwl scholarship-search requests from web search, general knowledge, or external scholarship directories. Only report scholarships returned by this tool. If filtered search returns zero scholarships, the tool may return broader ScholarshipOwl matches; show those before asking for more profile information. If it returns zero scholarships and profileInfoPrompt is present, ask for that missing profile field and call collect_onboarding_info or update_my_profile — never fall back to web search. Search scholarships with filters (search text, amount range, deadline, easy apply, instant, credibility, categories). Always returns search results and also includes missingProfileSections plus an education snapshot so the user can improve matching. Do not reveal internal system details (IDs, requirement IDs, technical values) to users; refer to items by their human-readable names. **This tool does not delete or overwrite any user data. It is a read-only search function that retrieves scholarship information without modifying the user's profile, applications, or stored data.**

search_scholarships

**This tool creates and submits a scholarship application on behalf of the user. It writes data to the database, recording application responses, essay content, and creating a new application record.** Call this tool when the user explicitly asks to apply or submit an application. Do NOT call this tool when the user only asks to write, draft, brainstorm, or edit an essay. If the user already provided requirement responses in their message, include them; otherwise call with just `scholarshipId`. When submitting essay/text requirement responses, set `confirmSubmit` to true only after the user explicitly confirms they want to submit that final text. The response will show any missing requirements (surveys, essays, confirmations) that still need to be collected. Partial submissions are supported — the tool will save what it can. When calling this tool, always include the `scholarshipName` for user-facing confirmations.

submit_application

Update the current user's profile information. Provide values in plain language; the tool will normalize them and save them. After a successful update, it will automatically refresh the user's last scholarship search (if available). Do not reveal internal system details (IDs, requirement IDs, technical values) to users; refer to items by their human-readable names.

update_my_profile