EduBase MCP Server

Official

Overview Schema Source Related Servers Discussions Admin

edubase_put_exam_certificates

Idempotent

Replace an exam's certificate configuration with a preset or copy it from another exam, including images. Certificates must be enabled and the exam unlocked.

Instructions

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.

Input Schema

TableJSON Schema

Name	Required	Description
`exam`	Yes	exam identification string (the target exam)
`preset`	No	certificate preset identification string (see edubase_get_exam_certificates_presets), the settings of the preset are applied to the exam, and they are kept up to date with the preset
`source`	No	exam identification string to copy the certificate configuration from, must be different from the target exam, and its certificates have to be configured manually (not by a preset), the images (signatures, stamp and logo) are copied as well

Output Schema

TableJSON Schema

Name	Required	Description	Default
`exam`	Yes
`notes`	No
`renew`	No
`text1`	No
`text2`	No
`title`	No
`preset`	No
`enabled`	Yes
`language`	No
`timezone`	No
`text_date`	No
`configured`	Yes
`email_send`	No
`expiration`	No
`show_custom`	No
`show_result`	No
`show_serial`	No
`custom_fields`	No
`hide_timezone`	No
`result_format`	No
`serial_format`	No
`serial_prefix`	No
`branding_image`	No
`branding_line1`	No
`branding_line2`	No
`branding_line3`	No
`branding_line4`	No
`manual_renewal`	No
`show_signature`	No
`signature_left`	No
`signature_user`	No
`show_expiration`	No
`signature_right`	No
`signature_stamp`	No
`branding_edubase`	No
`serial_separator`	No
`supervisors_only`	No
`grading_threshold`	No
`custom_user_fields`	No
`serial_index_digits`	No
`show_custom_branding`	No
`signature_left_image`	No
`signature_left_line1`	No
`signature_left_line2`	No
`signature_left_line3`	No
`signature_left_line4`	No
`signature_right_image`	No
`signature_right_line1`	No
`signature_right_line2`	No
`signature_right_line3`	No
`signature_right_line4`	No
`download_automatically`	No
`show_birthdate_birthplace`	No
`automatic_renewal_approval`	No
`expiration_notification_emails`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed55 schema fields changedv2.0.0Sep 15, 2026

removedOutput schema / properties / automatic_renewal_approval / description

Removed value: -"the renewal is approved automatically, but it stays revocable (only present if show_expiration is enabled)"

removedOutput schema / properties / branding_edubase / description

Removed value: -"the EduBase logo is displayed (only present if show_custom_branding is enabled)"

removedOutput schema / properties / branding_image / description

Removed value: -"the uploaded logo is displayed (only present if show_custom_branding is enabled)"

removedOutput schema / properties / branding_line1 / description

Removed value: -"name of the organization (only present if show_custom_branding is enabled)"

removedOutput schema / properties / branding_line2 / description

Removed value: -"second line of the branding (only present if show_custom_branding is enabled)"

removedOutput schema / properties / branding_line3 / description

Removed value: -"third line of the branding (only present if show_custom_branding is enabled)"

removedOutput schema / properties / branding_line4 / description

Removed value: -"fourth line of the branding (only present if show_custom_branding is enabled)"

removedOutput schema / properties / configured / description

Removed value: -"the certificates are configured, so they can be issued"

removedOutput schema / properties / custom_fields / description

Removed value: -"custom user data displayed as extra data (only present if show_custom is enabled), the custom user data fields of the exam are identified by their label (see edubase_get_exam_fields), the data fields of the user accounts by their customer_ prefixed name"

removedOutput schema / properties / custom_user_fields / description

Removed value: -"custom user data displayed together with the data of the examinee (only present if show_custom is enabled)"

removedOutput schema / properties / download_automatically / description

Removed value: -"the certificate is downloaded automatically when the examinee opens the results page"

removedOutput schema / properties / email_send / description

Removed value: -"the certificates are sent to the examinees in email automatically"

removedOutput schema / properties / enabled / description

Removed value: -"certificates are issued for the exam, the configuration itself is only returned when the certificates are enabled"

removedOutput schema / properties / exam / description
```
Removed value: -"exam identification string"
```

removedOutput schema / properties / expiration / description

Removed value: -"validity period of the certificates in days (only present if show_expiration is enabled)"

removedOutput schema / properties / expiration_notification_emails / description

Removed value: -"email addresses notified about the expiring certificates (only present if show_expiration is enabled)"

removedOutput schema / properties / grading_threshold / description

Removed value: -"threshold of the certificates in percentage, overriding the threshold of the grading, null if the threshold of the grading is used"

removedOutput schema / properties / hide_timezone / description
```
Removed value: -"the timezone information is hidden"
```
removedOutput schema / properties / language / description
```
Removed value: -"language of the certificates"
```

removedOutput schema / properties / manual_renewal / description

Removed value: -"the renewal has to be approved by a supervisor (only present if show_expiration is enabled)"

removedOutput schema / properties / notes / description

Removed value: -"notes displayed at the bottom of the certificates"

removedOutput schema / properties / preset / description

Removed value: -"identification string of the certificate preset configuring the certificates (see edubase_get_exam_certificates_presets), null if the certificates are configured manually"

removedOutput schema / properties / renew / description

Removed value: -"whether the certificates can be renewed (only present if show_expiration is enabled), false: the certificates cannot be renewed, true: the certificates can be renewed any time, number: the number of days the renewal is available from, relative to the expiry (0 is the day of the expiry, negative values open the renewal before it)"

removedOutput schema / properties / result_format / description

Removed value: -"format of the displayed result (only present if show_result is enabled)"

