Search past-paper questions with optional filters.

Returns ranked questions with compact metadata. Each result includes:

• Paper identification (paper, year, session, variant, paper_label)

• Question number, marks, relevance score

• Whether it's image-based (if so, question_image_url and ms_image_url are provided)

• topic_signal: exam frequency and importance summary

• question_url: link to full question page

NEXT STEP: Call get_questions(question_ids_list=[...]) with the recommended_ids to get full question text, mark scheme key points, and images.

Search multiple topics and deduplicate by question ID.

Accepts either topics (comma-separated string) or topics_list.

Fetch full question details and mark schemes for selected IDs.

Accepts either question_ids (comma-separated) or question_ids_list. Default detail is compact for LLM-friendly responses.

Returns for each question:

• Full question text and context

• Key mark scheme points (authoritative answers)

• Paper identification

• question_url: link to full question page

• Image URLs (question_image_url, ms_image_url) for image-based questions

Use include_images=True to get image URLs for ALL questions (not just image-based). Use include_ocr=True to get OCR text extracted from question images.

Get overall API statistics and service health.

Search Cambridge examiner report commentary for insights on how a topic is examined.

Returns examiner observations including:

• What examiners expect in answers on this topic

• Common mistakes candidates make

• Tips for how to structure answers to gain full marks

Use AFTER searching questions to understand examiner expectations on the same topic. Examiner reports are the most authoritative source for HOW to answer, not WHAT to answer.

Get educational web content to supplement CAIE exam explanations.

Returns summarized content from trusted CS education sites. Use when the student needs conceptual explanations beyond what mark schemes provide.

Web content is supplementary — always prioritize official CAIE mark scheme points first. Returns: source title, URL, domain, and key educational content (max 800 chars per source).

Find educational diagrams and illustrations for a CAIE topic.

Returns external web images (Wikipedia, GFG diagrams) — NOT past paper images. For actual question/mark scheme images, use get_questions with include_images=True.

Use this when:

• Student needs a visual explanation of a concept (e.g., "show me a binary tree diagram")

• Adding supplementary illustrations beyond what exam papers show

Returns: image URL, title, source domain.