EduBase

EduBase MCP Server

The EduBase MCP server enables Claude and other LLMs to interact with EduBase's comprehensive e-learning platform through the Model Context Protocol (MCP).

What is an MCP Server?⁠

MCP Info

Image Building InfoDockerfile|https://github.com/EduBase/MCP/blob/main/Dockerfile⁠

Docker Image built by|Docker Inc. Docker Scout Health Score| Verify Signature|COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/edubase --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pubLicence|MIT License

Available Tools (156)

Tools Details

Tool: edubase_delete_class_members

Remove user(s) from a class.

Tool: edubase_delete_class_permission

Remove a user permission from a class.

Tool: edubase_delete_class_tag

Remove a tag attachment from a class.

Tool: edubase_delete_course_permission

Remove a user permission from a course.

Tool: edubase_delete_course_tag

Remove a tag attachment from a course.

Tool: edubase_delete_course_transfer

Transfer course to user.

Tool: edubase_delete_event_permission

Remove a user permission from an event.

Tool: edubase_delete_event_tag

Remove a tag attachment from an event.

Tool: edubase_delete_exam

Remove/archive exam.

Tool: edubase_delete_exam_permission

Remove a user permission from an exam.

Tool: edubase_delete_exam_tag

Remove a tag attachment from an exam.

Tool: edubase_delete_exam_users

Remove user(s) from an exam.

Tool: edubase_delete_integration

Remove integration.

Tool: edubase_delete_integration_permission

Remove a user permission from an integration.

Tool: edubase_delete_integration_tag

Remove a tag attachment from an integration.

Tool: edubase_delete_organization

Remove organization.

Tool: edubase_delete_organization_members

Remove user(s) from an organization.

Tool: edubase_delete_organization_permission

Remove a user permission from an organization.

Tool: edubase_delete_organization_tag

Remove a tag attachment from an organization.

Tool: edubase_delete_organization_webhook

Remove organizational webhook.

Tool: edubase_delete_question

Permanently delete a Quiz question.

Tool: edubase_delete_quiz

Remove/archive Quiz set.

Tool: edubase_delete_quiz_permission

Remove a user permission from a quiz.

Tool: edubase_delete_quiz_questions

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

Tool: edubase_delete_quiz_tag

Remove a tag attachment from a Quiz.

Tool: edubase_delete_scorm_permission

Remove a user permission from a SCORM learning material.

Tool: edubase_delete_scorm_tag

Remove a tag attachment from a SCORM learning material.

Tool: edubase_delete_tag_permission

Remove a user permission from a tag.

Tool: edubase_delete_user

Delete user.

Tool: edubase_delete_user_assume

Revoke assume token.

Tool: edubase_delete_user_classes

Remove user from class(es).

Tool: edubase_delete_user_login

Delete a previously generated login link.

Tool: edubase_delete_user_organizations

Remove user from organization(s).

Tool: edubase_delete_video_permission

Remove a user permission from a video.

Tool: edubase_delete_video_tag

Remove a tag attachment from a video.

Tool: edubase_get_class

Get/check class.

Tool: edubase_get_class_assignments

List all assignments in a class.

Tool: edubase_get_class_members

List all members in a class.

Tool: edubase_get_class_permission

Check if a user has permission on a class.

Tool: edubase_get_class_tag

Check if tag is attached to a class.

Tool: edubase_get_class_tags

List all attached tags of a class.

Tool: edubase_get_classes

List owned and managed classes.

Tool: edubase_get_course_permission

Check if a user has permission on a course.

Tool: edubase_get_course_tag

Check if tag is attached to a course.

Tool: edubase_get_course_tags

List all attached tags of a course.

Tool: edubase_get_event_permission

Check if a user has permission on an event.

Tool: edubase_get_event_tag

Check if tag is attached to an event.

Tool: edubase_get_event_tags

List all attached tags of an event.

Tool: edubase_get_exam

Get/check exam.

Tool: edubase_get_exam_certificates_user

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

Tool: edubase_get_exam_permission

Check if a user has permission on an exam.

Tool: edubase_get_exam_results_raw

Get raw results for a specific exam.

• 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. Parameters|Type|Description -|-|- exam|string|exam identification string

Tool: edubase_get_exam_results_user

Get user results for a specific exam.

Tool: edubase_get_exam_tag

Check if tag is attached to an exam.

Tool: edubase_get_exam_tags

List all attached tags of an exam.

Tool: edubase_get_exam_users

List all users on an exam.

Tool: edubase_get_exams

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

Tool: edubase_get_integration

Get/check integration.

Tool: edubase_get_integration_keys

Get integration keys/secrets.

Tool: edubase_get_integration_permission

Check if a user has permission on an integration.

Tool: edubase_get_integration_tag

Check if tag is attached to an integration.

Tool: edubase_get_integration_tags

List all attached tags of an integration.

Tool: edubase_get_integrations

List owned and managed integrations.

Tool: edubase_get_organization

Get/check organization.

Tool: edubase_get_organization_members

List all members in an organization.

Tool: edubase_get_organization_permission

Check if a user has permission on an organization.

Tool: edubase_get_organization_tag

Check if tag is attached to an organization.

Tool: edubase_get_organization_tags

List all attached tags of an organization.

Tool: edubase_get_organization_webhook

Get/check webhook configured in organization.

Tool: edubase_get_organizations

List owned and managed organizations.

Tool: edubase_get_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!

Tool: edubase_get_question_id

Get external unique question identifier by question identification string.

Tool: edubase_get_questions

List owned and managed Quiz questions.

Tool: edubase_get_quiz

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

Tool: edubase_get_quiz_permission

Check if a user has permission on a quiz.

Tool: edubase_get_quiz_play_results

Get detailed results for a specific Quiz play.

Tool: edubase_get_quiz_questions

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

