ALOC Model Context Protocol (MCP) Server
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| X-API-Key | No | Your ALOC API key used as the X-API-Key header when connecting to the hosted Streamable HTTP gateway. | |
| ALOC_API_KEY | No | Your ALOC API key used for stdio authentication. | |
| ALOC_AGENT_FRAMEWORK | No | Optional agent framework identifier, e.g. cursor. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
| prompts | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| aloc_get_platform_overviewA | Discover ALOC assessment infrastructure overview, supported African exam bodies (WAEC, JAMB, NECO, Post-UTME), subject list, year coverage (1988–2026), and API layers. Free (0 credits). |
| aloc_get_coverage_matrixA | Retrieve live examination, subject, and paper-year availability across JAMB, WAEC, NECO, and Post-UTME before querying questions. Free (0 credits). |
| aloc_get_sitemapA | Get complete navigation sitemap and direct links to ALOC developer portal, documentation, and error code guides. Free (0 credits). |
| aloc_get_subject_yearsA | List all available examination years for a specific subject and exam body. Free (0 credits). |
| aloc_check_credit_balanceA | Check the developer's remaining ALOC API credit balance and authentication status. Free (0 credits). |
| aloc_search_questionsB | Search and retrieve curriculum-aligned examination questions (WAEC, JAMB, NECO) with options, metadata, and difficulty levels. Consumes 1-3 ALOC credits. |
| aloc_get_question_explanationA | Retrieve step-by-step breakdown, remedial hints, and AI-generated conceptual explanations for a specific question. Consumes 10 ALOC credits. |
| aloc_get_curriculum_taxonomyC | Retrieve official African examination curriculum structure, subject breakdown, and topic hierarchy. |
| aloc_find_similar_questionsA | Find conceptually similar or variant examination questions using semantic vector similarity. Consumes 10 ALOC credits. |
| aloc_report_question_issueA | Report a typo, incorrect answer key, or ambiguity on a specific question to ALOC quality moderation. Free (0 credits). |
| aloc_generate_assessmentB | Assemble a psychometrically balanced examination paper based on syllabus presets (JAMB 40, WAEC 50, Micro 10) or custom Bloom difficulty distributions, topics, and seeds. Consumes 5 ALOC credits. |
| aloc_create_assessment_sessionA | Initialize a timed candidate assessment session (2-hour lifecycle) for secure, cheat-resistant live test delivery. Consumes 5 ALOC credits. |
| aloc_get_session_questionsA | Retrieve questions allocated to an active candidate assessment session. Free (0 credits — active session reconnect). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| aloc_socratic_tutor | Enacts an adaptive Socratic tutor for African curriculum exams (JAMB, WAEC, NECO). Queries questions via ALOC tools and provides progressive hints without spoiling answers. |
| aloc_exam_revision_planner | Analyzes curriculum topic weightings and difficulty scores to compile a structured, multi-week study and mock testing timetable. |
| aloc_bloom_evaluator | Evaluates candidate responses, diagnoses cognitive levels (Bloom's Taxonomy), and maps common distractors to underlying misconceptions. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 13 tools
Core actions are clearly distinct: searching questions, explaining a question, finding similar questions, generating a paper, and managing a session are easy to tell apart. The only fuzzy zone is the discovery/metadata cluster (platform_overview, coverage_matrix, subject_years, curriculum_taxonomy, sitemap), where coverage_matrix vs subject_years and overview vs sitemap could be confused at a glance, though descriptions do disambiguate them.
Every tool uses the same aloc_ prefix followed by a verb_noun snake_case name (get_, create_, search_, find_, generate_, report_, check_). Verb choice matches the operation type consistently, so an agent can predict names.
13 tools sits squarely in the well-scoped range for an exam content API, with each tool mapping to a distinct capability layer (discovery, retrieval, generation, session, billing, feedback). Nothing looks padded or missing purely on count grounds.
The question-retrieval, explanation, similarity, generation, and discovery surfaces are well covered, but the assessment session lifecycle is a dead end: you can create a session and fetch its questions, yet there is no submit/complete/expire session or retrieve results/grading tool. A direct get-question-by-id fetch is also only implicitly reachable via search.