[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_124":125},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":41,"_42":43,"_44":45,"_46":47,"_48":49,"_50":51,"_52":53,"_54":55,"_56":-5,"_57":49,"_58":59,"_60":61,"_62":63,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":75,"_76":77,"_78":79,"_80":-5,"_81":-5,"_82":83,"_84":49,"_85":-5,"_86":87,"_88":89,"_90":91,"_92":93,"_94":95,"_96":97},"apiUrl","https://odel.app/api","creator","edubase","moduleId","mcp","@edubase/mcp","displayName","MCP","tagline","EduBase MCP server","iconKey","https://avatars.githubusercontent.com/u/33938028?v=4","category","remote","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://www.edubase.net/mcp\",\"transport\":\"streamable-http\",\"authType\":\"headers\",\"requiredSecrets\":[{\"name\":\"EduBase-Api-App\",\"scope\":\"per-user\",\"header\":\"EduBase-Api-App\"},{\"name\":\"EduBase-Api-Secret\",\"scope\":\"per-user\",\"header\":\"EduBase-Api-Secret\"}]}","pricingModel","free","creatorUserId","system:external-import","createdAt",1781363342000,"updatedAt",1788773697000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.EduBase%2FMCP","sourceVerified",true,"sourceMissingSince","importedAt","upstreamStars",28,"upstreamUpdatedAt",1788729632000,"detectedTransport","streamable-http","detectedAuthType","oauth","probeStatus","ok","lastProbedAt",1788065034000,"githubRepoUrl","https://github.com/EduBase/MCP","githubRepoFullName","EduBase/MCP","releaseId","ext-edubase-mcp","version","1.2.16","descriptionMarkdown"," $\"EduBase$ \n\n# EduBase MCP server\n\n[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/EduBase/MCP/main.svg)](https://results.pre-commit.ci/latest/github/EduBase/MCP/main)\n[![Publish to MCP Registry](https://github.com/EduBase/MCP/actions/workflows/publish-mcp.yml/badge.svg)](https://github.com/EduBase/MCP/actions/workflows/publish-mcp.yml)\n[![smithery badge](https://smithery.ai/badge/@EduBase/MCP)](https://smithery.ai/server/@EduBase/MCP)\n\nThis 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.\n\n![EduBase MCP demo GIF: Claude uploads math questions](https://shared.edubase.net/mcp/EduBaseMCPdemomath.gif)\n\n\n $\"EduBase$ \n\n\n## What is EduBase?\n\nEduBase is an innovative, modular, online educational platform that makes learning more enjoyable, simpler and interactive, suitable for educational institutions or enterprises.\n\n### Why choose EduBase?\n\nEduBase revolutionizes digital learning with its unique combination of features:\n\n* **Advanced Quiz System** with parametrization allowing infinite variations of the same question, real-time cheating detection, beautiful LaTeX typesetting, advanced STEM-support and automatic grading\n* **Unified Learning Environment** that centralizes all your educational content — videos, exams, documents, and SCORM modules — in one intuitive system\n* **Enterprise-Grade Security** with features like SSO integration, fine-grained access controls, comprehensive auditing, and GDPR compliance\n* **Integration** with your existing systems through LTI, comprehensive API, and custom integration options\n* **AI-Assisted Tools**, such as EduBase Assistant, that can instantly transform your existing content into interactive quizzes and assessments, or translate your materials from one language to another\n\nFrom higher education institutions to corporate training departments, EduBase scales to meet your specific needs while maintaining an intuitive user experience across all devices.\n\n### Demo video\n\nCollaboratively creating and uploading questions, scheduling exams and analyzing user results with Claude:\n\n\n $\"Demonstrating$ \n\n\n### Obtaining your API credentials\n\nOnce logged in, on your Dashboard, search for the Integrations menu, click \"add integration\" and choose the type \"EduBase API\".\n\n**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](mailto:info@edubase.net).\n\n $\"EduBase$ \n\n## Tools\n\nEach documented API endpoint is available as a separate tool, named `edubase__`. For example, the tool for the `GET /user:me` endpoint is named `edubase_get_user_me`. See our [developer documentation](https://developer.edubase.net) for more information.\n\n## Configuration\n\nThe MCP server can be configured using environment variables. The following variables are available:\n\n| Variable | Description | Required | Default value |\n|---|---|---|---|\n| `EDUBASE_API_URL` | The base URL of the EduBase API, most probably `https://subdomain.edubase.net/api`. | **Yes** | `https://www.edubase.net/api` |\n| `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** | - |\n| `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** | - |\n| `EDUBASE_SSE_MODE` | Start MCP server in HTTP mode with SSE transport. Value must be `true`. | No | `false` |\n| `EDUBASE_STREAMABLE_HTTP_MODE` | Start MCP server in HTTP mode with streamable HTTP transport. Value must be `true`. | No | `false` |\n| `EDUBASE_HTTP_PORT` | HTTP server will listen on this port if SSE or streamable HTTP transport mode is used. | No | 3000 |\n| `EDUBASE_OAUTH` | Enables OAuth 2.1 protected-resource behaviour: unauthenticated requests are rejected with `401 + WWW-Authenticate` pointing at `/.well-known/oauth-protected-resource`, and bearer tokens are forwarded to the EduBase API. | No | `false` |\n| `EDUBASE_OAUTH_AUTHORIZATION_SERVER` | Public base URL of the EduBase deployment acting as the OAuth IdP. Used to advertise the authorization server in the protected-resource metadata document. | No | derived from `EDUBASE_API_URL` |\n| `EDUBASE_OAUTH_RESOURCE_URL` | Public base URL of *this* MCP server (the OAuth resource indicator). Used in the `WWW-Authenticate` header and resource metadata. | No | derived from `EDUBASE_API_URL` |\n| `EDUBASE_ALLOW_PRIVATE_NETWORK` | When an HTTP transport is used, the `edubase_filebin` tool blocks outbound requests to private, loopback, link-local and reserved addresses (SSRF protection) and refuses local file paths. Set to `true` to allow them, e.g. a self-hosted deployment on a trusted private network. Has no effect in stdio mode, where the local user is the only caller. | No | `false` |\n| `EDUBASE_FILEBIN_ALLOWED_HOSTS` | Optional comma-separated allow-list of hostnames permitted as `edubase_filebin` upload targets (exact host or any subdomain, e.g. `edubase.net`). When empty, any public host is allowed (still subject to the address filtering above). | No | - |\n\n## Use as a remote MCP server\n\nYou 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!\n\n### Authentication with remote servers\n\nYou can use server in two modes:\n\n* **Without client authentication**: In this mode, the server will not require any authentication from the client. This is useful for testing or development purposes, or in a closed network but it is not recommended for production use. For this, you have to configure the server with the `EDUBASE_API_APP` and `EDUBASE_API_KEY` as well!\n* **With Bearer token authentication**: In this mode, the server will require a Bearer token to be sent with each request. This is the recommended way to use the server in production. You can obtain the Bearer token from your EduBase account by creating an integration app and providing the App ID and Secret key in the `{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.\n* **With OAuth 2.1 (EduBase as IdP)**: When `EDUBASE_OAUTH=true`, compatible clients (Claude Desktop, Claude.ai connectors, Cursor, ChatGPT connectors, etc.) discover the EduBase authorization server through `/.well-known/oauth-protected-resource`, register themselves dynamically (RFC 7591), walk the user through an EduBase consent screen, and exchange an authorization code (with PKCE S256) for an opaque access token. The MCP server forwards that token verbatim to the EduBase API, which resolves it to the auto-provisioned MCP integration, created on first consent. No App ID/Secret to copy — users just click \"Connect EduBase\" in their client.\n\n## Usage with Claude Desktop\n\nFor a step-by-step walkthrough, see our blog post on how to [connect EduBase with Claude: The Complete MCP Integration Guide](https://edubase.blog/claude-mcp-integration-guide/).\n\n### Using the provided EduBase MCP server\n\nYou can use the provided EduBase MCP server (if available) without any configuration, just by adding it as a remote server in your client with the URL `https://domain.edubase.net/mcp` (replace with the actual domain), if it supports OAuth authentication, or with the appropriate Bearer token in the `Authorization` header (`Authorization: Bearer ${BASE64_ENCODED_TOKEN}`).\n\n**Recommended for www.edubase.net users**, as the server is maintained and updated by us, and you don't have to worry about hosting or configuring it. Just make sure to use the correct URL and authentication method when connecting your client.\n\n### Installing manually\n\nAdd the following to your `claude_desktop_config.json`:\n\n#### Using Node.js\n\nBefore running the MCP server, make sure you have **Node.js installed**. You can download it from [nodejs.org](https://nodejs.org/) or use a package manager like `brew`.\n\n```json\n{\n \"mcpServers\": {\n \"edubase\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@edubase/mcp\"\n ],\n \"env\": {\n \"EDUBASE_API_URL\": \"https://domain.edubase.net/api\",\n \"EDUBASE_API_APP\": \"your_integration_app_id\",\n \"EDUBASE_API_KEY\": \"your_integration_secret_key\"\n }\n }\n }\n}\n```\n\nOr 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**!\n\n```json\n{\n \"mcpServers\": {\n \"edubase\": {\n \"command\": \"node\",\n \"args\": [\n \"/path/to/dist/index.js\"\n ],\n \"env\": {\n \"EDUBASE_API_URL\": \"https://domain.edubase.net/api\",\n \"EDUBASE_API_APP\": \"your_integration_app_id\",\n \"EDUBASE_API_KEY\": \"your_integration_secret_key\"\n }\n }\n }\n}\n```\n\n#### Using Docker\n\nBefore running the MCP server, make sure you have **Docker installed and is running**. You can download it from [docker.com](https://www.docker.com/) or use a package manager. Do not forget to **configure the environmental variables**!\n\n```json\n{\n \"mcpServers\": {\n \"edubase\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"--rm\",\n \"-e\",\n \"EDUBASE_API_URL\",\n \"-e\",\n \"EDUBASE_API_APP\",\n \"-e\",\n \"EDUBASE_API_KEY\",\n \"edubase/mcp\"\n ],\n \"env\": {\n \"EDUBASE_API_URL\": \"https://domain.edubase.net/api\",\n \"EDUBASE_API_APP\": \"your_integration_app_id\",\n \"EDUBASE_API_KEY\": \"your_integration_secret_key\"\n }\n }\n }\n}\n```\n\n### Installing via remote MCP server\n\nYou 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}`).\n\n```json\n{\n \"mcpServers\": {\n \"edubase\": {\n \"command\": \"npx\",\n \"args\": [\n \"mcp-remote\",\n \"https://domain.edubase.net/mcp\",\n \"--header\",\n \"Authorization: Bearer ${EDUBASE_API_APP}:${EDUBASE_API_KEY}\"\n ]\n }\n }\n}\n```\n\n### Installing via Smithery\n\nTo install EduBase MCP server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@EduBase/MCP):\n\n```bash\nnpx -y @smithery/cli install @EduBase/MCP --client claude\n```\n\n## Contact\n\nWebsite: [www.edubase.net](https://github.com/EduBase/MCP/blob/main/www.edubase.net) \nDeveloper Documentation: [developer.edubase.net](https://github.com/EduBase/MCP/blob/main/developer.edubase.net) \nEmail: [info@edubase.net](mailto:info@edubase.net)\n","changelogMarkdown","videoKey","requiredSecretsJson","[{\"name\":\"EduBase-Api-App\",\"scope\":\"per-user\",\"header\":\"EduBase-Api-App\"},{\"name\":\"EduBase-Api-Secret\",\"scope\":\"per-user\",\"header\":\"EduBase-Api-Secret\"}]","publishedAt","priceCents","trialDays",0,"upstream",{"_108":109,"_110":111,"_112":113,"_114":115,"_116":117,"_118":119},"requiredSecrets",[100,101],"tags",[],"assets",[],"stats",{"_98":87,"_99":87},"ratingAvg","reviewCount",{"_102":107,"_104":105,"_106":107},{"_102":103,"_104":105,"_106":103},"name","EduBase-Api-Secret","scope","per-user","header","EduBase-Api-App","topics",[],"license","MIT","language","TypeScript","registryName","io.github.EduBase/MCP","homepage","https://developer.edubase.net","packages",[120],{"_121":122,"_123":22,"_76":77},"registryType","npm","identifier","ENV",{"_126":127,"_128":129,"_130":131},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]