Get the MCP server version (only use for debugging).

Get the MCP server API URL (only use for debugging).

Upload a local file or a file from a URL to the EduBase temporary file storage with a link requested from the API in advance.

Generate an upload link for the temporary file storage (filebin). Returns the filebin identifier, the upload link, its expiration and the maximum file size. Upload the file with edubase_filebin, then reference the filebin identifier in the fields accepting files (e.g. question images and attachments). A previous valid link is returned unless force is set.

Delete an uploaded temporary file and/or its upload link, identified by the filebin identifier returned by edubase_post_filebin_upload.

List owned and managed Quiz questions. Returns the question identification strings and external identifiers. Use edubase_post_question_export to read the content of a question.

Check existing question. Questions are the lowest level in the EduBase hierarchy, serving as the building blocks for Quiz sets. To get question details, use the question export function!

Publish or update a question. Questions are the atomic building blocks of the EduBase Quiz system and represent the lowest level in the hierarchy (Questions -> Quiz sets -> Exams). Always check what the fields named like the type of the question do and consider using them, for example if creating a HOTSPOT question, both hotspot_zones and hotspot_image will be required!

Permanently delete a Quiz question, identified by its external unique question identifier. This cannot be undone, confirm with the user first.

Generate download link for exporting the question (in JSON format). If a previous valid link exists, it will be returned instead.

Get external unique question identifier by question identification string.

Set external unique question identifier for question identified by a question identification string.

List owned and managed Quiz sets. Quiz sets are named collections of questions that sit at the middle level of the EduBase Quiz hierarchy.

Get/check Quiz set. Containing questions and powering Exams.

Create a new Quiz set. Quiz sets are collections of questions that can be used for practice or to power multiple Exams.

Update the details of an existing Quiz set: title, external identifier, language, description and organization. Use edubase_post_quiz_settings to change its settings and edubase_post_quiz_questions to add questions.

Get the settings of a Quiz set: question shuffling, time limits and grading. Change them with edubase_post_quiz_settings.

Change individual settings of a Quiz set: question shuffling, time limits, grading and grading threshold. Only the given settings are changed, and the updated settings are returned. List the available grading presets with edubase_get_quiz_grading_presets.

Replace the complete configuration of a Quiz set with the configuration of another Quiz set. Only the configuration is copied, questions and question groups are not. The question selection, filtering and export settings of the target Quiz set are kept as well.

Copy only those settings from another Quiz set that are not configured yet in the target Quiz set.

Delete a Quiz set, or archive it when the user is not allowed to delete it. Confirm with the user first.

List the grading presets available for the user. The global presets, the owned custom presets and the presets of the organizations of the user are returned. A Quiz set or an exam can be specified to list only the presets that can be used on it, together with the one it is currently using.

Get a grading preset with its thresholds and grades, including whether its threshold is configurable and whether certificates can be issued with it. List the presets with edubase_get_quiz_grading_presets.

Create a new custom grading preset. Needs the custom grading feature to be enabled.

Update an existing custom grading preset. The global presets and the presets of the organizations cannot be modified.

Remove a custom grading preset. The global presets, the presets of the organizations, and the presets that are still used by a Quiz set or an exam cannot be removed.

Get the skills defined in a Quiz set, with the identifier, title and description of each skill.

List all questions and question groups in a Quiz set. Quiz sets contain questions (lowest level) and can be used by exams (highest level).

Assign question(s) to a Quiz set, or one of its question group. Questions can exist independently from Quiz sets.

Remove question(s) from a Quiz set, or one of its question group.

List owned and managed exams. Exams are the highest level in the EduBase Quiz hierarchy, built from Quiz sets.

Get the details of an exam: title, language, the Quiz set it uses, active state, status (INACTIVE, ACTIVE, PAUSED, REVIEW, EXPIRED), start and end times, deadline and Safe Exam Browser links. Use edubase_get_exam_settings for its settings.

Create a new exam from an existing Quiz set. Exams are at the top level of the EduBase Quiz hierarchy and MUST be created from existing Quiz sets. They are time-constrained, secured assessment instances of Quiz sets.

Update the details of an existing exam: title, external identifier, language, description, organization, start and end times, and deadline. The start time can only be changed until the first result arrives. Use edubase_post_exam_settings to change its settings.

