collect_onboarding_info
ChatGPTActs 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.
get_my_profile
ChatGPTGet the current user's profile information. Do not reveal internal system details (IDs, requirement IDs, technical values) to users; refer to items by their human-readable names.
get_scholarship_details
ChatGPTGet 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.
list_applications
ChatGPTList 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.
search_scholarships
ChatGPTSearch 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.
submit_application
ChatGPTThis 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. IMPORTANT: Call this tool immediately when asked to apply — do NOT ask the user for requirements first. If the user already provided requirement responses in their message, include them; otherwise call with just scholarshipId. 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.
update_my_profile
ChatGPTUpdate 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.
