Mock Mentor

Read the authenticated student's completed mock report for the quiz view.

get_take_my_mock_result

Call before creating or revising a study plan. Returns the primary exam, onboarding guidance, recent mock performance, a bounded set of vital memories, and up to seven active-plan days by default. Use dayCursor from daysPage.nextCursor to retrieve additional task IDs before revising later days.

get_study_plan_insights

Call when the student asks what to study today. Returns the active plan tasks scheduled for their supplied local date, or the server date when omitted.

get_todays_study_tasks

Use this after who_am_i when the student wants their referral link, or after get_referral_status for a locked feature. Returns the existing link or creates one if missing; it never sends an invitation or qualifies a referral.

get_or_create_referral_link

Use this after who_am_i when the student asks about referrals or a requested feature is locked. Returns qualified and pending counts, feature access, the next unlock, and any existing referral link; it never creates one.

get_referral_status

Call once after checking every submitted answer against the retained answer key. The result count must match the requested question count. Saves the completed attempt and learning memories and returns the report for the existing quiz view. May qualify an existing referral and unlock the referrer's features. Updates activity and rewards and may reverse an existing conversation bonus, subtracting its points from leaderboard totals. Do not repeat its per-question review in conversational text.

grade_take_my_mock

Call after who_am_i and before checking a student-supplied answer. Pass only the inferred question type, topic, and any explicitly supplied attempt or year—never the question, answer, options, or uploaded content. Returns current exam context and verification rules; it does not decide correctness or save the review. Syllabus results are scoped and paginated; use syllabusPage.nextCursor with unchanged inputs or clarify unmatched labels. Example: {questionType: "multiple_choice", topic: "Algebra"}.

prepare_check_my_answer

Call after who_am_i before evaluating an external mock, scorecard, OMR sheet, answer sheet, or report. Pass only its general type, subject or paper, and any explicitly supplied attempt or year—never raw file contents, extracted scores, registration details, or answers. Returns current exam rules, syllabus hierarchy, scoring guidance, available rubrics, verified sources, and evidence limits for ChatGPT's evaluation. Syllabus results are scoped and paginated; use syllabusPage.nextCursor with unchanged inputs or clarify unmatched labels. Example: {reportType: "section_summary", subjectOrPaper: "Statistics"}.

prepare_evaluate_my_mock

Call after who_am_i and before searching the web for study material. Supply the requested topic and only an exam, attempt, year, or resource types explicitly requested by the student. Omit requestedExam for the student's primary exam. Returns the matching published exam guidance, syllabus, official source metadata, and web-research rules; it does not search the internet itself. Syllabus results are scoped and paginated; use syllabusPage.nextCursor with unchanged inputs or clarify unmatched labels. Example: {topic: "Probability", resourceTypes: ["official_material", "video"]}.

prepare_study_material

Use this after who_am_i and topic selection to start Take My Mock. Pass the student's requested positive whole-number questionCount; omit it to default to 10. Returns the student's primary exam, language, syllabus topics, and generation rules; it does not save an attempt.

prepare_take_my_mock