Tool: edubase_get_quiz_results_user

Get user results for a specific Quiz set.

Tool: edubase_get_quiz_tag

Check if tag is attached to a Quiz.

Tool: edubase_get_quiz_tags

List all attached tags of a Quiz.

Tool: edubase_get_quizes

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

Tool: edubase_get_scorm_permission

Check if a user has permission on a SCORM learning material.

Tool: edubase_get_scorm_tag

Check if tag is attached to a SCORM learning material.

Tool: edubase_get_scorm_tags

List all attached tags of a SCORM learning material.

Tool: edubase_get_tag

Get/check tag.

Tool: edubase_get_tag_permission

Check if a user has permission on a tag.

Tool: edubase_get_tags

List owned and managed tags.

Tool: edubase_get_user

Get/check user. Can be used to retrieve the caller user's ID by using 'me' as the user identification string.

• Use 'me' to get the current user.

Tool: edubase_get_user_classes

List all classes a user is member of.

Tool: edubase_get_user_group

Get user's group.

Tool: edubase_get_user_login

Get latest valid login link for user.

Tool: edubase_get_user_name

Get user's name.

Tool: edubase_get_user_organizations

List all organizations a user is member of.

Tool: edubase_get_user_search

Lookup user by email, username or code.

Tool: edubase_get_users

List managed, non-generated users.

Tool: edubase_get_video_permission

Check if a user has permission on a video.

Tool: edubase_get_video_tag

Check if tag is attached to a video.

Tool: edubase_get_video_tags

List all attached tags of a video.

Tool: edubase_patch_integration

Update integration.

Tool: edubase_patch_organization

Update organization.

Tool: edubase_patch_organization_webhook

Update organizational webhook.

Tool: edubase_patch_user

Update user.

Tool: edubase_post_class_members

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

Tool: edubase_post_class_permission

Create new permission for a user on a class.

Tool: edubase_post_class_tag

Attach tag to a class.

Tool: edubase_post_class_transfer

Transfer class to user.

Tool: edubase_post_classes_members

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

Tool: edubase_post_course_permission

Create new permission for a user on a course.

Tool: edubase_post_course_tag

Attach tag to a course.

Tool: edubase_post_custom_metric

Update a custom metric.

Tool: edubase_post_event_permission

Create new permission for a user on an event.

Tool: edubase_post_event_tag

Attach tag to an event.

Tool: edubase_post_event_transfer

Transfer event to user.

Tool: edubase_post_exam

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.

• exam: regular exam
• championship: exam with championship features enabled
• homework: homework assignment, can be paused and continued during the exam period
• survey: survey (optionally anonymous) with no grading

Tool: edubase_post_exam_certificates_user_download

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

Tool: edubase_post_exam_permission

Create new permission for a user on an exam.

Tool: edubase_post_exam_summary

Submit a new AI exam summary.

• preferred values: openai / claude / gemini model|string|Exact LLM model name used to generate the summary summary|string|Summary text.
• basic HTML formatting allowed, but avoid complex designs
• keep the summary short and concise
• try to avoid including personal information (such as usernames, names and contact addresses) type|string|Type of summary. (default: ai)
• ai: AI-generated summary language|stringoptional|summary language

Tool: edubase_post_exam_tag

Attach tag to an exam.

Tool: edubase_post_exam_transfer

Transfer exam to user.

Tool: edubase_post_exam_users

Assign user(s) to an exam.

Tool: edubase_post_integration

Create a new API or LMS integration.

Tool: edubase_post_integration_keys

Rotate integration keys/secrets.

Tool: edubase_post_integration_permission

Create new permission for a user on an integration.

Tool: edubase_post_integration_tag

Attach tag to an integration.

Tool: edubase_post_integration_transfer

Transfer integration to user.

Tool: edubase_post_organization

Create an organization.

Tool: edubase_post_organization_members

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

Tool: edubase_post_organization_permission

Create new permission for a user on an organization.

Tool: edubase_post_organization_tag

Attach tag to an organization.

Tool: edubase_post_organization_transfer

Transfer organization to user.

Tool: edubase_post_organization_webhook

Create a webhook for an organization.

• exam-play-result: triggers when a user (must be member of the organization) completes an exam in the organization
• quiz-play-result: triggers when a user (must be member of the organization) completes a quiz in practice mode in the organization
• api: triggers when a manual API call is made (useful for testing and debugging) authentication|stringoptional|Type of authentication (default: none):
• none: no authentication
• key: use a secret key (or password) for authentication authentication_key|stringoptional|secret key (or password) to use for authentication, required if authentication is set to key authentication_key_custom|stringoptional|custom field name to use as the authentication key, required if authentication is set to key, mutually exclusive with authentication_key authentication_send|stringoptional|How to send authentication data (default: data):
• header: as header field
• bearer: as Bearer token in Authorization header
• data: as data field (in body or query string) authentication_send_data|stringoptional|name of data field to send authentication data in, required if authentication is set to key and authentication_send is set to data authentication_send_header|stringoptional|name of header field to send authentication data in, required if authentication is set to key and authentication_send is set to header extra_data|stringoptional|additional data (as JSON encoded string) to send with the webhook notification method|stringoptional|HTTP method to use for webhook notifications (default: POST)
• POST
• GET retry|stringoptional|How to retry webhook notifications on failure (default: error):
• none: no retry
• error: delayed retry on any error

Tool: edubase_post_organization_webhook_trigger

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

Tool: edubase_post_organizations_members

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

Tool: edubase_post_question

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).