Delete an exam, or archive it when the user is not allowed to delete it. Confirm with the user first.

Get the settings of an exam. Surveys are never graded and their results cannot be viewed later, so the grading and the results viewing settings are not returned for them. The columns of the results export cannot be configured for surveys either, only the format and the ordering of the exported file.

Change individual settings of an exam. The columns of the export (every setting from export_stats on) cannot be configured for surveys, only the export_format and the export_sort settings are available for them. The export_attendance setting is read only, the attendance is configured together with its source on the interface.

Replace the complete configuration of an exam with the configuration of another exam. Exam specific data and state (automatic account generation, rounds, notifications, login settings and previously used patterns) is never copied. Branding, and the attached learning materials (course, SCORM package and video) of the target exam are kept as well.

Copy only those settings from another exam that are not configured yet in the target exam.

Get the automatic login configuration of an exam: whether it is enabled, the PIN code, the login and results links, and whether exam accounts are generated or registered users can join automatically.

Enable or reconfigure automatic login for an exam, optionally with a shortlink for the login link. Returns the configuration with the PIN code and login link, the same way as edubase_get_exam_autologin. Disable it with edubase_delete_exam_autologin.

Disable automatic login for an exam. The PIN code and the shortlink of the exam are removed as well.

Generate exam accounts from patterns and assign them to an exam. The following placeholders can be used in the patterns: {index} (the index of the generated account), {random:N} (a random alphanumeric string of N characters, unambiguous characters only in passwords), {number:N} (a random numeric string of N characters), {name} and {Name} (the name of the account, only when names is specified, as given and capitalized) and {username} (the generated username, in the name pattern only). Patterns are stored with the exam and reused as defaults for the next call.

Get the user data fields of an exam. These are the built-in name, email address and phone number fields, and the custom fields the examinees fill in before they start their test.

Change the built-in user data fields of an exam, and replace the complete list of its custom fields. The view_results_identifier setting of the exam is cleared when the selected custom field is not a unique free text field anymore.

Remove every custom field of an exam. The built-in name, email address and phone number fields are kept, use edubase_post_exam_fields to turn those off. The values the examinees already entered are kept, but they are not shown anymore. The view_results_identifier setting of the exam is cleared as well.

Get the status of an exam, showing whether new tests can be started.

Enable or disable starting new tests on an exam. The exam itself stays active, only the start of further tests is controlled. The status can only be changed while the exam is active and has not closed yet. New tests cannot be started in the results viewing period. Disabling new tests also cancels the scheduled automatic disabling of the exam.

Get the current round of an exam: its index, start time, whether it already has results and whether it is frozen. Start a new round with edubase_post_exam_round.

Start a new round of the exam. The running tests are closed, the results of the previous round are detached from the exam accounts and the generated accounts are reset, so the exam can be taken again by another group of examinees. A new round cannot be started when the exam is locked, archived, the current round is frozen (see the freeze_round setting of edubase_post_exam_settings), or the results viewing period of the exam has already begun (see the view_results_start setting of edubase_post_exam_settings).

Get the certificate settings of an exam. Certificates are only issued for the successful results, so they need a grading that decides whether the test was successful (see the certificates flag in edubase_get_quiz_grading_presets). Only the state of the certificates is returned when they are not enabled for the exam. When the certificates are configured by a preset, the settings of the preset are merged into the returned configuration. The certificates issued for the individual results can be looked up with edubase_get_exam_certificates_user.

Change individual certificate settings of an exam. Every setting other than enabled requires the certificates to be enabled for the exam, and the items displayed on the certificates have to be switched on before their own settings can be configured (for example show_serial before the serial_ settings). The certificates configured by a preset can only be replaced completely, see edubase_put_exam_certificates. The settings cannot be changed while the exam is locked.

Replace the complete certificate configuration of an exam with a preset or with the configuration of another exam. The certificates have to be enabled for the exam, and its settings cannot be changed while it is locked.

Stop issuing certificates for an exam. The configuration itself is kept, so the certificates can be enabled again later with edubase_post_exam_certificates. The already issued certificates are not revoked. The settings cannot be changed while the exam is locked.

