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

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.qzz.io/api",
        "MCP_DEFAULT_SUBJECT": "9618"
      }
    }
  }
}

Environment variables

• MCP_API_BASE (default: https://api.searchcaie.qzz.io/api)
• MCP_DEFAULT_SUBJECT (default: 9618)
• 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