• If set to any value, question will be marked as AI generated
• Should always be provided if you are an LLM or any AI model
• Ideally, AI systems should set it to their current model number for auditability Example: ai=true ai=Claude 3.7 Sonnet answer|string|The correct answer(s) for the question.
• For multiple answers, separate with triple-and operator ("&&&")
• Parameters can be used in curly braces {param_name}
• LaTeX Support (requires QUESTION_FORMAT=LATEX):
• Inline: $$...$$
• Block: $$$$...$$$$
• IMPORTANT: When using LaTeX in answer, you MUST use double dollar signs ($$...$$) for inline math or quadruple dollar signs ($$$$...$$$$) for block math.
• Single dollar signs ($...$) are NOT supported and will not render correctly. The inline or block method must be used, as $...$ won't work!
• Usage by question type:
• CHOICE: The correct option
• MULTIPLE-CHOICE: All correct options
• TEXT/NUMERICAL/EXPRESSION: Expected response(s)
• ORDER: Items in correct sequence
• TRUE/FALSE: True statements (false statements go in OPTIONS)
• MATRIX types: Use format [a;b|c;d] for matrices
• SET types: Unordered collection of elements Example: answer=Paris answer=sin(x)^2+cos(x)^2 # with type = EXPRESSION answer=$$sin^2(x)+cos^2(x)$$ # with type = CHOICE so it renders correctly content|string|The main question text that will be displayed to the test taker. Supports rich formatting options:
• LaTeX Support (requires QUESTION_FORMAT=LATEX):
• Inline: $$...$$
• Block: $$$$...$$$$
• IMPORTANT: When using LaTeX in questions, you MUST use double dollar signs ($$...$$) for inline math or quadruple dollar signs ($$$$...$$$$) for block math.
• Single dollar signs ($...$) are NOT supported and will not render correctly. The inline or block method must be used, as $...$ won't work!
• Parameters: Use curly braces {parameter_name} (defined in PARAMETERS field)
• Quick expressions: Use ~~~expression~~~ for simple parameter calculations, e.g., area of a circle is ~~~{r}*{r}*pi~~~
• Style formatting with EduTags:
• Bold: [[B]]...[[/B]]
• Italic: [[I]]...[[/I]]
• Underline: [[U]]...[[/U]]
• Subscript: [[SUB]]...[[/SUB]], Superscript: [[SUP]]...[[/SUP]]
• Code: [[CODE]]...[[/CODE]], [[CODEBLOCK]]...[[/CODEBLOCK]]
• Colors: [[COLOR:{color}]]...[[/COLOR]], [[BACKGROUND:{color}]]...[[/BACKGROUND]]
• Tables: Use [[..]] format with semicolons for columns, vertical bars for rows, e.g., [[Header 1; Header 2 | Data 1; Data 2]]
• Answer placeholders: [[___]] (3 underscores), for fill-in-the-gaps Example: content=Calculate the area of a circle with radius {r} using $$A = \pi r^2$$ id|string|External unique question identifier for question management. Should be maximum 64 characters long! On repeated uploads, the questions are updated (rather then added) based on this value, which can be an arbitrary text. If the question already exists at upload time with the same external identifier (in the given folder or Quiz set), the existing question will be updated instead of being added as a new one.
• Use cases:
• Integration with external systems
• Version control
• Batch updates
• Content synchronization
• Best practices:
• Use consistent naming conventions
• Include version, source or date information
• Consider hierarchical IDs for related content Example:
• id=MATHEMATICS_ARITHMETIC_BASIC_ADDITION_STATIC_001
• type=numerical
• content=What is 2+2?
• answer=4 language|string|The language of the question.
• Alpha-2 code according to ISO 639-1 Example: language=hu # Hungarian type|string|Type of the question. EduBase supports various question types to accommodate different assessment needs:
• Basic Types:
• GENERIC: Strict matching including spaces and punctuation
• TEXT: Basic text input with flexible matching (ignores spaces and punctuation)
• FREE-TEXT: Extended text response with semi-automatic grading
• READING: Non-assessed text display for complex question groups
• Choice-Based Types:
• CHOICE: Single correct answer selection
• MULTIPLE-CHOICE: Multiple correct answers
• ORDER: Sequence arrangement (arrange items in correct order)
• TRUE/FALSE: Statement evaluation (true statements in ANSWER, false in OPTIONS)
• Numerical Types:
• NUMERIC: Numerical value validation with fractions, constants, intervals
• DATE/TIME: Calendar date validation with adjustable precision
• EXPRESSION: Mathematical expression evaluation
• Advanced Types:
• MATRIX/MATRIX:EXPRESSION: Matrix evaluation (format: [a;b|c;d] for 2x2)
• SET/SET:TEXT: Unordered collection validation
• FILE: File submission evaluation Example: type=numerical answer_format|stringoptional|Defines how to display the answer on the results page.
• Only applicable for FREE-TEXT questions
• Format: type or type:value
• Available types:
• normal: standard text (default)
• code: with syntax highlighting (specify language after colon) Example: answer_format=code:python answer_format=code:sql Example API call: id=sql_basics type=free-text content=Write a SQL query to select all columns from the "users" table where the age is greater than 18. answer=SELECT * FROM users WHERE age > 18 answer_format=code:sql answer_hide|stringoptional|Controls whether correct answers are hidden on the results page.
• Plus sign (+) to indicate YES
• Blank field or minus sign (-) indicates NO (default)
• Useful for test security and preventing answer sharing
• Critical for reusable questions and practice tests Example: answer_hide=+ Example API call: id=uk_countries type=text content=Name any of the countries within the United Kingdom! answer=England &&& Northern Ireland &&& Scotland &&& Wales answer_require=1 answer_hide=+ answer_indefinite|stringoptional|Allows users to add any number of input fields using + and - buttons.
• Plus sign (+) to indicate YES
• Blank field or minus sign (-) indicates NO (default)
• Answer labels will not appear when this is enabled
• Ideal for brainstorming exercises or questions with variable number of answers Example: answer_indefinite=+ Example API call: id=name_countries type=text content=Name as many European countries as you can think of. answer=France &&& Germany &&& Italy &&& Spain &&& United Kingdom &&& ... answer_indefinite=+ answer_label|stringoptional|Text displayed in/above the input field during the test.
• Separate multiple labels with triple-and operators ("&&&")
• Automatically activates the answer_order function
• Perfect for multi-part questions where each part needs clear labeling
• Useful for creating pairing/matching questions Example: answer_label=a) Distance (km) &&& b) Time (hours) &&& c) Speed (km/h) Example API call: id=basic_math type=numerical content=Given the number 16:\n\na) What is double this number?\n\nb) What is half of this number?\n\nc) What is this number plus 10? answer=32 &&& 8 &&& 26 answer_label=a) Double &&& b) Half &&& c) Plus 10 points=3 answer_order|stringoptional|Controls whether the sequence of multiple answers matters.
• Plus sign (+) to indicate YES
• Blank field or minus sign (-) indicates NO (default)
• When using answer_label, this is automatically activated
• Essential for questions where sequence is important (e.g., steps in a process) Example: answer_order=+ Example API call: id=europe_cities_population type=text content=List the following European cities in descending order by population (largest first) answer=London &&& Madrid &&& Paris answer_order=+ answer_require|stringoptional|Number of answers required for maximum score.
• Not applicable for CHOICE and FREE-TEXT questions
• Perfect for questions with multiple valid answers where only a subset needs to be provided
• Useful when asking students to provide any X examples from a larger set Example: answer_require=3 Example API call: id=uk_countries type=text content=Name any one of the countries within the United Kingdom! answer=England &&& Northern Ireland &&& Scotland &&& Wales answer_require=1 attachment|stringoptional|Attach a file to the question. Format: filename=data, where data is either a base64-encoded image or a URL category|stringoptional|Category, another layer of organization as seen in SUBJECT constraints|stringoptional|Define rules that parameter combinations must satisfy.
• Mathematical expressions that must evaluate to true
• Parameters must be in curly braces {param}
• Allowed relations: <, <=, =, >=, >, <>
• Multiple constraints separated by triple-and operators ("&&&") Examples: constraints={b}^2-4*{a}*{c}>0 constraints={a}+{b}>{c} &&& {b}+{c}>{a} &&& {c}+{a}>{b} constraints={x}+{y}<10 &&& {x}<4 datetime_precision|stringoptional|Date/time precision.
• Applicable only for DATE/TIME questions
• Accepted values: YEAR / MONTH / DAY (default)
• Defines granularity of date validation Example: datetime_precision=MONTH datetime_range|stringoptional|Date/time range (interval) question.
• Applicable only for DATE/TIME questions
• Plus sign (+) to indicate YES, while blank field or minus sign (-) indicates NO (default)
• Enables date range responses with the format {from}-{to} Example: datetime_range=+ decimals|stringoptional|Decimal precision (default: 2).
• Applicable only for NUMERIC / EXPRESSION / MATRIX / MATRIX:EXPRESSION / SET questions
• The expected decimal precision of the final answer
• Examples: Finance (decimals=2), Chemistry (decimals=4) Example: decimals=3 explanation|stringoptional|Text displayed underneath the answer on the results page.
• Explanation of the correctness of the answer or the incorrectness of the options
• Helps learners understand their mistakes
• Parameters can be used in explanations
• LaTeX is NOT supported here, so we MUST NOT use it! Example: explanation=Option A is correct because amphibians have permeable skin for gas exchange. Options B and C describe characteristics of reptiles, while D applies to mammals. expression_check|stringoptional|Define how expressions should be validated (RANDOM, EXPLICIT, COMPARE) (default: RANDOM).
• RANDOM: Evaluates expressions at randomly generated points
• EXPLICIT: Checks expressions at predefined values against target values
• COMPARE: Direct comparison of expressions without variables Example: expression_check=RANDOM expression_decimals|stringoptional|Sets precision for decimal calculations (default: 2).
• Inherited from decimals field if not specified
• Critical for controlling accurate validation of expressions Example: expression_decimals=4 # For high-precision calculations expression_explicit_goal|stringoptional|Define exact value pairs (format: [x;f(x)]).
• Format for multiple variables: [x;y;z;...;f(x,y,z,...)]
• Multiple pairs: separate with &&&
• Only applicable when expression_check=EXPLICIT Example: expression_explicit_goal=[0;1] &&& [3;8.89] &&& [9;16] expression_extended|stringoptional|Enable additional mathematical functions (+ to enable, - to disable).
• Activates support for custom base logarithms (e.g., log2(4))
• Enables factorial operations (e.g., 5!, 1!+2!+3!) Example: expression_extended=+ expression_functions|stringoptional|Controls whether functions can be used in user inputs (+ for yes, - for no) (default: +).
• Enabled by default with + sign
• Disable with - sign when students should use alternative forms
• Affects available input options for test takers
• Supported functions include:
  • Basic: sqrt, abs, round, floor, ceil
  • Logarithmic: ln, log, log10
  • Trigonometric: sin, cos, tan, csc, sec, arcsin/asin, arccos/acos, arctan/atan
  • Hyperbolic: sinh, cosh, tanh, arcsinh/asinh, arccosh/acosh, arctanh/atanh
  • Conversions: degree2radian, radian2degree, number2binary, number2hexadecimal, roman2number, etc.
  • Two-parameter (use semicolon separator): min(a;b), max(a;b), mod(n;i), fmod(n;i), div(a;b), intdiv(a;b), gcd(a;b), lcm(a;b), number2base(n;b), base2number(n;b), combinations(n;k), combinations_repetition(n;k), variations(n;k), variations_repetition(n;k) Example: expression_functions=- # Forces students to expand rather than use functions.

