SearchCAIE MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@SearchCAIE MCP Server find questions on 'data representation' for 9618 paper 1 from 2021"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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_idsfor quick follow-up retrievalget_questionssupports bothcompact(default) andfulldetail modesBackward-compatible inputs: comma-separated strings and native arrays
Upstream retries and structured error handling
Related MCP server: papserMCP_server
Tool behavior notes
search_multiaccepts eithertopics(comma-separated string) ortopics_list(array)get_questionsaccepts eitherquestion_ids(comma-separated string) orquestion_ids_list(array)get_questionsdefaults todetail="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-mcpRun as a remote MCP server
MCP_TRANSPORT=streamable-http \
MCP_HOST=0.0.0.0 \
MCP_PORT=8000 \
MCP_PATH=/mcp \
searchcaie-mcpAvailable Tools
7 toolsget_questionsGet Questions By IDsARead-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 ReportsARead-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 TopicsARead-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 QuestionsBRead-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 ImagesARead-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 ContextARead-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
Scored across 7 tools
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.
All tools use a consistent verb_noun snake_case pattern. 'get_' for retrieval and 'search_' for searching, with clear, predictable names.
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.
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
Related MCP Connectors
UK exam-board spec data: which paper is a topic on, spec structures, past-paper links. Verified.
Create AI-generated exam questions and save them to your paperee question bank for review.
Search university course materials, your flashcards, quizzes, streak and quota. All tools read-only.
Search Turkish curriculum topic notes (LGS, YKS, grades 5-12) and fetch them as Markdown.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables 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.75MIT
- AlicenseBqualityDmaintenanceEnables AI assistants to search and retrieve CodeChef VIT university question papers from MongoDB, offering tools for paper search, metadata retrieval, and recent paper feeds.2ISC
- AlicenseAqualityCmaintenanceEnables 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.2341MIT
- FlicenseNot gradedqualityAmaintenanceEnables 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.-