ALOC Model Context Protocol (MCP) Server
OfficialClick 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., "@ALOC Model Context Protocol (MCP) Server create a 20-question JAMB biology assessment on genetics and evolution"
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.
ALOC Model Context Protocol (MCP) Server
Official Model Context Protocol (MCP) server for ALOC Station (@massteck/aloc-mcp-server) — providing verified, deduplicated African educational examination content (WAEC, JAMB UTME, NECO, Post-UTME), structured curriculum trees, Bloom difficulty ratings, step-by-step derivations, and cheat-resistant exam session assembly to AI agents and IDEs (Claude Desktop, Cursor, Windsurf, VS Code Copilot, LangChain, and custom AI tutors).
Features & Tools (12 Tools)
Tool | Category | Credits | Description |
| Discovery | 0 credits | Discover supported African exam bodies (WAEC, JAMB, NECO, Post-UTME), subjects, year coverage, and API layer rules. |
| Discovery | 0 credits | Direct URLs to developer portal, documentation, and error guides. |
| Discovery | 0 credits | Available examination years for a specific subject & body. |
| Account | 0 credits | Check remaining API credit balance & authentication status. |
| Content | 1–3 credits | Search curriculum-aligned examination questions with options, topics, and difficulty ( |
| Assessment | 5 credits | Assemble psychometrically balanced examination papers based on presets, topics, and deterministic seeds. |
| Assessment | 5 credits | Initialize a timed candidate test session (2-hour lifecycle) for cheat-resistant delivery. |
| Assessment | 0 credits | Retrieve questions allocated to an active candidate assessment session (free reconnect). |
| Learning | 10 credits | Retrieve step-by-step solutions, misconception traps, and remedial hints. |
| Curriculum | Free/3 credits | Explore the topic taxonomy and syllabus hierarchy. |
| Intelligence | 10 credits | Find |
| Quality | 0 credits | Report a typo or disputed answer key to ALOC's 24h Maker-Checker moderation queue. |
Related MCP server: Examplary MCP Server
Standard MCP Prompts
In addition to tools, the server registers standard pedagogical prompt templates:
Prompt | Target Domain | Description |
| Socratic Pedagogy | Guides LLMs to retrieve questions and provide progressive hints without spoiling answers. |
| Curriculum Planning | Analyzes syllabus topic hierarchies and Bloom difficulty to compile structured study timetables. |
| Psychometrics | Evaluates cognitive complexity and diagnoses underlying student misconceptions. |
Quickstart & Installation
Obtain a free API key (1,000 monthly credits included) at aloc.com.ng/register.
Option A: Zero-Install Hosted Streamable HTTP Gateway (Recommended)
Connect directly to ALOC's hosted MCP endpoint (https://aloc.com.ng/mcp/v1) in Claude Desktop, Cursor, or any Streamable HTTP MCP client without installing Node packages locally:
{
"mcpServers": {
"aloc": {
"url": "https://aloc.com.ng/mcp/v1",
"headers": {
"X-API-Key": "aloc_live_your_api_key_here"
}
}
}
}Option B: 1-Click Install via Smithery.ai (Claude Desktop)
npx -y @smithery/cli install massteck/aloc --client claudeOption C: Local Node.js Stdio (npx / npm)
1. Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"aloc": {
"command": "npx",
"args": ["-y", "@massteck/aloc-mcp-server"],
"env": {
"ALOC_API_KEY": "aloc_live_your_api_key_here"
}
}
}
}2. Cursor IDE (.cursor/mcp.json)
{
"mcpServers": {
"aloc": {
"command": "npx",
"args": ["-y", "@massteck/aloc-mcp-server"],
"env": {
"ALOC_API_KEY": "aloc_live_your_api_key_here",
"ALOC_AGENT_FRAMEWORK": "cursor"
}
}
}
}Cursor IDE Integration (.cursorrules)
Drop a .cursorrules file into your project root when building EdTech applications on ALOC:
# .cursorrules — ALOC Assessment Infrastructure Assistant
You are an expert full-stack EdTech engineer building on ALOC Station (https://aloc.com.ng).
## Best Practices
1. Assessment Generation: Use 'aloc_generate_assessment' with official presets ('jamb_standard_40', 'waec_standard_50', 'micro_test_10') instead of raw single-question loops.
2. Anti-Cheating: Always pass 'shuffleOptions: true' and unique deterministic seeds ('seed') when creating candidate sitting mock tests.
3. Socratic Tutoring: When helping students, use 'aloc_get_question_explanation' to extract misconception hints rather than immediately revealing correct answer keys.Authentication, Quality Telemetry & Licensing
API Key Security: Authenticate via
ALOC_API_KEY(stdio) orX-API-Keyheader (Streamable HTTP).Transparent Metering: Discovery tools and active session reconnects consume 0 credits; question search consumes 1–3 credits; paper/session assembly consumes 5 credits; L3/L4 explanations and similarity consume 10 credits.
Live Data Quality Audit: Inspect live question counts, deduplication guarantees, and syllabus alignment telemetry anytime at aloc.com.ng/data-quality.
License: Client wrapper code is released under the MIT License. Examination datasets and API responses are governed by the ALOC Terms of Service.
Documentation & Links
📖 MCP Documentation: https://aloc.com.ng/docs/mcp
🐍 Python & TypeScript SDKs: https://aloc.com.ng/docs/sdks
📊 20-Year Syllabus Benchmarks: https://aloc.com.ng/benchmarks
🎮 Interactive API Playground: https://aloc.com.ng/playground
📧 API Support: api@aloc.com.ng
Available Tools
13 toolsaloc_check_credit_balanceA
Check the developer's remaining ALOC API credit balance and authentication status. Free (0 credits).
Inputs: no named parameters.
aloc_create_assessment_sessionA
Initialize a timed candidate assessment session (2-hour lifecycle) for secure, cheat-resistant live test delivery. Consumes 5 ALOC credits.
Inputs: subject (required), examType (required), seed, count, +3 more.
aloc_find_similar_questionsA
Find conceptually similar or variant examination questions using semantic vector similarity. Consumes 10 ALOC credits.
Inputs: questionId (required), limit.
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.
Inputs: subject (required), examType (required), seed, count, +4 more.
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).
Inputs: no named parameters.
aloc_get_curriculum_taxonomyC
Retrieve official African examination curriculum structure, subject breakdown, and topic hierarchy.
Inputs: subject, examType.
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).
Inputs: no named parameters.
aloc_get_question_explanationA
Retrieve step-by-step breakdown, remedial hints, and AI-generated conceptual explanations for a specific question. Consumes 10 ALOC credits.
Inputs: questionId (required), depth.
aloc_get_session_questionsA
Retrieve questions allocated to an active candidate assessment session. Free (0 credits — active session reconnect).
Inputs: sessionId (required).
aloc_get_sitemapA
Get complete navigation sitemap and direct links to ALOC developer portal, documentation, and error code guides. Free (0 credits).
Inputs: no named parameters.
aloc_get_subject_yearsA
List all available examination years for a specific subject and exam body. Free (0 credits).
Inputs: subject (required), examType.
aloc_report_question_issueA
Report a typo, incorrect answer key, or ambiguity on a specific question to ALOC quality moderation. Free (0 credits).
Inputs: type (required), message (required), questionId (required), reporterName.
aloc_search_questionsB
Search and retrieve curriculum-aligned examination questions (WAEC, JAMB, NECO) with options, metadata, and difficulty levels. Consumes 1-3 ALOC credits.
Inputs: subject (required), year, limit, topic, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
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.
Maintenance
Related MCP Connectors
Curated knowledge API for AI agents - skill packs, semantic search, validated patterns.
Nigerian phone, bank-account and identity-number validation for AI agents. Pay-per-call in USDC.
Connect your AI agent to 300+ methods and 100+ live tools
Discover, compare, and monitor 1,400+ APIs directly from your AI coding agent.
Related MCP Servers
AlicenseBqualityBmaintenanceEnables AI assistants to interact with the EduBase educational platform to create quizzes, upload questions, schedule exams, manage educational content, and analyze user results through natural language.153996 npm28MIT- AlicenseCqualityCmaintenanceProvides AI assistants with access to Examplary's exam management platform, enabling users to create and manage exams, generate questions from materials, grade student responses, and collaborate in workspaces through 60+ API endpoints.1001MIT
- FlicenseNot gradedqualityAmaintenanceEnables AI models, educational applications, smart hardware, and teaching agents to interconnect and share data and context through a standardized protocol. Supports generating personalized stories, quizzes, and multimedia learning content, with age-appropriate filtering, multi-language output, and asynchronous task processing.-
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to programmatically create, validate, store, and hot-swap interactive quizzes and study bundles into a desktop learning application, with analytics and local REST integration.MIT