When asked for the value of sin(pi), the user can't input sin(pi) because functions cannot be used.

expression_random_inside|stringoptional|Require values within specific intervals (format: [start-end]).

• Multiple intervals: separate with ||| (OR relationship)
• Specify per variable with &&&
• Only applicable when expression_check=RANDOM Example: expression_random_inside=[4-8] ||| [12-16] &&& [2-3] expression_random_outside|stringoptional|Exclude values from specific intervals (format: [start-end]).
• Multiple intervals: separate with ||| (AND relationship)
• Specify per variable with &&&
• Only applicable when expression_check=RANDOM Example: expression_random_outside=[0-1] ||| [10-20] &&& [8-11] expression_random_range|stringoptional|Define value generation ranges (format: [min-max]).
• Specify per variable with &&&
• Only applicable when expression_check=RANDOM Example: expression_random_range=[8-16] &&& [4-6] # Different ranges for different variables expression_random_tries|stringoptional|Number of validation points (default: 5).
• Only applicable when expression_check=RANDOM
• Higher values increase validation reliability but impact performance Example: expression_random_tries=8 expression_random_type|stringoptional|Type of generated test values (INTEGER, FLOAT).
• Specify per variable with &&&
• Only applicable when expression_check=RANDOM Example: expression_random_type=INTEGER &&& FLOAT # For mixed type validation expression_variable|stringoptional|Specifies variable names used in expressions (separate multiple variables with &&&) (default: x).
• Multiple variables can be used for multivariable expressions
• Variable names must be used consistently in answer and validation Examples: expression_variable=t &&& v # For distance formula using time and velocity freetext_characters|stringoptional|Limit the number of characters that can be entered.
• Applicable only for FREE-TEXT questions
• Format: minimum-maximum, but you can specify only a minimum or maximum as well
• Integer(s) between 0-4000 Example: freetext_characters=100-1000 freetext_characters=10- # Minimum 10 characters freetext_rules|stringoptional|Automatic evaluation of free text questions.
• Applicable only for FREE-TEXT questions
• Notation: {type; keywords}
• Type:
• 1: if keywords are included within input, answer is correct (maximum points)
• 2: if keywords are included within input, answer is wrong (0 points)
• 3: if no keywords are included within input, answer is good (maximum points)
• 4: if keywords are not included within input, answer is wrong (0 points)
• Keywords: comma-separated list (must not contain semicolons!) Example: freetext_rules={1; mitochondria, ATP, cellular respiration} freetext_words|stringoptional|Limit the number of words that can be entered.
• Applicable only for FREE-TEXT questions
• Format: minimum-maximum, but you can specify only a minimum or maximum as well
• Integer(s) between 0-4000 Example: freetext_words=-50 # Max. 50 words group|stringoptional|Add a question to a question group in a Quiz set.
• If the group doesn't exist, it will be created automatically as a complex task with default settings
• Only applicable when uploading DIRECTLY to a Quiz set
• Existing group settings will not be changed when adding more questions Example: group=Basic_Arithmetic hint|stringoptional|Questions to help (not solution steps, just guiding questions/notes).
• LaTeX code can be used (as described in QUESTION)
• IMPORTANT: When using LaTeX in hints, you MUST use double dollar signs ($$...$$) for inline math or quadruple dollar signs ($$$$...$$$$) for block math.
• Single dollar signs ($...$) are NOT supported and will not render correctly. The inline or block method must be used, as $...$ won't work!
• Specify multiple hints separated by triple-and operators ("&&&")
• Not available for test takers in exam mode
• Displayed only when explicitly requested, one by one
• Can be penalized using HINT_PENALTY Example: hint=Think about the relationship between radius and area &&& Remember the formula for circle area involves $\pi$ &&& Square the radius and multiply by $\pi$ hint_penalty|stringoptional|Point deduction for using hints/solutions/videos during a test.
• Format: type or type:value
• Types:
• NONE: No penalty (default)
• ONCE:N%: Single deduction regardless of number used
• PER-HELP:N%: Deduction for each hint (only for HINT_PENALTY) Examples: hint_penalty=ONCE:20% or hint_penalty=ONCE:0.2 hint_penalty=PER-HELP:10% solution_penalty=ONCE:50% video_penalty=ONCE:15% Example API call with comprehensive penalty system: id=area_circle_parametric type=expression content=Find an expression for the area of a circle with radius {r}. answer=pi*{r}^2 parameters={r; INTEGER; 2; 10} points=10 subject=Mathematics category=Geometry hint=Think about the formula for circle area &&& Remember that area involves squaring the radius solution=The formula for circle area is $$\pi r^2$$ penalty_scoring=PER_ANSWER penalty_points=3 hint_penalty=PER-HELP:10% solution_penalty=ONCE:50%

