EduBase

Implements the Model Context Protocol (MCP) as a standardized bridge layer that translates MCP client requests into EduBase REST API calls, exposing over 160 educational platform operations through a unified tool registry with naming convention edubase_<method>_<endpoint>. The server uses @modelcontextprotocol/sdk v1.12.3 for protocol compliance and maintains bidirectional communication between AI assistants and the EduBase backend.

Manages atomic educational questions through 8 dedicated tools (edubase_get_question, edubase_post_question, etc.) that support parametrization for infinite question variations, multiple question types (TEXT, CHOICE, NUMERIC, MATRIX), LaTeX typesetting for STEM content, and automatic grading. Questions serve as the foundational building block in the three-tier content hierarchy and can be organized into Quiz Sets and Exams.

Implements flexible transport mechanisms supporting multiple deployment architectures including stdio (local process), HTTP/WebSocket (remote server), and Docker containerization. The transport layer abstracts communication between MCP clients and the EduBase server, enabling deployment in various environments (local development, cloud, on-premise) with configurable authentication and rate limiting.

Implements authentication system managing EduBase API credentials (App ID and Secret Key) obtained from the EduBase dashboard integrations menu. Credentials are used to authenticate all MCP tool requests to the EduBase platform, with support for token-based authentication and optional SSO integration for enterprise deployments.

Implements rate limiting and request throttling mechanisms to protect the EduBase platform from excessive API usage and ensure fair resource allocation across MCP clients. Rate limits are applied at the server level with configurable thresholds and backoff strategies.

Exposes 7 tools for Quiz Set management (edubase_get_quiz_set, edubase_post_quiz_set, etc.) that enable organizing questions into reusable collections serving as the middle organizational layer in the three-tier content hierarchy. Quiz Sets group related questions and can be composed into Exams, supporting content reuse and modular assessment design.

Manages secure, time-limited assessment instances through 8 dedicated tools (edubase_get_exam, edubase_post_exam, etc.) built from Quiz Sets with integrated cheating detection capabilities. Exams represent the top tier of the three-tier content hierarchy and enforce security controls including time limits, access restrictions, and proctoring integration for high-stakes assessments.

Exposes 15 user management tools (edubase_get_user, edubase_post_user, etc.) for creating, updating, and managing user accounts within the EduBase platform. Integrates with SSO systems for enterprise authentication and maintains user profiles with role assignments, organizational membership, and permission associations.

Manages organizational hierarchies and class groupings through 15 dedicated tools (edubase_get_organization, edubase_post_organization, etc.) that enable creating departments, schools, classes, and other organizational units. Organizations form the structural context for users, permissions, and content access, supporting multi-tenant and hierarchical organizational models.

Implements a comprehensive permission system with 52 dedicated tools (edubase_get_permission, edubase_post_permission, etc.) providing fine-grained access control across users, organizations, content, and operations. Permissions are assigned at multiple levels (user, role, organization) and control access to questions, quiz sets, exams, and administrative functions, supporting role-based access control (RBAC) and attribute-based access control (ABAC) patterns.

Manages content metadata and organization through 38 tag management tools (edubase_get_tag, edubase_post_tag, etc.) enabling hierarchical tagging, content categorization, and semantic organization. Tags serve as flexible metadata that can be applied to questions, quiz sets, exams, and other content, supporting discovery, filtering, and content relationship mapping.

Exposes 6 tools for results and analytics (edubase_get_quiz_results, edubase_get_exam_results, etc.) enabling retrieval of performance data, assessment results, and learning analytics. Provides aggregated and individual result data with scoring, timing, and attempt information for analysis and reporting.

Manages external system integrations through 7 integration tools (edubase_get_integration, edubase_post_integration, etc.) enabling connections to third-party services, LMS systems, and data sources. Integrations support data synchronization, SSO federation, and API bridging to external educational platforms.