by EduBase
Enables Claude and other LLMs to interact with EduBase's e-learning platform via the Model Context Protocol (MCP).
The EduBase MCP server is a server-side implementation of the Model Context Protocol (MCP) designed to facilitate interaction between Large Language Models (LLMs) like Claude and the EduBase e-learning platform. It allows MCP clients to perform actions on an EduBase account on behalf of the user.
The MCP server can be used in several ways:
claude_desktop_config.json
by specifying the command to run the server (either via Node.js or Docker) and setting the necessary environment variables like EDUBASE_API_URL
, EDUBASE_API_APP
, and EDUBASE_API_KEY
.npx -y @smithery/cli install @EduBase/MCP --client claude
.Configuration of the server primarily involves setting environment variables such as EDUBASE_API_URL
, EDUBASE_API_APP
, and EDUBASE_API_KEY
.
edubase_get_user
).MCPGITHUB
activation code.EDUBASE_API_URL
, EDUBASE_API_APP
, EDUBASE_API_KEY
, EDUBASE_SSE_MODE
, EDUBASE_STREAMABLE_HTTP_MODE
, and EDUBASE_HTTP_PORT
.APP:SECRET
and including it in the Authorization
header.This repository contains the implementation of the Model Context Protocol (MCP) server for the EduBase platform. It allows MCP clients (for example Claude Desktop) and LLMs to interact with your EduBase account and perform tasks on your behalf. It supports stdio, SSE and streamable HTTP transport protocols.
EduBase is an innovative, modular, online educational platform that makes learning more enjoyable, simpler and interactive, suitable for educational institutions or enterprises.
EduBase revolutionizes digital learning with its unique combination of features:
From higher education institutions to corporate training departments, EduBase scales to meet your specific needs while maintaining an intuitive user experience across all devices.
Collaboratively creating and uploading questions, scheduling exams and analyzing user results with Claude:
Once logged in, on your Dashboard, search for the Integrations menu, click "add integration" and choose the type "EduBase API".
If you don't see this option, enter the MCPGITHUB
activation code or feel free to contact us to request access at info@edubase.net.
Each documented API endpoint is available as a separate tool, named edubase_<method>_<endpoint>
. For example, the tool for the GET /user
endpoint is named edubase_get_user
. See our developer documentation for more information.
The MCP server can be configured using environment variables. The following variables are available:
Variable | Description | Required | Default value |
---|---|---|---|
EDUBASE_API_URL |
The base URL of the EduBase API, most probably https://subdomain.edubase.net/api . |
Yes | https://www.edubase.net/api |
EDUBASE_API_APP |
The App ID of your integration app on EduBase, the app on the EduBase API. Find this in the integration details window on EduBase. |
Not if HTTP transport is used with authentication, otherwise Yes | - |
EDUBASE_API_KEY |
The Secret key of your integration app on EduBase, the secret on the EduBase API. Find this along the App ID in the integration details window on EduBase. |
Not if HTTP transport is used with authentication, otherwise Yes | - |
EDUBASE_SSE_MODE |
Start MCP server in HTTP mode with SSE transport. Value must be true . |
No | false |
EDUBASE_STREAMABLE_HTTP_MODE |
Start MCP server in HTTP mode with streamable HTTP transport. Value must be true . |
No | false |
EDUBASE_HTTP_PORT |
HTTP server will listen on this port if SSE or streamable HTTP transport mode is used. | No | 3000 |
You can use the EduBase MCP server as a remote MCP server for your MCP client. To do this, you need to host the MCP server where clients can access it, and then configure the client to connect to the server. Either start it with SSE or streamable HTTP transport mode and always use HTTPS when accessing the server remotely over the internet!
You can use server in two modes:
EDUBASE_API_APP
and EDUBASE_API_KEY
as well!{app}:{secret}
format, base64 encoded as a token. The server will then use this token to authenticate the client and authorize access to the API endpoints.For a step-by-step walkthrough, see our blog post on how to connect EduBase with Claude: The Complete MCP Integration Guide.
Add the following to your claude_desktop_config.json
:
Before running the MCP server, make sure you have Node.js installed. You can download it from nodejs.org or use a package manager like brew
. Download EduBase MCP server release or clone the repository and run npm run build
to build the server. Do not forget to adjust /path/to/dist
to the actual directory and configure the environmental variables!
{
"mcpServers": {
"edubase": {
"command": "node",
"args": [
"/path/to/dist/index.js"
],
"env": {
"EDUBASE_API_URL": "https://domain.edubase.net/api",
"EDUBASE_API_APP": "your_integration_app_id",
"EDUBASE_API_KEY": "your_integration_secret_key"
}
}
}
}
Before running the MCP server, make sure you have Docker installed and is running. You can download it from docker.com or use a package manager. Do not forget to configure the environmental variables!
{
"mcpServers": {
"edubase": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"EDUBASE_API_URL",
"-e",
"EDUBASE_API_APP",
"-e",
"EDUBASE_API_KEY",
"edubase/mcp"
],
"env": {
"EDUBASE_API_URL": "https://domain.edubase.net/api",
"EDUBASE_API_APP": "your_integration_app_id",
"EDUBASE_API_KEY": "your_integration_secret_key"
}
}
}
}
You can use the provided EduBase MCP server (if available) as a remote server. We recommend Base64 encoding your EDUBASE_API_APP
and EDUBASE_API_KEY
and using it in as a Bearer token in the Authorization
header (Authorization: Bearer ${BASE64_ENCODED_TOKEN}
).
{
"mcpServers": {
"edubase": {
"command": "npx",
"args": [
"mcp-remote",
"https://domain.edubase.net/mcp",
"--header",
"Authorization: Bearer ${EDUBASE_API_APP}:${EDUBASE_API_KEY}"
]
}
}
}
To install EduBase MCP server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @EduBase/MCP --client claude
Website: www.edubase.net
Developer Documentation: developer.edubase.net
Email: info@edubase.net
Please log in to share your review and rating for this MCP.
Discover more MCP servers with similar functionality and use cases
by zed-industries
Provides real-time collaborative editing powered by Rust, enabling developers to edit code instantly across machines with a responsive, GPU-accelerated UI.
by cline
Provides autonomous coding assistance directly in the IDE, enabling file creation, editing, terminal command execution, browser interactions, and tool extension with user approval at each step.
by continuedev
Provides continuous AI assistance across IDEs, terminals, and CI pipelines, offering agents, chat, inline editing, and autocomplete to accelerate software development.
by github
Enables AI agents, assistants, and chatbots to interact with GitHub via natural‑language commands, providing read‑write access to repositories, issues, pull requests, workflows, security data and team activity.
by block
Automates engineering tasks by installing, executing, editing, and testing code using any large language model, providing end‑to‑end project building, debugging, workflow orchestration, and external API interaction.
by RooCodeInc
An autonomous coding agent that lives inside VS Code, capable of generating, refactoring, debugging code, managing files, running terminal commands, controlling a browser, and adapting its behavior through custom modes and instructions.
by lastmile-ai
A lightweight, composable framework for building AI agents using Model Context Protocol and simple workflow patterns.
by firebase
Provides a command‑line interface to manage, test, and deploy Firebase projects, covering hosting, databases, authentication, cloud functions, extensions, and CI/CD workflows.
by gptme
Empowers large language models to act as personal AI assistants directly inside the terminal, providing capabilities such as code execution, file manipulation, web browsing, vision, and interactive tool usage.