Each hint used reduces score by 10%, viewing solution reduces score by 50%

image|stringoptional|Attach an image to the question. Supported formats: PNG, JPEG, WebP Format: filename=data, where data is either a base64-encoded image or a URL labels|stringoptional|Categorize questions with instance-level labels.

• Pre-defined values specific to each EduBase instance
• Values controlled by instance administrators (cannot be created by users)
• Consistent across all users in an instance
• Specify multiple labels separated by triple-and operators ("&&&")
• Use cases include:
• System-wide flags (e.g., "needs_review", "featured")
• Quality indicators (e.g., "verified", "deprecated")
• Processing status (e.g., "ai_generated", "manually_checked") Example: label=verified &&& featured main_category|stringoptional|The name of the category (for which CATEGORY will be a subcategory).
• Empty by default, e.g. CATEGORY will be treated as the main category
• Specify multiple levels (up to 2!) by using the triple-per operator (///) with highest main category on the left Example: main_category=Analytic Geometry /// Vectors manual_scoring|stringoptional|Controls when to enable manual scoring.
• Not applicable for READING and FREE-TEXT questions
• Available values:
• NO: Never use manual scoring (default)
• NOT_CORRECT: Only manually score incorrect answers
• ALWAYS: Always require manual scoring Example: manual_scoring=NOT_CORRECT media_audio|stringoptional|Attach an audio file to the question. Supported formats: MP3, AAC, M4A Format: filename=data, where data is either a base64-encoded image or a URL note|stringoptional|The text that appears right below the question.
• Provides task-specific comments and instructions
• Visible to test takers during the quiz
• Ideal for additional guidance without cluttering the main question Example: note=Use standard atmospheric pressure in your calculations. numerical_range|stringoptional|Number range (interval) question.
• Only applicable for NUMERIC questions
• Plus sign (+) to indicate YES, while blank field or minus sign (-) indicates NO (default)
• Enables interval responses with the format {from}-{to} Example: numerical_range=+ options|stringoptional|Incorrect options or false statements for choice-based question types.
• Required for CHOICE, MULTIPLE-CHOICE question types
• For TRUE/FALSE, these are the false statements (ANSWER contains true statements)
• Separate multiple options with triple-and operators ("&&&")
• Parameters can be used in curly braces {param_name}
• LaTeX Support (requires QUESTION_FORMAT=LATEX):
• Inline: $$...$$
• Block: $$$$...$$$$
• IMPORTANT: When using LaTeX in questions, you MUST use double dollar signs ($$...$$) for inline math or quadruple dollar signs ($$$$...$$$$) for block math.
• Single dollar signs ($...$) are NOT supported and will not render correctly. The inline or block method must be used, as $...$ won't work! Example: options=London &&& Berlin &&& Madrid Example API call: id=capital_france type=choice content=What is the capital of France? answer=Paris options=London &&& Berlin &&& Madrid options_fix|stringoptional|Controls the arrangement of answers and options.
• Available values:
• all: Answers appear first, followed by options
• abc: Sort all items (answers and options) alphabetically
• first:N: Place first N options at the end
• last:N: Place last N options at the end
• answers: Place all answers at the end
• Useful for maintaining consistent presentation or for specific pedagogical purposes For alphabetical ordering:
• When migrating content from textbooks or past exams, can maintain original lettering system (a, b, c...) for:
• Reference consistency with printed materials
• Alignment with answer keys
• Compatibility with existing grading systems
• Cross-referencing with study guides
• Particularly valuable when:
• Test takers need to refer to both digital and printed materials
• Questions are part of a larger standardized test system
• Maintaining consistency with existing worksheets or textbooks
• Digitizing legacy assessment materials Example: options_fix=abc Example API call: id=fruit_types type=multiple-choice content=Which of these are citrus fruits? answer=Lemon &&& Orange options=Apple &&& Banana &&& Grape options_fix=abc Example API call: id=vocab_synonyms type=multiple-choice content=Select all words that mean "happy": answer=b) Joyful &&& d) Merry options=a) Angry &&& c) Sleepy &&& e) Tired options_fix=abc options_order|stringoptional|Define exact presentation order of answers and options.
• Format: ANSWER:N or OPTION:N items separated by "&&&"
• ANSWER:N references the Nth provided answer
• OPTION:N references the Nth provided option
• OPTION_NONE:N references the Nth third option (for TRUE/FALSE questions)
• All answers and options must be specified exactly once Example: options_order=OPTION:0 &&& ANSWER:0 &&& OPTION:1 &&& ANSWER:1 Example API call to create a chronologically ordered timeline id=historical_chronology type=multiple-choice content=Which of these events occurred during the Industrial Revolution (1760-1840)? answer=Invention of the Steam Engine &&& First Steam Locomotive &&& First Commercial Railway options=Printing Press Invented &&& First Electric Light Bulb &&& First Powered Flight options_order=OPTION:0 &&& ANSWER:0 &&& ANSWER:1 &&& ANSWER:2 &&& OPTION:1 &&& OPTION:2 parameters|stringoptional|Parameter definitions for dynamic question generation. One of EduBase's most powerful features, allowing creation of dynamic questions where each user gets a unique variant of the same question.
• Separate multiple parameters with triple-and operators ("&&&")
• Up to 128 parameters can be defined Parameter Types:

