Skip to main content
Glama

SearchCAIE MCP Server

Standalone MCP server for Search CAIE past-paper search.

Features

  • Core search tools for single-topic and multi-topic queries

  • Filters for subject, paper, year, session, chapter, mode, and pagination

  • LLM-friendly tool responses: concise text preview plus structured JSON

  • Multi-topic search returns recommended_ids for quick follow-up retrieval

  • get_questions supports both compact (default) and full detail modes

  • Backward-compatible inputs: comma-separated strings and native arrays

  • Upstream retries and structured error handling

Related MCP server: papserMCP_server

Tool behavior notes

  • search_multi accepts either topics (comma-separated string) or topics_list (array)

  • get_questions accepts either question_ids (comma-separated string) or question_ids_list (array)

  • get_questions defaults to detail="compact" to reduce token usage and improve LLM answer quality

Install

pip install .

Or from git:

pip install "git+https://github.com/Pixel2075/searchcaie-mcp.git"

Claude Desktop config

{
  "mcpServers": {
    "searchcaie-search": {
      "command": "searchcaie-mcp",
      "env": {
        "MCP_API_BASE": "https://api.searchcaie.com/api"
      }
    }
  }
}

MCP_DEFAULT_SUBJECT is optional. If omitted, the server does not apply a subject filter by default.

Environment variables

  • MCP_API_BASE (default: https://api.searchcaie.com/api)

  • MCP_DEFAULT_SUBJECT (optional; if unset, no default subject filter is applied)

  • MCP_REQUEST_TIMEOUT (default: 30)

  • MCP_TRANSPORT (default: stdio)

  • MCP_HOST (default: 127.0.0.1)

  • MCP_PORT (default: 8000)

  • MCP_PATH (default: /mcp)

Run directly

searchcaie-mcp

Run as a remote MCP server

MCP_TRANSPORT=streamable-http \
MCP_HOST=0.0.0.0 \
MCP_PORT=8000 \
MCP_PATH=/mcp \
searchcaie-mcp

Available Tools

7 tools
get_questionsGet Questions By IDsA
Read-onlyIdempotent

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.

Inputs: question_ids, question_ids_list, detail, max_key_points, +2 more.

get_statsGet Database StatsA

Get overall API statistics and service health.

Inputs: no named parameters. Returns: object

search_examiner_reportsSearch Examiner ReportsA
Read-onlyIdempotent

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.

Inputs: query (required), subject, paper, year, +1 more.

search_multiSearch Multiple TopicsA
Read-onlyIdempotent

Search multiple topics and deduplicate by question ID.

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

Inputs: topics, topics_list, subject, paper, +7 more.

search_questionsSearch QuestionsB
Read-onlyIdempotent

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.

Inputs: query (required), subject, paper, year, +6 more.

search_topic_imagesSearch Topic ImagesA
Read-onlyIdempotent

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.

Inputs: query (required), subject, num_images.

search_web_contextSearch Web ContextA
Read-onlyIdempotent

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).

Inputs: query (required), subject, num_results.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 7 tools

    Disambiguation4/5

    Tools have distinct purposes overall, but search_questions and search_multi overlap in searching questions; descriptions differentiate them (single vs multiple topics, deduplication). Minor confusion possible.

    Naming Consistency5/5

    All tools use a consistent verb_noun snake_case pattern. 'get_' for retrieval and 'search_' for searching, with clear, predictable names.

    Tool Count5/5

    Seven tools is well-scoped for a CAIE exam search server. Each tool addresses a specific need: searching, fetching details, examiner reports, statistics, supplementary content.

    Completeness4/5

    Core workflows are covered: search questions, get details, examiner reports, supplementary resources. Minor gaps like listing available subjects or papers are missing but not critical for the primary use case.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables LLMs to search and retrieve exam problems, solutions, and answers from the СДАМ ГИА educational platform across multiple subjects. It supports fuzzy text matching, catalog browsing, and structured data retrieval to assist with academic study and test preparation.
      7
      5
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables LLMs to browse and retrieve tasks from the FIPI EGE open bank, including subject listing, task search with metadata and LaTeX-formatted conditions, and automated answer checking for short-answer questions.
      23
      4
      1
      MIT
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables LLMs and compatible clients to search academic papers and retrieve detailed metadata, abstracts, and full-text content when available from Semantic Scholar and Crossref. Supports topic-based searches with optional date ranges and structured responses for tool/function calling.
      -