How to add EduBase MCP server to Windsurf
Let Claude and other LLMs manage your EduBase e-learning platform — create questions, schedule exams and analyze results. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.
Last updated June 14, 2026 · 28★ · stdio · apikey
Windsurf config for EduBase MCP server
npx -y @smithery/cli install @EduBase/MCP --client claude{
"mcpServers": {
"edubase-mcp-server": {
"command": "npx",
"args": [
"-y",
"@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"
}
}
}
}Setup steps
- 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
- 2Paste the EduBase MCP server config below.
- 3Fill in placeholder secrets, then save.
- 4Click Refresh in the MCP panel.
- 5EduBase MCP server's tools become available to Cascade.
Before you start
- An EduBase account with an 'EduBase API' integration (App ID + Secret key)
- Node.js installed (for the npx/node install methods) or Docker (for the Docker method)
- An MCP client such as Claude Desktop
What EduBase MCP server can do in Windsurf
edubase_<method>_<endpoint>Each documented EduBase API endpoint is exposed as a separate tool named after its HTTP method and endpoint (e.g. edubase_get_user_me for GET /user:me). The full set of tools mirrors the EduBase developer API; see developer.edubase.net for the complete endpoint reference.
Security
Requires an EduBase integration App ID and Secret key (set via EDUBASE_API_APP and EDUBASE_API_KEY). When hosting remotely, always use HTTPS and prefer Bearer-token or OAuth 2.1 authentication; running without client authentication is only suitable for testing or closed networks. The LLM acts on your behalf and can create, modify and read content in your EduBase account, so scope the integration's permissions accordingly.
EduBase MCP server + Windsurf FAQ
Where is the Windsurf config file?
Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the EduBase MCP server config there under the "mcpServers" key and restart the client.
Is EduBase MCP server safe to use with Windsurf?
Requires an EduBase integration App ID and Secret key (set via EDUBASE_API_APP and EDUBASE_API_KEY). When hosting remotely, always use HTTPS and prefer Bearer-token or OAuth 2.1 authentication; running without client authentication is only suitable for testing or closed networks. The LLM acts on your behalf and can create, modify and read content in your EduBase account, so scope the integration's permissions accordingly.
How do I get EduBase API credentials?
Log in to EduBase, open the Integrations menu on your Dashboard, click 'add integration' and choose the type 'EduBase API'. If you don't see this option, enter the MCPGITHUB activation code or contact info@edubase.net to request access.
Which transports does the server support?
It supports stdio (default), SSE (EDUBASE_SSE_MODE=true) and streamable HTTP (EDUBASE_STREAMABLE_HTTP_MODE=true). When accessing the server remotely over the internet, always use HTTPS.
Can I use it as a remote server instead of running it locally?
Yes. You can host the server and connect via SSE or streamable HTTP. For production, use Bearer-token authentication (Base64-encode {app}:{secret}) or enable OAuth 2.1 (EDUBASE_OAUTH=true) so compatible clients can connect with a 'Connect EduBase' consent flow. EduBase also offers a maintained hosted server for www.edubase.net users.