1. FIX (Fixed Value):

• Format: {name; FIX; value}
• Sets a predefined constant value (integer or fraction)
• Example: {pi; FIX; 3.1415}

1. INTEGER (Whole Numbers):

• Simple: {name; INTEGER}
• Extended: {name; INTEGER; min; max}
• Full: {name; INTEGER; min; max; inside; outside}
• Generate random integers within specified ranges
• Use '-' for omitting min/max values
• Examples:

• {p; INTEGER} - any integer
• {p; INTEGER; 10; 20} - integer between 10 and 20 (inclusive)
• {p; INTEGER; -; -; [10-20]; [12-14] ||| [16-18]} - integer between 10-20, excluding 12-14 and 16-18

1. FLOAT (Decimal Numbers):

• Simple: {name; FLOAT; precision}
• Extended: {name; FLOAT; precision; min; max}
• Full: {name; FLOAT; precision; min; max; inside; outside}
• Generate random decimal numbers
• Specify precision (decimal places)
• Examples:

• {p; FLOAT; 2} - float with 2 decimal places
• {p; FLOAT; 5; 0; 1} - float between 0 and 1 with 5 decimals
• {p; FLOAT; 1; 0; 10; -; [0-1]} - float between 0-10 excluding 0-1, with 1 decimal

1. FORMULA (Expressions):

• Simple: {name; FORMULA; formula}
• Full: {name; FORMULA; formula; precision}
• Define parameters based on other parameters
• Examples:

