MCP Server

Tutorializer Video Tutorials

com.tutorializer/tutorializer
Education Media & Content Public & reachable MCP 2025-11-25

What this MCP does

Manages localized tutorials, voiceover segments, pronunciation rules, and registered rendered tutorial videos.

create_project
Create a tutorial project
Use this when someone wants to start a new Tutorializer project for a product or app. Returns the new project's id, name, vanity id, domain and default locale. Each call creates another project. Not for changing an existing project.
Destructive
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['name'], 'properties': {'name': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Project name as people will see it, up to 120 characters'}, 'domain': {'type': 'string', 'maxLength': 253, 'minLength': 1, 'description': 'Domain of the product the tutorials cover, e.g. example.com; optional'}, 'defaultLocale': {'type': 'string', 'maxLength': 16, 'minLength': 2, 'description': 'Main language code of the tutorials, e.g. en or pt-BR; optional'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'project'], 'properties': {'status': {'type': 'string', 'const': 'created'}, 'project': {'type': 'object', 'required': ['id', 'name', 'vanityId', 'domain', 'defaultLocale'], 'properties': {'id': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'name': {'type': 'string', 'maxLength': 120, 'minLength': 1}, 'domain': {'anyOf': [{'type': 'string', 'maxLength': 253}, {'type': 'null'}]}, 'vanityId': {'anyOf': [{'type': 'string', 'maxLength': 63, 'minLength': 1}, {'type': 'null'}]}, 'defaultLocale': {'anyOf': [{'type': 'string', 'maxLength': 16}, {'type': 'null'}]}}, 'additionalProperties': False}}, 'additionalProperties': False}
create_speech
Create a voiceover line
Use this when someone wants new narration or voiceover in a project. Returns the new line's id, language, voice and audio URL. Without url the audio is synthesized from the text with the project's voice provider, spending the organization's synthesis credits; with url it records audio you already have. Not for fixing an existing line.
Destructive
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['projectId', 'text', 'language'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'maxLength': 2048, 'description': 'Public https URL of audio you already produced. Supplying it records the segment without synthesizing anything.'}, 'text': {'type': 'string', 'maxLength': 5000, 'minLength': 1, 'description': 'Words to speak, up to 5000 characters'}, 'voice': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': "Optional voice id; defaults to the project's default voice"}, 'language': {'type': 'string', 'maxLength': 32, 'minLength': 2, 'description': 'Language code of the narration, e.g. en or pt-BR'}, 'projectId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Project the voiceover line belongs to'}, 'translatedText': {'type': 'string', 'maxLength': 5000, 'minLength': 1, 'description': 'Optional translation spoken instead of the source text'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'synthesized', 'speech'], 'properties': {'speech': {'type': 'object', 'required': ['id', 'projectId', 'language', 'voice', 'url', 'duration', 'textPreview', 'creationTime', 'lastEditTime'], 'properties': {'id': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'url': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'voice': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'duration': {'anyOf': [{'type': 'number', 'maximum': 86400, 'minimum': 0}, {'type': 'null'}]}, 'language': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'projectId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'textPreview': {'anyOf': [{'type': 'string', 'maxLength': 5000}, {'type': 'null'}]}, 'creationTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}}, 'additionalProperties': False}, 'status': {'enum': ['created', 'recorded'], 'type': 'string'}, 'synthesized': {'type': 'boolean', 'description': 'True when audio was synthesized and synthesis credits were spent; false when a url was recorded'}}, 'additionalProperties': False}
create_tutorial
Create a tutorial
Use this when someone wants to add a new tutorial to a project. Returns the new tutorial's id, name, project and default voice. Each call creates another tutorial; it records the tutorial without recording or rendering a video. Not for adding a rendered video.
Destructive
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['projectId', 'name'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Tutorial name, up to 200 characters'}, 'projectId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Project the tutorial belongs to'}, 'defaultVoice': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Optional voice id used when narration is synthesized for this tutorial'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'tutorial'], 'properties': {'status': {'type': 'string', 'const': 'created'}, 'tutorial': {'type': 'object', 'required': ['id', 'name', 'projectId', 'defaultVoice', 'creationTime', 'lastEditTime'], 'properties': {'id': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'projectId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'creationTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'defaultVoice': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}}, 'additionalProperties': False}}, 'additionalProperties': False}
create_video
Add a rendered tutorial video
Use this when someone has an already uploaded tutorial video file and wants it listed under a tutorial. Returns the new video record with its language, device, dimensions and URLs. Host the file first and pass its public https URL; each call adds another record. Not for recording, rendering or uploading a video.
Destructive
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['projectId', 'tutorialId', 'url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'maxLength': 2048, 'description': 'Public https URL of the already-uploaded video file'}, 'width': {'type': 'integer', 'maximum': 100000, 'description': 'Width in pixels, 1 to 100000', 'exclusiveMinimum': 0}, 'device': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Device the video was rendered for: computer, tablet or smartphone'}, 'format': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Container or codec, e.g. mp4 or webm'}, 'height': {'type': 'integer', 'maximum': 100000, 'description': 'Height in pixels, 1 to 100000', 'exclusiveMinimum': 0}, 'locale': {'type': 'string', 'maxLength': 32, 'minLength': 2, 'description': 'Language code of this video, e.g. en or pt-BR'}, 'duration': {'type': 'number', 'maximum': 86400, 'minimum': 0, 'description': 'Duration in seconds, up to 86400'}, 'fileSize': {'type': 'number', 'maximum': 1000000000000000, 'minimum': 0, 'description': 'File size in bytes'}, 'projectId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Project that owns the tutorial'}, 'tutorialId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Tutorial this video is a rendering of'}, 'chaptersUrl': {'$ref': '#/properties/url', 'description': 'Public https URL of the chapters track'}, 'subtitlesUrl': {'$ref': '#/properties/chaptersUrl', 'description': 'Public https URL of a WebVTT subtitle track'}, 'thumbnailUrl': {'$ref': '#/properties/chaptersUrl', 'description': 'Public https URL of the poster image'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'video'], 'properties': {'video': {'type': 'object', 'required': ['id', 'projectId', 'tutorialId', 'url', 'locale', 'device', 'format', 'width', 'height', 'duration', 'fileSize', 'chaptersUrl', 'subtitlesUrl', 'thumbnailUrl', 'creationTime', 'lastEditTime'], 'properties': {'id': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'url': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'width': {'anyOf': [{'type': 'integer', 'maximum': 100000, 'minimum': 0}, {'type': 'null'}]}, 'device': {'anyOf': [{'type': 'string', 'maxLength': 100}, {'type': 'null'}]}, 'format': {'anyOf': [{'type': 'string', 'maxLength': 100}, {'type': 'null'}]}, 'height': {'anyOf': [{'type': 'integer', 'maximum': 100000, 'minimum': 0}, {'type': 'null'}]}, 'locale': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'duration': {'anyOf': [{'type': 'number', 'maximum': 86400, 'minimum': 0}, {'type': 'null'}]}, 'fileSize': {'anyOf': [{'type': 'number', 'maximum': 1000000000000000, 'minimum': 0}, {'type': 'null'}]}, 'projectId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'tutorialId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'chaptersUrl': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'creationTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'subtitlesUrl': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'thumbnailUrl': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}}, 'additionalProperties': False}, 'status': {'type': 'string', 'const': 'created'}}, 'additionalProperties': False}
delete_speech
Delete a voiceover line
Use this when someone wants one voiceover line permanently deleted with its audio. Returns the deleted line id; the audio and timing files are erased, so restoring it means synthesizing again, which spends credits. Deleting it again changes nothing. Not for changing its words.
Destructive Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['speechId'], 'properties': {'speechId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Voiceover line to delete'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'speechId'], 'properties': {'status': {'type': 'string', 'const': 'deleted'}, 'speechId': {'type': 'string', 'maxLength': 200, 'minLength': 1}}, 'additionalProperties': False}
delete_tutorial
Delete a tutorial
Use this when someone wants a tutorial permanently deleted. Returns the deleted tutorial id; its videos and voiceover lines stay and each needs its own delete. Deleting it again changes nothing. Not for removing one language or device version.
Destructive Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['tutorialId'], 'properties': {'tutorialId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Tutorial to delete'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'tutorialId'], 'properties': {'status': {'type': 'string', 'const': 'deleted'}, 'tutorialId': {'type': 'string', 'maxLength': 200, 'minLength': 1}}, 'additionalProperties': False}
delete_video
Delete a tutorial video
Use this when someone wants one rendered tutorial video permanently deleted. Returns the deleted video id; the record and its video file in Tutorializer storage are erased, so restoring it means uploading or rendering again. Not for deleting the whole tutorial.
Destructive Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['videoId'], 'properties': {'videoId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Video to delete'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'videoId'], 'properties': {'status': {'type': 'string', 'const': 'deleted'}, 'videoId': {'type': 'string', 'maxLength': 200, 'minLength': 1}}, 'additionalProperties': False}
get_project
Get project settings
Use this when someone asks about one project's languages, default voice, narration speed or pronunciation rules. Returns its name, domain, default and configured locales, voice settings and up to 50 pronunciation rules, looked up by project id or vanity id. Not for finding languages or devices that lack videos.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['projectId'], 'properties': {'projectId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Project id or its stable public vanity id'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'project'], 'properties': {'status': {'enum': ['found', 'not-found'], 'type': 'string'}, 'project': {'anyOf': [{'type': 'object', 'required': ['id', 'name', 'vanityId', 'domain', 'defaultLocale', 'locales', 'defaultVoice', 'stability', 'similarityBoost', 'style', 'speed', 'creationTime', 'lastEditTime', 'pronunciationRules', 'pronunciationRuleCount', 'pronunciationRuleCountIsLowerBound', 'pronunciationRulesTruncated'], 'properties': {'id': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'name': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'speed': {'anyOf': [{'type': 'number', 'maximum': 10, 'minimum': 0.1}, {'type': 'null'}]}, 'style': {'anyOf': [{'type': 'number', 'maximum': 1, 'minimum': 0}, {'type': 'null'}]}, 'domain': {'anyOf': [{'type': 'string', 'maxLength': 253}, {'type': 'null'}]}, 'locales': {'type': 'array', 'items': {'type': 'string', 'maxLength': 32}, 'maxItems': 100}, 'vanityId': {'anyOf': [{'type': 'string', 'maxLength': 63}, {'type': 'null'}]}, 'stability': {'anyOf': [{'type': 'number', 'maximum': 1, 'minimum': 0}, {'type': 'null'}]}, 'creationTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'defaultVoice': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'defaultLocale': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'similarityBoost': {'anyOf': [{'type': 'number', 'maximum': 1, 'minimum': 0}, {'type': 'null'}]}, 'pronunciationRules': {'type': 'array', 'items': {'type': 'object', 'required': ['word', 'phonemes', 'alphabet'], 'properties': {'word': {'anyOf': [{'type': 'string', 'maxLength': 120}, {'type': 'null'}]}, 'alphabet': {'enum': ['ipa', 'cmu'], 'type': 'string'}, 'phonemes': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 50}, 'pronunciationRuleCount': {'type': 'integer', 'maximum': 1000000, 'minimum': 0}, 'pronunciationRulesTruncated': {'type': 'boolean'}, 'pronunciationRuleCountIsLowerBound': {'type': 'boolean'}}, 'additionalProperties': False}, {'type': 'null'}], 'description': 'Project settings; null when not found. Organization ids and pronunciation-dictionary ids are never returned.'}}, 'additionalProperties': False}
get_project_localization_summary
Check missing languages and devices
Use this when someone asks which languages or devices a project still lacks tutorial videos or voiceovers for, or how complete its translations are. Returns video and voiceover counts per language and video counts per device, plus the missing ones, from the latest 100 of each. Not for one tutorial's videos.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['projectId'], 'properties': {'projectId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Project id or its stable public vanity id'}, 'expectedDevices': {'type': 'array', 'items': {'type': 'string', 'maxLength': 40, 'minLength': 1}, 'maxItems': 10, 'minItems': 1, 'description': 'Devices each language should have videos for, 1 to 10 names such as computer, tablet or smartphone; defaults to those three'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'summary'], 'properties': {'status': {'enum': ['found', 'not-found'], 'type': 'string'}, 'summary': {'anyOf': [{'type': 'object', 'required': ['project', 'totals', 'localeCoverage', 'localeCoverageTotal', 'localeCoverageTruncated', 'deviceCoverage', 'missingVideoLocales', 'missingSpeechLocales', 'missingDevices', 'coverageDerivedFromTruncatedData'], 'properties': {'totals': {'type': 'object', 'required': ['tutorials', 'videos', 'speeches'], 'properties': {'videos': {'$ref': '#/properties/summary/anyOf/0/properties/totals/properties/tutorials'}, 'speeches': {'$ref': '#/properties/summary/anyOf/0/properties/totals/properties/tutorials'}, 'tutorials': {'type': 'object', 'required': ['count', 'isLowerBound'], 'properties': {'count': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'isLowerBound': {'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'project': {'type': 'object', 'required': ['id', 'name', 'defaultLocale', 'configuredLocales', 'configuredLocalesTruncated'], 'properties': {'id': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'name': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'defaultLocale': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'configuredLocales': {'type': 'array', 'items': {'type': 'string', 'maxLength': 32}, 'maxItems': 100}, 'configuredLocalesTruncated': {'type': 'boolean'}}, 'additionalProperties': False}, 'deviceCoverage': {'type': 'array', 'items': {'type': 'object', 'required': ['device', 'videos'], 'properties': {'device': {'type': 'string', 'maxLength': 40, 'minLength': 1}, 'videos': {'type': 'integer', 'maximum': 100, 'minimum': 0}}, 'additionalProperties': False}, 'maxItems': 10}, 'localeCoverage': {'type': 'array', 'items': {'type': 'object', 'required': ['locale', 'configured', 'videos', 'speeches'], 'properties': {'locale': {'type': 'string', 'maxLength': 32, 'minLength': 1}, 'videos': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'speeches': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'configured': {'type': 'boolean'}}, 'additionalProperties': False}, 'maxItems': 50}, 'missingDevices': {'type': 'array', 'items': {'type': 'string', 'maxLength': 40}, 'maxItems': 10}, 'localeCoverageTotal': {'type': 'integer', 'maximum': 300, 'minimum': 0}, 'missingVideoLocales': {'type': 'array', 'items': {'type': 'string', 'maxLength': 32}, 'maxItems': 100}, 'missingSpeechLocales': {'type': 'array', 'items': {'type': 'string', 'maxLength': 32}, 'maxItems': 100}, 'localeCoverageTruncated': {'type': 'boolean'}, 'coverageDerivedFromTruncatedData': {'type': 'boolean'}}, 'additionalProperties': False}, {'type': 'null'}], 'description': 'Coverage from at most the 100 most recently edited tutorials, videos and voiceover lines; coverageDerivedFromTruncatedData is true when more exist. Null when the project is not found.'}}, 'additionalProperties': False}
get_speech
Read a voiceover line
Use this when someone needs the full wording or translation of one voiceover line, or its audio link. Returns its source text, translation, language, voice, duration, project and audio URL. Not for changing the words.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['speechId'], 'properties': {'speechId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Voiceover line id'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'speech'], 'properties': {'speech': {'anyOf': [{'type': 'object', 'required': ['id', 'projectId', 'language', 'voice', 'duration', 'url', 'creationTime', 'lastEditTime', 'text', 'textTruncated', 'translatedText', 'translatedTextTruncated'], 'properties': {'id': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'url': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'text': {'anyOf': [{'type': 'string', 'maxLength': 4000}, {'type': 'null'}]}, 'voice': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'duration': {'anyOf': [{'type': 'number', 'maximum': 86400, 'minimum': 0}, {'type': 'null'}]}, 'language': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'projectId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'creationTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'textTruncated': {'type': 'boolean'}, 'translatedText': {'anyOf': [{'type': 'string', 'maxLength': 4000}, {'type': 'null'}]}, 'translatedTextTruncated': {'type': 'boolean'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'status': {'enum': ['found', 'not-found'], 'type': 'string'}}, 'additionalProperties': False}
get_tutorial
Get a tutorial and its videos
Use this when someone asks about one tutorial and the videos rendered from it. Returns the tutorial's name, project and default voice plus up to 8 of its most recently edited videos with language, device, format, size and media links. Not for every video in a project.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['tutorialId'], 'properties': {'tutorialId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Tutorial id'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'tutorial', 'videoCount', 'videoCountIsLowerBound', 'videos'], 'properties': {'status': {'enum': ['found', 'not-found'], 'type': 'string'}, 'videos': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'locale', 'device', 'format', 'width', 'height', 'url', 'chaptersUrl', 'subtitlesUrl', 'thumbnailUrl'], 'properties': {'id': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'url': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'width': {'anyOf': [{'type': 'integer', 'maximum': 100000, 'minimum': 0}, {'type': 'null'}]}, 'device': {'anyOf': [{'type': 'string', 'maxLength': 100}, {'type': 'null'}]}, 'format': {'anyOf': [{'type': 'string', 'maxLength': 100}, {'type': 'null'}]}, 'height': {'anyOf': [{'type': 'integer', 'maximum': 100000, 'minimum': 0}, {'type': 'null'}]}, 'locale': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'chaptersUrl': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'subtitlesUrl': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'thumbnailUrl': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 8}, 'tutorial': {'anyOf': [{'type': 'object', 'required': ['id', 'name', 'projectId', 'defaultVoice', 'creationTime', 'lastEditTime'], 'properties': {'id': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'projectId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'creationTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'defaultVoice': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'null'}]}, 'videoCount': {'type': 'integer', 'maximum': 8, 'minimum': 0}, 'videoCountIsLowerBound': {'type': 'boolean'}}, 'additionalProperties': False}
get_video
Get video details
Use this when someone asks about one tutorial video, such as its link, subtitles, chapters or thumbnail. Returns its tutorial, language, device, dimensions and its video, chapters, subtitles and thumbnail URLs. Not for changing those details.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['videoId'], 'properties': {'videoId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Video id'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'video'], 'properties': {'video': {'anyOf': [{'type': 'object', 'required': ['id', 'projectId', 'tutorialId', 'locale', 'device', 'theme', 'format', 'width', 'height', 'fileSize', 'url', 'chaptersUrl', 'subtitlesUrl', 'thumbnailUrl', 'creationTime', 'lastEditTime'], 'properties': {'id': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'url': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'theme': {'anyOf': [{'type': 'string', 'maxLength': 100}, {'type': 'null'}]}, 'width': {'anyOf': [{'type': 'integer', 'maximum': 100000, 'minimum': 0}, {'type': 'null'}]}, 'device': {'anyOf': [{'type': 'string', 'maxLength': 100}, {'type': 'null'}]}, 'format': {'anyOf': [{'type': 'string', 'maxLength': 100}, {'type': 'null'}]}, 'height': {'anyOf': [{'type': 'integer', 'maximum': 100000, 'minimum': 0}, {'type': 'null'}]}, 'locale': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'fileSize': {'anyOf': [{'type': 'number', 'maximum': 1000000000000000, 'minimum': 0}, {'type': 'null'}]}, 'projectId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'tutorialId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'chaptersUrl': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'creationTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'subtitlesUrl': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'thumbnailUrl': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'null'}]}, 'status': {'enum': ['found', 'not-found'], 'type': 'string'}}, 'additionalProperties': False}
list_projects
List your tutorial projects
Use this when someone asks which Tutorializer projects they have, or a project's id is needed. Returns each project's id, name, vanity id, domain and created and edited times, sorted by name, 25 per page by default. Not for a project's languages or voice settings.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'description': 'Projects per page, from 1 to 100; defaults to 25', 'exclusiveMinimum': 0}, 'cursor': {'type': 'string', 'maxLength': 4096, 'description': 'The nextCursor of the previous page; absent for the first page'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'projects', 'offset', 'returned', 'hasMore', 'nextCursor'], 'properties': {'offset': {'type': 'integer', 'maximum': 1000000, 'minimum': 0}, 'status': {'enum': ['found', 'empty'], 'type': 'string'}, 'hasMore': {'type': 'boolean'}, 'projects': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'vanityId', 'domain', 'creationTime', 'lastEditTime'], 'properties': {'id': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'name': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'domain': {'anyOf': [{'type': 'string', 'maxLength': 253}, {'type': 'null'}]}, 'vanityId': {'anyOf': [{'type': 'string', 'maxLength': 63}, {'type': 'null'}]}, 'creationTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 100}, 'returned': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'nextCursor': {'anyOf': [{'type': 'string', 'maxLength': 4096}, {'type': 'null'}], 'description': 'Cursor for the next page; null on the last page'}}, 'additionalProperties': False}
list_speeches
List voiceover lines
Use this when someone asks which voiceover or narration lines a project has, optionally in one language. Returns each line's id, a short text preview, language, project and audio URL, most recently edited first, 25 per page by default. Not for the full text of one line.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'description': 'Voiceover lines per page, from 1 to 100; defaults to 25', 'exclusiveMinimum': 0}, 'cursor': {'type': 'string', 'maxLength': 4096, 'description': 'The nextCursor of the previous page with the same filters; absent for the first page'}, 'language': {'type': 'string', 'maxLength': 32, 'description': 'Only lines in this language code, e.g. en, es or de'}, 'projectId': {'type': 'string', 'maxLength': 200, 'description': 'Only voiceover lines in this project'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'projectIdFilter', 'languageFilter', 'speeches', 'offset', 'returned', 'hasMore', 'nextCursor'], 'properties': {'offset': {'type': 'integer', 'maximum': 1000000, 'minimum': 0}, 'status': {'enum': ['found', 'empty'], 'type': 'string'}, 'hasMore': {'type': 'boolean'}, 'returned': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'speeches': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'textPreview', 'textTruncated', 'language', 'projectId', 'url', 'creationTime', 'lastEditTime'], 'properties': {'id': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'url': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'language': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'projectId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'textPreview': {'anyOf': [{'type': 'string', 'maxLength': 120}, {'type': 'null'}]}, 'creationTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'textTruncated': {'type': 'boolean'}}, 'additionalProperties': False}, 'maxItems': 100, 'description': 'Voiceover lines with a text preview of up to 120 characters, not the full text'}, 'nextCursor': {'anyOf': [{'type': 'string', 'maxLength': 4096}, {'type': 'null'}], 'description': 'Cursor for the next page; null on the last page'}, 'languageFilter': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'projectIdFilter': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}}, 'additionalProperties': False}
list_tutorials
List tutorials
Use this when someone asks which tutorials a project has, or when another tool needs a tutorial id. Returns each tutorial's id, name, project, default voice and times, most recently edited first, 25 per page by default. Not for the rendered videos of each language or device.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'description': 'Tutorials per page, from 1 to 100; defaults to 25', 'exclusiveMinimum': 0}, 'cursor': {'type': 'string', 'maxLength': 4096, 'description': 'The nextCursor of the previous page with the same filters; absent for the first page'}, 'projectId': {'type': 'string', 'maxLength': 200, 'description': 'Only tutorials in this project; every project when absent'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'projectIdFilter', 'tutorials', 'offset', 'returned', 'hasMore', 'nextCursor'], 'properties': {'offset': {'type': 'integer', 'maximum': 1000000, 'minimum': 0}, 'status': {'enum': ['found', 'empty'], 'type': 'string'}, 'hasMore': {'type': 'boolean'}, 'returned': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'tutorials': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'projectId', 'defaultVoice', 'creationTime', 'lastEditTime'], 'properties': {'id': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'name': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'projectId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'creationTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'defaultVoice': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 100}, 'nextCursor': {'anyOf': [{'type': 'string', 'maxLength': 4096}, {'type': 'null'}], 'description': 'Cursor for the next page; null on the last page'}, 'projectIdFilter': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}}, 'additionalProperties': False}
list_videos
List tutorial videos
Use this when someone asks which tutorial videos exist, optionally for one project, tutorial, language or device. Returns each video's id, tutorial, language, device, format, dimensions, file size and URL, most recently edited first, 25 per page by default. Not for checking missing languages.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'description': 'Videos per page, from 1 to 100; defaults to 25', 'exclusiveMinimum': 0}, 'cursor': {'type': 'string', 'maxLength': 4096, 'description': 'The nextCursor of the previous page with the same filters; absent for the first page'}, 'device': {'type': 'string', 'maxLength': 100, 'description': 'Only videos for this device: computer, tablet or smartphone'}, 'locale': {'type': 'string', 'maxLength': 32, 'description': 'Only videos in this language code, e.g. en or pt-BR'}, 'projectId': {'type': 'string', 'maxLength': 200, 'description': 'Only videos in this project'}, 'tutorialId': {'type': 'string', 'maxLength': 200, 'description': 'Only videos of this tutorial'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'projectIdFilter', 'tutorialIdFilter', 'localeFilter', 'deviceFilter', 'videos', 'offset', 'returned', 'hasMore', 'nextCursor'], 'properties': {'offset': {'type': 'integer', 'maximum': 1000000, 'minimum': 0}, 'status': {'enum': ['found', 'empty'], 'type': 'string'}, 'videos': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'tutorialId', 'projectId', 'url', 'locale', 'device', 'format', 'width', 'height', 'fileSize', 'creationTime', 'lastEditTime'], 'properties': {'id': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'url': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'width': {'anyOf': [{'type': 'integer', 'maximum': 100000, 'minimum': 0}, {'type': 'null'}]}, 'device': {'anyOf': [{'type': 'string', 'maxLength': 100}, {'type': 'null'}]}, 'format': {'anyOf': [{'type': 'string', 'maxLength': 100}, {'type': 'null'}]}, 'height': {'anyOf': [{'type': 'integer', 'maximum': 100000, 'minimum': 0}, {'type': 'null'}]}, 'locale': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'fileSize': {'anyOf': [{'type': 'number', 'maximum': 1000000000000000, 'minimum': 0}, {'type': 'null'}]}, 'projectId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'tutorialId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'creationTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 100}, 'hasMore': {'type': 'boolean'}, 'returned': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'nextCursor': {'anyOf': [{'type': 'string', 'maxLength': 4096}, {'type': 'null'}], 'description': 'Cursor for the next page; null on the last page'}, 'deviceFilter': {'anyOf': [{'type': 'string', 'maxLength': 100}, {'type': 'null'}]}, 'localeFilter': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'projectIdFilter': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'tutorialIdFilter': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}}, 'additionalProperties': False}
remove_pronunciation_rule
Remove a pronunciation fix
Use this when someone wants to drop a pronunciation rule so a word is spoken the default way again. Returns whether it was removed and the remaining rule count; a missing rule changes nothing, and existing audio is kept as it is. Not for changing a rule's phonemes.
Destructive Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['projectId', 'word'], 'properties': {'word': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Exact word or phrase whose pronunciation rule should be removed'}, 'projectId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Project the rule belongs to'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'projectId', 'word', 'remainingRuleCount', 'remainingRuleCountIsLowerBound'], 'properties': {'word': {'type': 'string', 'maxLength': 120, 'minLength': 1}, 'status': {'enum': ['removed', 'unchanged', 'project-not-found'], 'type': 'string'}, 'projectId': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'remainingRuleCount': {'anyOf': [{'type': 'integer', 'maximum': 500, 'minimum': 0}, {'type': 'null'}]}, 'remainingRuleCountIsLowerBound': {'type': 'boolean'}}, 'additionalProperties': False}
set_pronunciation_rule
Fix how a word is pronounced
Use this when narration mispronounces a word, name or brand in a project's voiceovers. Returns the rule and the project's rule count after adding or replacing it (IPA or CMU phonemes, up to 500 rules) and syncing the pronunciation dictionary used for later synthesis. Not for re-voicing lines that already have audio.
Destructive Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['projectId', 'word', 'phonemes'], 'properties': {'word': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Exact word or phrase to match, up to 120 characters'}, 'alphabet': {'enum': ['ipa', 'cmu'], 'type': 'string', 'description': 'Phonetic alphabet: ipa or cmu; defaults to ipa'}, 'phonemes': {'type': 'string', 'maxLength': 500, 'minLength': 1, 'description': 'How to say it, in the chosen phonetic alphabet, up to 500 characters'}, 'projectId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Project whose narration to fix'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'projectId', 'rule', 'ruleCount', 'ruleCountIsLowerBound'], 'properties': {'rule': {'type': 'object', 'required': ['word', 'phonemes', 'alphabet'], 'properties': {'word': {'type': 'string', 'maxLength': 120, 'minLength': 1}, 'alphabet': {'enum': ['ipa', 'cmu'], 'type': 'string'}, 'phonemes': {'type': 'string', 'maxLength': 500, 'minLength': 1}}, 'additionalProperties': False}, 'status': {'enum': ['added', 'replaced', 'unchanged', 'project-not-found'], 'type': 'string'}, 'projectId': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'ruleCount': {'anyOf': [{'type': 'integer', 'maximum': 500, 'minimum': 0}, {'type': 'null'}]}, 'ruleCountIsLowerBound': {'type': 'boolean'}}, 'additionalProperties': False}
show_project_overview
Show project overview
Use this when someone wants a quick visual overview of one Tutorializer project. Returns a card with the project's name, domain and logo, how many tutorials, videos and voiceover lines it has (counted up to 100 each) and its 8 most recently edited tutorials. Not for missing languages or devices.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['projectId'], 'properties': {'projectId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Project id or its stable public vanity id'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['project', 'tutorialCount', 'tutorialCountIsLowerBound', 'videoCount', 'videoCountIsLowerBound', 'speechCount', 'speechCountIsLowerBound', 'tutorials'], 'properties': {'project': {'anyOf': [{'type': 'object', 'required': ['id', 'name', 'domain', 'logo'], 'properties': {'id': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'logo': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'domain': {'anyOf': [{'type': 'string', 'maxLength': 253}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'null'}]}, 'tutorials': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'defaultVoice', 'lastEditTime'], 'properties': {'id': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'defaultVoice': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 8}, 'videoCount': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'speechCount': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'tutorialCount': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'videoCountIsLowerBound': {'type': 'boolean'}, 'speechCountIsLowerBound': {'type': 'boolean'}, 'tutorialCountIsLowerBound': {'type': 'boolean'}}, 'additionalProperties': False}
update_project
Change project settings
Use this when someone wants to rename a project or change its domain, languages, default voice or narration speed. Returns the updated settings; fields left out keep their values, and a new locales list replaces the whole set. Not for pronunciation fixes.
Destructive Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['projectId'], 'properties': {'name': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'New project name, up to 120 characters'}, 'speed': {'type': 'number', 'maximum': 10, 'minimum': 0.1, 'description': 'New narration speed multiplier, from 0.1 to 10'}, 'domain': {'type': 'string', 'maxLength': 253, 'minLength': 1, 'description': 'New product domain, e.g. example.com'}, 'locales': {'type': 'array', 'items': {'type': 'string', 'maxLength': 32, 'minLength': 2}, 'maxItems': 100, 'minItems': 1, 'description': 'Complete list of language codes the project publishes, 1 to 100; it replaces the current list, and languages left out stop being expected'}, 'projectId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Project id or its stable public vanity id'}, 'defaultVoice': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'New default voice id for synthesized narration'}, 'defaultLocale': {'type': 'string', 'maxLength': 16, 'minLength': 2, 'description': 'New main language code, e.g. en or pt-BR'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'project'], 'properties': {'status': {'enum': ['updated', 'unchanged', 'not-found'], 'type': 'string'}, 'project': {'anyOf': [{'type': 'object', 'required': ['id', 'name', 'vanityId', 'domain', 'defaultLocale', 'locales', 'defaultVoice', 'speed', 'creationTime', 'lastEditTime'], 'properties': {'id': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'name': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'speed': {'anyOf': [{'type': 'number', 'maximum': 10, 'minimum': 0.1}, {'type': 'null'}]}, 'domain': {'anyOf': [{'type': 'string', 'maxLength': 253}, {'type': 'null'}]}, 'locales': {'type': 'array', 'items': {'type': 'string', 'maxLength': 32}, 'maxItems': 100}, 'vanityId': {'anyOf': [{'type': 'string', 'maxLength': 63}, {'type': 'null'}]}, 'creationTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'defaultVoice': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'defaultLocale': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'null'}]}}, 'additionalProperties': False}
update_speech
Change a voiceover line
Use this when someone wants to change the words, translation, language or voice of one voiceover line. Returns the updated line. A real change re-synthesizes its audio with the project's voice provider, spending synthesis credits and replacing the old audio; identical values change nothing. Not for project-wide pronunciation fixes.
Destructive Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['speechId'], 'properties': {'text': {'type': 'string', 'maxLength': 5000, 'minLength': 1, 'description': 'New words to speak, up to 5000 characters'}, 'voice': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'New voice id for this line'}, 'language': {'type': 'string', 'maxLength': 32, 'minLength': 2, 'description': 'New language code, e.g. en or pt-BR'}, 'speechId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Voiceover line to edit'}, 'translatedText': {'type': 'string', 'maxLength': 5000, 'minLength': 1, 'description': 'New translation spoken instead of the source text'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'resynthesized', 'speech'], 'properties': {'speech': {'anyOf': [{'type': 'object', 'required': ['id', 'projectId', 'language', 'voice', 'url', 'duration', 'textPreview', 'creationTime', 'lastEditTime'], 'properties': {'id': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'url': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'voice': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'duration': {'anyOf': [{'type': 'number', 'maximum': 86400, 'minimum': 0}, {'type': 'null'}]}, 'language': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'projectId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'textPreview': {'anyOf': [{'type': 'string', 'maxLength': 5000}, {'type': 'null'}]}, 'creationTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'null'}]}, 'status': {'enum': ['updated', 'unchanged', 'not-found'], 'type': 'string'}, 'resynthesized': {'type': 'boolean', 'description': 'True when the change re-synthesized the audio and spent synthesis credits'}}, 'additionalProperties': False}
update_tutorial
Rename a tutorial or change its voice
Use this when someone wants to rename a tutorial or change the default voice of its narration. Returns the updated tutorial; fields left out keep their values, and repeating the same values changes nothing. Not for editing narration text.
Destructive Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['tutorialId'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'New tutorial name, up to 200 characters'}, 'tutorialId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Tutorial to edit'}, 'defaultVoice': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'New default voice id for synthesized narration'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'tutorial'], 'properties': {'status': {'enum': ['updated', 'unchanged', 'not-found'], 'type': 'string'}, 'tutorial': {'anyOf': [{'type': 'object', 'required': ['id', 'name', 'projectId', 'defaultVoice', 'creationTime', 'lastEditTime'], 'properties': {'id': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'name': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'projectId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'creationTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'defaultVoice': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'null'}]}}, 'additionalProperties': False}
update_video
Fix a video's details
Use this when someone wants to correct a tutorial video's language, device, dimensions, file link, subtitles, chapters or thumbnail. Returns the updated video record; fields left out keep their values and identical values change nothing. Not for re-rendering the video itself.
Destructive Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['videoId'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'maxLength': 2048, 'description': 'New public https URL of the video file'}, 'width': {'type': 'integer', 'maximum': 100000, 'description': 'New width in pixels, 1 to 100000', 'exclusiveMinimum': 0}, 'device': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'New device: computer, tablet or smartphone'}, 'format': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'New container or codec, e.g. mp4 or webm'}, 'height': {'type': 'integer', 'maximum': 100000, 'description': 'New height in pixels, 1 to 100000', 'exclusiveMinimum': 0}, 'locale': {'type': 'string', 'maxLength': 32, 'minLength': 2, 'description': 'New language code, e.g. en or pt-BR'}, 'videoId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Video to correct'}, 'duration': {'type': 'number', 'maximum': 86400, 'minimum': 0, 'description': 'New duration in seconds, up to 86400'}, 'fileSize': {'type': 'number', 'maximum': 1000000000000000, 'minimum': 0, 'description': 'New file size in bytes'}, 'chaptersUrl': {'$ref': '#/properties/url', 'description': 'New public https URL of the chapters track'}, 'subtitlesUrl': {'$ref': '#/properties/url', 'description': 'New public https URL of a WebVTT subtitle track'}, 'thumbnailUrl': {'$ref': '#/properties/url', 'description': 'New public https URL of the poster image'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'video'], 'properties': {'video': {'anyOf': [{'type': 'object', 'required': ['id', 'projectId', 'tutorialId', 'url', 'locale', 'device', 'format', 'width', 'height', 'duration', 'fileSize', 'chaptersUrl', 'subtitlesUrl', 'thumbnailUrl', 'creationTime', 'lastEditTime'], 'properties': {'id': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'url': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'width': {'anyOf': [{'type': 'integer', 'maximum': 100000, 'minimum': 0}, {'type': 'null'}]}, 'device': {'anyOf': [{'type': 'string', 'maxLength': 100}, {'type': 'null'}]}, 'format': {'anyOf': [{'type': 'string', 'maxLength': 100}, {'type': 'null'}]}, 'height': {'anyOf': [{'type': 'integer', 'maximum': 100000, 'minimum': 0}, {'type': 'null'}]}, 'locale': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'duration': {'anyOf': [{'type': 'number', 'maximum': 86400, 'minimum': 0}, {'type': 'null'}]}, 'fileSize': {'anyOf': [{'type': 'number', 'maximum': 1000000000000000, 'minimum': 0}, {'type': 'null'}]}, 'projectId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'tutorialId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'chaptersUrl': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'creationTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'subtitlesUrl': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'thumbnailUrl': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'null'}]}, 'status': {'enum': ['updated', 'unchanged', 'not-found'], 'type': 'string'}}, 'additionalProperties': False}
Changed
show_project_overview
Sept. 29, 2026, 2:50 a.m.
Changed
delete_video
Sept. 29, 2026, 2:50 a.m.
Changed
delete_speech
Sept. 29, 2026, 2:50 a.m.
Changed
delete_tutorial
Sept. 29, 2026, 2:50 a.m.
Changed
remove_pronunciation_rule
Sept. 29, 2026, 2:50 a.m.
Changed
set_pronunciation_rule
Sept. 29, 2026, 2:50 a.m.
Changed
update_speech
Sept. 29, 2026, 2:50 a.m.
Changed
create_speech
Sept. 29, 2026, 2:50 a.m.
Changed
update_video
Sept. 29, 2026, 2:50 a.m.
Changed
create_video
Sept. 29, 2026, 2:50 a.m.
Changed
update_tutorial
Sept. 29, 2026, 2:50 a.m.
Changed
create_tutorial
Sept. 29, 2026, 2:50 a.m.
Changed
update_project
Sept. 29, 2026, 2:50 a.m.
Changed
create_project
Sept. 29, 2026, 2:50 a.m.
Changed
get_speech
Sept. 29, 2026, 2:50 a.m.
Changed
list_speeches
Sept. 29, 2026, 2:50 a.m.
Changed
get_video
Sept. 29, 2026, 2:50 a.m.
Changed
list_videos
Sept. 29, 2026, 2:50 a.m.
Changed
get_tutorial
Sept. 29, 2026, 2:50 a.m.
Changed
list_tutorials
Sept. 29, 2026, 2:50 a.m.
Changed
get_project_localization_summary
Sept. 29, 2026, 2:50 a.m.
Changed
get_project
Sept. 29, 2026, 2:50 a.m.
Changed
list_projects
Sept. 29, 2026, 2:50 a.m.
Added
show_project_overview
Sept. 21, 2026, 2:48 a.m.
Added
delete_video
Sept. 21, 2026, 2:48 a.m.
Added
delete_speech
Sept. 21, 2026, 2:48 a.m.
Added
delete_tutorial
Sept. 21, 2026, 2:48 a.m.
Added
remove_pronunciation_rule
Sept. 21, 2026, 2:48 a.m.
Added
set_pronunciation_rule
Sept. 21, 2026, 2:48 a.m.
Added
update_speech
Sept. 21, 2026, 2:48 a.m.