List the certificate presets that can be used on exams. The public presets, the owned presets and the presets of the organizations of the user are returned.

Get the skills defined in the Quiz set used by an exam, with the identifier, title and description of each skill.

Get the branding of an exam: whether it is enabled, the type of the branding image (logo or cover) and the branding color.

Configure or update the branding of an exam with an image (base64-encoded or URL, used as a logo or as a cover) and a color.

Remove the branding image and color from an exam.

List the users assigned to an exam, with their names. Assign users with edubase_post_exam_users.

Assign existing users to an exam by their user identification strings. Use edubase_post_exam_users_generate to create new exam accounts instead.

Remove users from an exam by their user identification strings.

Submit a short summary of an exam, such as an AI-generated evaluation of its results. Keep it concise, use only basic HTML formatting, and avoid personal information (names, usernames, contact details).

Get the detailed results of a single Quiz play (attempt): times, points, validity, whether it passed the grading, and the points and answer time of every question. Play identification strings are returned by edubase_get_quiz_results_user and edubase_get_exam_results_user.

Archive or forget the result of a Quiz play. An exam result is archived: it disappears from the result lists and the reports of the exam, but it is kept and can be restored by adding the archived user back to the exam. A result outside of an exam is forgotten: the play is detached from the user and only kept for the statistics. Exam results can only be archived when archiving is enabled for the exam (see the archive setting of edubase_post_exam_settings), and only the current result of the user can be archived. Results outside of an exam can only be forgotten by administrators.

List the results (plays) of a user in a Quiz set, with times, points, validity and whether they passed the grading. Use edubase_get_quiz_results_play for the per-question details of a play.

List the results (attempts) of a user in an exam, with times, points, attempt index, validity and whether they passed the grading. Use edubase_get_quiz_results_play for the per-question details of an attempt.

Get raw results for a specific exam. Only use this if very detailed results are needed! This endpoint returns raw results, including all answers given by the user. It is not meant to be displayed to the user. This might require additional permissions!

Generate a download link for the results of an exam. The generated link is not authenticated, so it can be handed over to any service, but it can only be used once and it expires in an hour. Only those examinees are exported that are visible for the current user, and the exported columns are controlled by the export settings of the exam (see edubase_get_exam_settings). Exporting the results needs reporting permission for the exam.

Get (the latest) certificate details for a specific exam and user.

Generate download link for the latest user exam certificate. If a previous valid link exists, it will be returned instead.

List managed users, excluding generated exam accounts. Returns user identification strings and names. Use edubase_get_user_search to find a user by email address, username or code.

Get the current user the requests are made as: identification string, name, whether the account is enabled and whether it is a generated exam account.

Get a user: name, whether the account is enabled and whether it is a generated exam account. Use edubase_get_user_search if only the email address or username is known.

Create a new EduBase user account with a username, name, email address and optional details (group, language, timezone, custom fields, etc.). A random initial password is generated if none is given. Returns the user identification string, and the username and password for non-exam accounts.

Enable or disable a user account, identified by its user identification string.

Delete a user account. Only the users created through the API or generated by the current user can be deleted. Confirm with the user first.

Get the first, last, full and display name of a user.

Update the name of a user: first and last name, optionally the full and display name. Returns whether the name was changed.

Get the code of the user group a user belongs to.

Move a user to another user group, identified by its code. Returns whether the group was changed.

Get the latest valid login link of a user and its validity. Generate a new link with edubase_post_user_login.

Generate login link. If a valid link with the same settings exists, it will be returned instead of creating a new one.

Invalidate a login link previously generated for a user.

Look up a user by email address, username or user identification string. Returns the user identification string and whether it is a generated exam account.

List owned and managed classes. Returns class identification strings, external identifiers and titles.

Get the details of a class: title, external identifier, and start and end dates.

List the assignments of a class, with their titles, links, status (INACTIVE, ACTIVE, STARTED, SUBMITTED, GRADED) and submission period.

List the members of a class, with their names and whether their membership is active (approved and not expired).

Assign user(s) to a class. Updates memberships if already member of the class.

Remove users from a class by their user identification strings.

Assign user(s) to class(es). Updates memberships if already member of a class.

List the classes a user is member of, with their titles, links and whether the membership is active.