• {d; FORMULA; {b}^2-4*{a}*{c}} - quadratic formula discriminant
• {p; FORMULA; 2*{q}+1} - linear expression

1. LIST (Random Selection):

• Format: {name; LIST; value1; value2; value3; ...}
• Randomly select from predefined values
• Up to 64 elements
• Examples:

• {primes; LIST; 2; 3; 5; 7; 11}
• {animals; LIST; dog; cat; snake; camel}

1. PERMUTATION:

• Format: {name; PERMUTATION; value1; value2; value3; ...}
• Creates permutated parameters accessible as {name_1}, {name_2}, etc.
• Example: {p; PERMUTATION; A; B; C; D}

• So {p_1} will be a different letter than {p_2}

• Example: {primes; PERMUTATION; 2; 3; 5; 7}

• So both {primes_1} and {primes_2} will be different single digit primes

1. FORMAT:

• Format: {name; FORMAT; parameter; type; ...}
• Format parameters based on other parameters
• Supported types: NUMBER, NUMERTEXT, ROMAN
• Optional extra parameters based on type

• NUMBER
• precision: number of decimal places

• Examples:

• {pp; FORMAT; p; NUMBER; 1} - format as number rounded to 1 decimal
• {pp; FORMAT; p; NUMBERTEXT} - format number as text
• {pp; FORMAT; p; ROMAN} - format number as Roman numeral Best Practices:

• Order parameters so dependent ones come later
• Use simple notation when possible
• Avoid unnecessary parameters
• Use CONSTRAINTS field to ensure valid combinations Examples: parameters={pi; FIX; 3.14159} &&& {r; INTEGER; 1; 10} parameters={a; INTEGER; 1; 5} &&& {b; INTEGER; -10; 10} &&& {c; INTEGER; -10; 10} &&& {d; FORMULA; {b}^2-4*{a}*{c}} parameters={country; LIST; France; Germany; Italy} &&& {capital; LIST; Paris; Berlin; Rome} parameters_sync=+ # Ensures each country is paired with its correct capital parameters_sync|stringoptional|Controls synchronization of LIST parameter selections.
• Plus sign (+) to indicate YES
• Blank field or minus sign (-) indicates NO (default)
• When enabled, the Nth value from each LIST is selected together
• Critical for paired data like countries and capitals Example: parameters_sync=+ Example API call: id=capital_city type=text content=What is the capital city of {country}? answer={capital} parameters={country; LIST; France; Germany; Italy} &&& {capital; LIST; Paris; Berlin; Rome} parameters_sync=+ path|stringoptional|Path where question will be stored in personal QuestionBase.
• Default: /API
• Supports hierarchical structure with forward slashes
• Always start with a forward slash! Example: path=/Mathematics/Calculus/Derivatives penalty_points|stringoptional|Points deducted for completely incorrect answers.
• No penalty applied if answer is partially correct
• No penalty for empty/unanswered questions
• Use positive values (recommended) Example: penalty_points=2 Example API call with penalties: id=physics_multiple_choice type=multiple-choice content=Which of the following are forms of energy? Select all that apply. answer=Kinetic &&& Potential &&& Thermal options=Velocity &&& Acceleration points=3 penalty_scoring=PER_QUESTION penalty_points=1 penalty_scoring|stringoptional|Controls how penalty points should be applied.
• Available values:
• DEFAULT: Standard penalty application, which might vary by question type (default)
• PER_ANSWER: Apply penalties for each incorrect answer
• PER_QUESTION: Apply penalties once per question Example: penalty_scoring=PER_ANSWER points|stringoptional|Maximum points for a fully correct answer.
• Default: 1 point
• For questions with multiple answers, partial credit is possible based on SUBSCORING method Example: points=10 private_note|stringoptional|Private notes (not shown to test takers).
• Internal documentation for question creators and editors
• Useful for documenting question creation rationale
• Track modification history, common mistakes, related questions Example: private_note=Created from Chapter 3 exam, 2023 edition. Students often forget to convert units. question_format|stringoptional|Controls question text rendering.
• NORMAL: Default text formatting with standard font size, recommended for most tasks
• LATEX: Enables LaTeX for mathematical, scientific notations (using KaTeX)
• LONG: Smaller font with automatic paragraph breaks (ideal for lengthy text) Example: question_format=LATEX solution|stringoptional|Step-by-step solution.
• LaTeX code can be used (as described in QUESTION)
• IMPORTANT: When using LaTeX in solution, you MUST use double dollar signs ($$...$$) for inline math or quadruple dollar signs ($$$$...$$$$) for block math.
• Single dollar signs ($...$) are NOT supported and will not render correctly. The inline or block method must be used, as $...$ won't work!
• Specify multiple solution steps separated by triple-and operators ("&&&")
• Each step is displayed one at a time
• Can be penalized using SOLUTION_PENALTY
• Not available in exam mode Example: solution=Using the power rule, we differentiate each term: &&& For $x^2$: $\frac{d}{dx}(x^2) = 2x$ &&& For $x$: $\frac{d}{dx}(x) = 1$ &&& The constant term disappears: $\frac{d}{dx}(5) = 0$ &&& Therefore, $\frac{d}{dx}(x^2 + x + 5) = 2x + 1$ solution_image|stringoptional|Attach an image to the solution steps. Supported formats: PNG, JPEG, WebP Format: filename=data, where data is either a base64-encoded image or a URL solution_penalty|stringoptional|Similar to HINT_PENALTY Point deduction for viewing steps of the solution (NONE, ONCE:N%) (default: NONE) source|stringoptional|Specify source of question content (not shown to test takers).
• Use cases include training material sources, documentation references, content attribution
• Important for tracking question origins and copyright compliance Example: source=Mathematics Textbook Chapter 5, Page 123 source=Company Safety Manual 2023, Section 3.4.2 subject|stringoptional|Subject classification for organizing questions.
• Provides primary categorization for content organization
• Use the question editor in the EduBase UI for an up-to-date list of possible values Example: subject=Mathematics category=Algebra subpoints|stringoptional|Define specific point values for each answer in percentages.
• Only used when subscoring=CUSTOM
• Specify percentage values separated by triple-and operators ("&&&")
• Not applicable for CHOICE, READING and FREE-TEXT questions
• Values should sum to 100 (for percentage) Example: subpoints=50 &&& 25 &&& 25 Example meaning: For a 10-point question with three answers:
• First answer: 5 points (50%)
• Second answer: 2.5 points (25%)
• Third answer: 2.5 points (25%) subscoring|stringoptional|Method for calculating partial credit for partially correct answers.
• Not applicable for CHOICE, READING and FREE-TEXT questions
• Available values:
• PROPORTIONAL: Points awarded proportionally to correct answers (default)
• LINEAR_SUBSTRACTED:N: Linear scoring with N points subtracted for each error
• CUSTOM: Use custom point distribution defined in SUBPOINTS field
• NONE: No partial credit, all-or-nothing scoring Example: subscoring=LINEAR_SUBSTRACTED:2 Example API call: id=math_problem type=numerical content=What is the sum and product of {a} and {b}? answer={a}+{b} &&& {a}*{b} parameters={a; INTEGER; 1; 100} &&& {b; INTEGER; 1; 100} points=4 subscoring=CUSTOM subpoints=25 &&& 75 tags|stringoptional|Tag questions with custom user-defined tags.
• Use ID or code of pre-registered tags
• Only previously registered tags can be used (must be pre-registered in EduBase UI)
• Specify multiple tags separated by triple-and operators ("&&&")
• User-controlled categorization that can be created at user or organization level
• Use cases include:
• Personal content organization (e.g., "My Calculus Questions", "Spring 2024")
• Department-level categorization (e.g., "IT Department", "CS101")
• Custom taxonomies for specialized content organization
• Tags are flexible, customizable, and searchable in the UI Example: tags=Algebra &&& High School &&& Exam Prep tolerance|stringoptional|Evaluation tolerance method.
• Applicable only for NUMERIC / EXPRESSION / MATRIX / MATRIX:EXPRESSION / SET questions
• Notation: type or type:value
• Types:
• ABSOLUTE: maximum difference between answer and user input
  • Example: ABSOLUTE:0.1