removedOutput schema / properties / serial_format / description

Removed value: -"format of the serial numbers (only present if show_serial is enabled)"

removedOutput schema / properties / serial_index_digits / description

Removed value: -"minimum length of the index in the serial numbers (only present if show_serial is enabled)"

removedOutput schema / properties / serial_prefix / description

Removed value: -"prefix of the serial numbers (only present if show_serial is enabled)"

removedOutput schema / properties / serial_separator / description

Removed value: -"separator between the parts of the serial numbers (only present if show_serial is enabled)"

removedOutput schema / properties / show_birthdate_birthplace / description

Removed value: -"the birth date and the birth place of the examinee are displayed"

removedOutput schema / properties / show_custom / description
```
Removed value: -"custom user data is displayed"
```

removedOutput schema / properties / show_custom_branding / description

Removed value: -"custom branding (logo and organization name) is displayed"

removedOutput schema / properties / show_expiration / description

Removed value: -"the certificates expire and their validity is displayed"

removedOutput schema / properties / show_result / description
```
Removed value: -"the result of the test is displayed"
```
removedOutput schema / properties / show_serial / description
```
Removed value: -"the certificates get a serial number"
```
removedOutput schema / properties / show_signature / description
```
Removed value: -"signatures are displayed"
```

removedOutput schema / properties / signature_left / description

Removed value: -"the signature of the first organizer is displayed (only present if show_signature is enabled)"

removedOutput schema / properties / signature_left_image / description

Removed value: -"the uploaded image of the first signature is displayed (only present if show_signature is enabled)"

removedOutput schema / properties / signature_left_line1 / description

Removed value: -"name of the first organizer (only present if show_signature is enabled)"

removedOutput schema / properties / signature_left_line2 / description

Removed value: -"second line of the first signature (only present if show_signature is enabled)"

removedOutput schema / properties / signature_left_line3 / description

Removed value: -"third line of the first signature (only present if show_signature is enabled)"

removedOutput schema / properties / signature_left_line4 / description

Removed value: -"fourth line of the first signature (only present if show_signature is enabled)"

removedOutput schema / properties / signature_right / description

Removed value: -"the signature of the second organizer is displayed (only present if show_signature is enabled)"

removedOutput schema / properties / signature_right_image / description

Removed value: -"the uploaded image of the second signature is displayed (only present if show_signature is enabled)"

removedOutput schema / properties / signature_right_line1 / description

Removed value: -"name of the second organizer (only present if show_signature is enabled)"

removedOutput schema / properties / signature_right_line2 / description

Removed value: -"second line of the second signature (only present if show_signature is enabled)"

removedOutput schema / properties / signature_right_line3 / description

Removed value: -"third line of the second signature (only present if show_signature is enabled)"

removedOutput schema / properties / signature_right_line4 / description

Removed value: -"fourth line of the second signature (only present if show_signature is enabled)"

removedOutput schema / properties / signature_stamp / description

Removed value: -"the uploaded stamp is displayed between the signatures (only present if show_signature is enabled)"

removedOutput schema / properties / signature_user / description

Removed value: -"a signature line is displayed for the examinee (only present if show_signature is enabled)"

removedOutput schema / properties / supervisors_only / description

Removed value: -"only the supervisors can issue the certificates, the examinees cannot get their own ones"

removedOutput schema / properties / text1 / description

Removed value: -"text displayed under the data of the examinee, the multi line texts (text1, text2 and notes) are returned with basic HTML formatting and line breaks"

removedOutput schema / properties / text2 / description

Removed value: -"text displayed under the results, above the date of the test"

removedOutput schema / properties / text_date / description

Removed value: -"text displayed before the date of the test"

removedOutput schema / properties / timezone / description

Removed value: -"timezone of the dates on the certificates, null if the timezone of the exam is used"

removedOutput schema / properties / title / description
```
Removed value: -"title of the certificates"
```

Addedv1.2.16Sep 6, 2026

TDQS

A4.2/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already carry readOnlyHint=false, idempotentHint=true, and destructiveHint=false, so the bar is lower; the description still adds value by spelling out the overwrite semantics ('replace the complete certificate configuration') and the locking constraint. The schema additionally reveals the ongoing link where a preset's settings are 'kept up to date' and that source images are copied, which is behavioral context beyond the annotation flags. Nothing in the description contradicts the annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is exactly two sentences with zero filler: the first delivers the action and its two modes, the second the operative preconditions. The purpose is front-loaded and every clause earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With 100% schema parameter coverage, an output schema present, and annotations covering the read-only/idempotent/destructive profile, the description covers the essentials of purpose and preconditions. The remaining gap is failure behavior — what happens if certificates are disabled or the exam is locked — and the fate of existing certificates after replacement, which keeps this from a perfect score.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, and each parameter (exam, preset, source) already carries a detailed schema description including a cross-reference to the presets tool, mutual-exclusion constraints, and image-copy behavior, so the baseline of 3 applies. The tool description frames the preset/source choice but adds no syntax or format detail beyond what the schema provides, which is acceptable because the schema is comprehensive.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb and object — 'Replace the complete certificate configuration of an exam' — and names the two input modes ('with a preset or with the configuration of another exam'). This clearly differentiates it from sibling tools like edubase_get_exam_certificates, edubase_post_exam_certificates, and edubase_delete_exam_certificates, which read, set, or remove certificate configuration rather than replace it wholesale.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The second sentence gives two operative preconditions for a valid call: certificates must be enabled for the exam, and settings cannot be changed while the exam is locked. This is clear context about when the tool is usable, though it never names sibling alternatives or states explicit when-not-to-use scenarios, so it stops short of full routing guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server