Assign user to class(es). Updates membership if already member of a class.

Remove a user from classes by their class identification strings.

List owned and managed organizations. Returns organization identification strings, external identifiers and titles.

Get the details of an organization: title, external identifier and description.

Create an organization with a title and optional description, website, contact details and custom fields. Returns the organization identification string.

Update the title or custom fields of an organization.

Remove an organization. Confirm with the user first.

List the members of an organization, with their names, departments and permission levels (to the organization, its contents and its members).

Assign user(s) to an organization. Updates memberships if already member of the organization.

Remove users from an organization by their user identification strings.

Assign user(s) to organization(s). Updates memberships if already member of an organization.

List all departments in an organization, ordered by their hierarchy.

Get a department of an organization, identified by its name or external identifier: its parent, level in the hierarchy and the permissions given to its members.

Create a department in an organization. Members of a department can see the members of the departments below it, but permissions are not inherited.

Update department of an organization. Changed permissions are applied to every member of the department.

Remove department from an organization. Members of the department are left without a department and lose the permissions and competencies given by it, departments below it are moved one level up.

List all competencies of an organization. Library and competencies must be enabled for the organization.

List the requirements of a competency, ordered by their priority. Library and competencies must be enabled for the organization of the competency.

Get the competency compliance overview of an organization, grouped by departments. Organization reporters see every visible member, department leaders only the members of the departments they lead. Library and competencies must be enabled for the organization.

List the organizations a user is member of, with their titles, links, the department of the user and the permission levels.

Assign user to organization(s). Updates membership if already member of an organization.

Remove a user from organizations by their organization identification strings.

Get a webhook of an organization: its title and whether it is active.

Create a webhook for an organization, called on exam results, Quiz practice results or manual API triggers, with optional authentication and retries. Returns the webhook identification string. Test it with edubase_post_organization_webhook_trigger.

Enable or disable a webhook of an organization.

Remove a webhook from an organization, no more notifications are sent to its endpoint. Use edubase_patch_organization_webhook to only disable it.

Trigger an organizational webhook call with optional custom payload. Only triggers webhooks with trigger_event set to api!.

List owned and managed integrations. Returns integration identification strings, external identifiers and titles.

Get the details of an integration: title, type (api, moodle, canvas, d2l, schoology, lms), whether it is active and its LTI version.

Create a new API or LMS (LTI 1.0/1.1 or 1.3) integration. Returns the integration identification string, get its keys with edubase_get_integration_keys.

Enable or disable an integration, or move it to another organization.

Remove an integration. Confirm with the user first.

Get the keys and secrets of an integration: the app and secret of API integrations, the consumer key and secret (LTI 1.0/1.1) or the JWK set URL and public key (LTI 1.3) of LMS integrations. Treat the secrets as confidential.

Rotate the keys and secrets of an integration and return the new ones, the previous keys stop working. Confirm with the user first.

List owned and managed tags. Returns tag identification strings, external identifiers and titles. Attach tags to contents with edubase_post_content_tag.

Get the details of a tag: title, external identifier, color and icon.

List the tags attached to a content (class, course, event, exam, integration, organization, Quiz set, SCORM learning material or video).

Check if a tag is attached to a content (class, course, event, exam, integration, organization, Quiz set, SCORM learning material or video).

Attach a tag to a content (class, course, event, exam, integration, organization, Quiz set, SCORM learning material or video). List the available tags with edubase_get_tags.

Remove a tag from a content (class, course, event, exam, integration, organization, Quiz set, SCORM learning material or video). The tag itself is kept.

Check if a user has a permission level on a content (class, course, event, exam, integration, organization, Quiz set, SCORM learning material, tag or video). Returns whether the user has the permission, and whether there is a permission rule with exactly these parameters.

Give a user a permission level on a content (class, course, event, exam, integration, organization, Quiz set, SCORM learning material, tag or video).

Remove a permission level of a user from a content (class, course, event, exam, integration, organization, Quiz set, SCORM learning material, tag or video).

Transfer the ownership of a content (class, course, event, exam, integration, organization, Quiz set, SCORM learning material, tag or video) to another user. Confirm with the user first.

Set a custom metric to a value, or increment it with a + prefixed value (e.g. +1). Returns the saved value.