• RELATIVE: maximum difference in percentage (symmetric mean absolute percentage error, SMAP value is used)
  • Example: RELATIVE:5% or RELATIVE:0.05
• QUOTIENT: integer multiple / QUOTIENT2: scalar multiple
  • Example: QUOTIENT or QUOTIENT2:SYNCED Example: tolerance=ABSOLUTE:0.01 truefalse_third_options|stringoptional|Activate the third option for TRUE/FALSE questions.
• Plus sign (+) to display the third option OR
• Specify options separated by triple-and operators ("&&&") to automatically enable the feature
• Parameters can be used in curly braces {param_name} Example: truefalse_third_options=Cannot be determined from the information given &&&Not applicable truefalse_third_options_label|stringoptional|Label of the third option for TRUE/FALSE questions.
• If blank, the text "none" is displayed (default)
• Only applicable when TRUEFALSE_THIRD_OPTIONS is enabled Example: truefalse_third_options_label=Not enough information video_penalty|stringoptional|Similar to HINT_PENALTY Point deduction for video assistance used (NONE, ONCE:N%) (default: NONE)

Tool: edubase_post_question_export

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

Tool: edubase_post_question_id

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

Tool: edubase_post_quiz

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

• TEST: all questions are displayed at once, user can answer them in any order and switch between them
• TURNS: questions are displayed one by one, only one question is visible at a time and the user must answer it before moving to the next question

type|stringoptional|Type of the Quiz set. (default: set)

• set: for practice purposes
• exam: for exam purposes
• private: for private purposes (e.g testing)

Tool: edubase_post_quiz_permission

Create new permission for a user on a quiz.

Tool: edubase_post_quiz_questions

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

Tool: edubase_post_quiz_tag

Attach tag to a Quiz.

Tool: edubase_post_quiz_transfer

Transfer Quiz to user.

Tool: edubase_post_scorm_permission

Create new permission for a user on a SCORM learning material.

Tool: edubase_post_scorm_tag

Attach tag to a SCORM learning material.

Tool: edubase_post_scorm_transfer

Transfer SCORM to user.

Tool: edubase_post_tag_permission

Create new permission for a user on a tag.

Tool: edubase_post_tag_transfer

Transfer tag to user.

Tool: edubase_post_user

Create new EduBase user account.

Tool: edubase_post_user_assume

Assume user for next requests with assume token.

Tool: edubase_post_user_classes

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

Tool: edubase_post_user_group

Update a user's group.

Tool: 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.

Tool: edubase_post_user_name

Update a user's name.

Tool: edubase_post_user_organizations

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

Tool: edubase_post_video_permission

Create new permission for a user on a video.

Tool: edubase_post_video_tag

Attach tag to a video.

Tool: edubase_post_video_transfer

Transfer video to user.

Use this MCP Server

{
  "mcpServers": {
    "edubase": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "EDUBASE_API_APP",
        "-e",
        "EDUBASE_API_URL",
        "-e",
        "EDUBASE_API_KEY",
        "mcp/edubase"
      ],
      "env": {
        "EDUBASE_API_APP": "YOUR_EDUBASE_API_APP",
        "EDUBASE_API_URL": "YOUR_EDUBASE_API_URL",
        "EDUBASE_API_KEY": "YOUR_EDUBASE_API_KEY"
      }
    }
  }
}

Why is it safer to run MCP Servers with Docker?⁠