aloc_search_questions
Search curriculum-aligned WAEC, JAMB, and NECO exam questions by subject, year, topic, or difficulty to build targeted practice sets and assessments.
Instructions
Search and retrieve curriculum-aligned examination questions (WAEC, JAMB, NECO) with options, metadata, and difficulty levels. Consumes 1-3 ALOC credits.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"subject": "<subject>"
},
"name": "aloc_search_questions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | No | Examination year (e.g. 2022) | |
| limit | No | Number of questions to return (max 15, default 5) | |
| topic | No | Topic filter (e.g. 'algebra', 'calculus', 'photosynthesis') | |
| subject | Yes | Subject name (e.g. 'mathematics', 'english', 'biology', 'physics', 'chemistry', 'economics') | |
| examType | No | Target African examination body | |
| difficulty | No | Difficulty score 1–5 (1=easy, 5=very hard) or alias ('easy', 'medium', 'hard') | |
| contentSource | No | Content provenance filter. Defaults to historical past questions; pass synthetic or all to explicitly include AI-generated questions. | historical |
| excludePassages | No | Exclude reading-passage comprehension items |