add_tag_rule
ChatGPTAdd a rule to a tag in a scene of an Uptale experience.
complete_media_upload
ChatGPTFinish a direct upload started with upload_media: after its curl command succeeded, pass the completion object from the upload_media result. Creates the media in the experience and starts its processing.
create_experience
ChatGPTCreate a new Uptale experience in a workspace. Use list_workspaces first when the workspace id is unknown.
create_objective
ChatGPTCreate one or multiple objectives in an Uptale experience.
create_scene
ChatGPTCreate a new scene in an Uptale experience, as input you should expect an experienceid and scene type, if the user requests N>1 scenes then call the tool N times
create_skill
ChatGPTCreate one or multiple skills inside objectives.
create_star
ChatGPTCreate one or multiple stars in an Uptale experience.
create_tags
ChatGPTCreate one or multiple tags in a scene of an Uptale experience and save the experience once. Always pass tags as an array; to create one tag, pass one item in the tags array. Name: tag display name. Info/QCM: Content.Title, Content.Text. QCM also: Answers[].Title, Answers[].Value, Answers[].Sound, Answers[].ToWorld; a QCM always has 4 answer slots: pass at most 4 Answers, missing ones are saved empty. Canvas/Door: Caption. Door: ToDestination. Image2D/Video2D/Slides2D/Object3D: Media. Audio: Sound, not Media. Shape: Shape takes Kind and every field of that kind; fields are kind-specific (e.g. CornerRadius is Rectangle only) and the Shape field schema describes them.Without Shape, the tag starts as a 1 x 1 m Rectangle; fill and stroke come from the experience theme. Position: "x,y,z" in metres; its field description gives the axes, origin and the effect of the scene Rotation. Orientation: Facing (IsRotationAuto, Studio "Facing", in French "De face") is on by default, so the tag turns about the vertical axis to face the learner. For a fixed orientation, set IsRotationAuto to false and set Rotation; that tag keeps its Rotation when moved, so it may end up facing away from the learner. Marker is supported. Mic supports ListenRecognize, RecordReplay, and AiConversation modes and mode-specific speech/TTS fields. MicMode defaults to ListenRecognize. For AiConversation, provide Role.PersonaPrompt; Role.ConversationObjective is optional. Before setting AudioFeedback or ConversationAudio voices, call list_editor_language_variables and use a voice for the target language and a style supported by that voice. Before selecting Avatar tag IDs, call get_experience (the outline lists tag types) and ask the user to confirm the eligible Object3D or Video2D tags. A field the input schema does not list is refused, not ignored: that setting is not available through the MCP yet, which does not mean the Uptale editor lacks it. Use add_tag_rule to add rules to a tag after it is created. notApplied in the result lists each field asked for whose saved value differs (field, saved): tell the user those were not applied.
create_text_to_speech
ChatGPTCreate a text-to-speech sound resource in an experience. Use a voiceName and optional voiceStyle returned by list_editor_language_variables.
delete_tag
ChatGPTDelete a tag from a scene of an Uptale experience. Also removes persisted references to the tag from dependencies, rules, target objects, and objectives.
delete_tag_rule
ChatGPTDelete a rule from a tag in a scene of an Uptale experience.
duplicate_experience
ChatGPTDuplicate an existing Uptale experience into a workspace: the same one, or another one such as from a template workspace to a client workspace. The copy is a new experience with its own id. Use list_workspaces and list_experiences first when ids are unknown.
get_experience
ChatGPTAlways use this tool to read an Uptale experience, and fetch only what the request needs. Pass sceneIds or tagIds (ids or names) to get those scenes or tags whole: a scene or tag the user names takes one call. sections picks what to return, several per call: outline (default without ids): every scene with its tag count, plus the tags (Id, Name, Type) of the scenes in sceneIds; settings: experience-level settings; objectives: objectives, skills and stars; scenes: the scenes in sceneIds, with all their tags; tags: the tags in tagIds, each with its SceneId. When you do not know the ids or names, fetch the outline, then the outline of the scene, then only the tags you need. A response over 40000 bytes comes in parts: fetch less if you need only some of it, otherwise call again with the same arguments and the next part until the last one. Use list_experiences first when the experience id is unknown.
link_star_to_skill
ChatGPTLink one or multiple existing stars to skills.
list_editor_language_variables
ChatGPTList editor language-related initial variables: text-to-speech voices, translation languages, and speech-to-text languages. text2SpeechVoices includes locale, gender, voiceName, displayName, and styles — use voiceName and a supported style for Mic AudioFeedback. textTranslatorDescriptors lists locales supported for translation (use before sync_language). speech2TextDescriptors lists locales supported for speech recognition.
list_experience_media
ChatGPTList all media in an Uptale experience.
list_experiences
ChatGPTList experiences in an Uptale workspace. Use list_workspaces first when the workspace id is unknown.
list_workspaces
ChatGPTList all workspaces accessible to the current Uptale user.
move_experience
ChatGPTMove an existing Uptale experience to another folder, another workspace, or both. The experience keeps its id. Moving it to another workspace fails while it is used in a program of its current workspace. Use list_workspaces and list_experiences first when ids are unknown.
reorder_tag
ChatGPTChange a tag's rank in its scene's tag list, the order shown in the editor's tag panel. Does not change the tag's 3D Position (use update_tags) nor its scene. destinationIndex is zero-based: 0 puts the tag first, the tag count minus 1 puts it last. Call get_experience first to read the scene's current tag order.
sync_language
ChatGPTAdd a language to an experience, or make one of its languages the default (main) language. A language must be added before update_scene, update_tags, or translate_experience can save content into it. To switch the default language: add the language, translate the experience with translate_experience, then call this tool again with setAsDefault: true. If the experience has no default language yet (defaultLanguage is null), first call it with setAsDefault: true and the language its current content is written in. Returns the experience's defaultLanguage and otherLanguages.
translate_experience
ChatGPTTranslate the texts of an Uptale experience into one of its languages, translating them yourself. Call it once without translations to get the texts to translate, then again with them to save. Only translatable texts are written; Narration sounds and avatar videos are not translated with this tool.
update_experience_settings
ChatGPTUpdate the settings of an Uptale experience, as in the experience settings of the Studio editor. Only the Goals tab is supported: it sets how a learner passes the experience, with one goal at a time. Stars sets the global success threshold (StarSuccessThreshold): the number of stars the learner must win over the whole experience to pass. It is not a CheckScore or CheckSkill tag rule, which only compares a score inside a scene to trigger actions. Scenes makes the learner pass or fail depending on the final scene they end in. None removes the goal and disables the certificate. Choosing a goal clears the settings of the other ones, as in the Studio editor. Other settings, the experience context and protected features are not supported yet: ask the user to change them in the Studio editor. notApplied in the result lists each goal field asked for whose saved value differs (field, saved, and sceneId for a scene): tell the user those were not applied.
update_scene
ChatGPTUpdate an existing scene in an Uptale experience. Pass partial scene fields in sceneData; the scene Id is preserved. Use the get_experience outline first when the scene id is unknown. notApplied in the result lists each field asked for whose saved value differs (field, saved): tell the user those were not applied.
update_tag_rule
ChatGPTUpdate a rule on a tag in a scene of an Uptale experience.Rule Name is always required: provide the existing name to keep it unchanged, or a different name to rename the rule.
update_tags
ChatGPTUpdate one or multiple existing tags, in one or several scenes of an Uptale experience, and save the experience once. Always pass tags as an array of { sceneId, tagId, tagData }; to update one tag, pass one item in the tags array. Fields match VRify editCurrentTag payloads. Name: tag display name. Info/QCM: Content.Title, Content.Text. QCM: Answers[] replaces the whole answer list, so pass every answer to keep; a QCM always has 4 answer slots: pass at most 4 Answers, missing ones are saved empty. Canvas/Door: Caption. Door: ToDestination. Image2D/Video2D/Slides2D/Object3D: Media. Audio: Sound, not Media. Shape: Shape replaces the whole definition, so pass Kind and every field of that kind, not only the changed ones; fields are kind-specific (e.g. CornerRadius is Rectangle only), and an omitted optional field resets to its default. Position: "x,y,z" in metres; its field description gives the axes, origin and the effect of the scene Rotation. Orientation: Facing (IsRotationAuto, Studio "Facing", in French "De face") is on by default, so the tag turns about the vertical axis to face the learner. For a fixed orientation, set IsRotationAuto to false and set Rotation; that tag keeps its Rotation when moved, so it may end up facing away from the learner. Marker is supported. Mic updates accept all Mic fields and dispatch by the final MicMode; before setting AudioFeedback or ConversationAudio voices, call list_editor_language_variables and use a voice for the target language and a style supported by that voice; before changing Avatar tag IDs, call get_experience (the outline lists tag types) and ask the user to confirm the eligible Object3D or Video2D tags; a field the input schema does not list is refused, not ignored: that setting is not available through the MCP yet, which does not mean the Uptale editor lacks it; use add_tag_rule, update_tag_rule and delete_tag_rule for rule maintenance. notApplied in the result lists each field asked for whose saved value differs (field, saved): tell the user those were not applied.
upload_media
ChatGPTStart a media upload into an Uptale experience. With directUpload, returns curl commands that upload the file straight to Uptale storage, then call complete_media_upload. Without it, or when the file cannot be uploaded that way, returns a link to the media manager of the experience in Uptale, where the user uploads the files, and the ids of the media already in the experience. Follow nextSteps in the result.