Quiz.Video MCP connector

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

2. Set your credentials

   Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

   .env

   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>

3. Authorize and make your first call

   Node.js

   quickstart.ts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENV_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions
   
   const connector = 'quizvideomcp'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Quiz.Video MCP:', link)
   process.stdout.write('Press Enter after authorizing...')
   await new Promise(r => process.stdin.once('data', r))
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'quizvideomcp_get_api_catalog',
     toolInput: {},
   })
   console.log(result)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "quizvideomcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Quiz.Video MCP:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="quizvideomcp_get_api_catalog",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• Get api catalog, llms txt, openapi spec — Return the Quiz.Video API catalog linkset for agent discovery
• Questions quiz video add quiz — Append one or more questions (with their answers and optional images) to an existing quiz
• Template quiz video apply — Apply a snapshot of a custom template to one or more quizzes you own
• Create quiz video — Create a flashcard deck
• Delete quiz video — Permanently delete a flashcard deck and all of its cards
• Render quiz video download — Request a signed download URL for a completed render

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

quizvideomcp_get_api_catalog#Return the Quiz.Video API catalog linkset for agent discovery.0 params▾

Return the Quiz.Video API catalog linkset for agent discovery.

quizvideomcp_get_llms_txt#Return a compact LLM-readable summary of the Quiz.Video API.0 params▾

Return a compact LLM-readable summary of the Quiz.Video API.

quizvideomcp_get_openapi_spec#Return the Quiz.Video OpenAPI 3.1 specification.0 params▾

Return the Quiz.Video OpenAPI 3.1 specification.

quizvideomcp_quiz_video_add_quiz_questions#Append one or more questions (with their answers and optional images) to an existing quiz.2 params▾

Append one or more questions (with their answers and optional images) to an existing quiz.

NameTypeRequiredDescription

questionsarrayrequiredOne or more questions to append to the quiz.

quizIdstringrequiredQuiz ID in YouTube-style 11-character base64url format.

quizvideomcp_quiz_video_apply_template#Apply a snapshot of a custom template to one or more quizzes you own. Sets each quiz's template field to "custom" and writes the snapshot into themeCustomization.customTemplate. Future edits to the source template do not auto-propagate.2 params▾

Apply a snapshot of a custom template to one or more quizzes you own. Sets each quiz's template field to "custom" and writes the snapshot into themeCustomization.customTemplate. Future edits to the source template do not auto-propagate.

NameTypeRequiredDescription

quizIdsarrayrequiredQuiz ids to apply the template to.

templateIdstringrequiredNo description.

quizvideomcp_quiz_video_create_flashcard_deck#Create a flashcard deck. Required: title (3-120 chars) and cards[] (min 1). Optional: description (≤1200 chars), tags (≤50 each).4 params▾

Create a flashcard deck. Required: title (3-120 chars) and cards[] (min 1). Optional: description (≤1200 chars), tags (≤50 each).

NameTypeRequiredDescription

cardsarrayrequiredFlashcards in the deck; at least one card is required.

titlestringrequiredDeck title (3–120 characters).

descriptionstringoptionalOptional deck description (≤1200 characters).

tagsarrayoptionalOptional tags to categorize the deck (≤50 characters each).

quizvideomcp_quiz_video_create_quiz#Create a quiz. Prefer sending themeDescription or themeCustomization so the saved quiz has a custom visual theme; if omitted, the server derives one from the title/description. Omit backgroundMusicId to use default YouTube-safe shared background music, or set null for silent. Required: title. Optional: description, format, quizType, template, countdownSeconds, difficulty, musicVolume, and questions[].12 params▾

Create a quiz. Prefer sending themeDescription or themeCustomization so the saved quiz has a custom visual theme; if omitted, the server derives one from the title/description. Omit backgroundMusicId to use default YouTube-safe shared background music, or set null for silent. Required: title. Optional: description, format, quizType, template, countdownSeconds, difficulty, musicVolume, and questions[].

NameTypeRequiredDescription

titlestringrequiredHuman-readable quiz title.

backgroundMusicIdnumberoptionalBackground music track id from /api/v1/music. Omit to use the default YouTube-safe shared track; set null for silent.

countdownSecondsnumberoptionalSeconds of countdown shown before each question (3–15).

descriptionstringoptionalOptional longer description shown on the quiz page.

difficultystringoptionalTarget difficulty level for the generated/created quiz.

formatstringoptionalOutput aspect ratio: "tiktok" (9:16 vertical) or "youtube" (16:9 horizontal).

musicVolumenumberoptionalBackground music volume from 0 (silent) to 1 (full). Default 0.15.

questionsarrayoptionalOptional initial questions with their answers and images.

quizTypestringoptionalQuiz mechanic: multiple_choice, reveal_answer, or picture_guess.

templatestringoptionalVisual template id (e.g. "neon", "minimal").

themeCustomizationobjectoptionalExplicit custom theme to save and apply to the quiz. Invalid colors/fonts are ignored by the API sanitizer.

themeDescriptionstringoptionalNatural-language custom visual theme prompt. Example: "golden luxury game show", "ocean glass", or "cyber neon". The server saves the generated themeCustomization and applies it automatically.

quizvideomcp_quiz_video_create_quiz_hook#Create a hook for a quiz. `hook` is a pass-through object whose fields follow the HookInput schema (see OpenAPI spec).2 params▾

Create a hook for a quiz. `hook` is a pass-through object whose fields follow the HookInput schema (see OpenAPI spec).

NameTypeRequiredDescription

hookobjectrequiredHookInput object (hookType, positionType, title, content, plus optional styling — see OpenAPI spec).

quizIdstringrequiredQuiz ID in YouTube-style 11-character base64url format.

quizvideomcp_quiz_video_create_render#Queue a new video render for an existing quiz. Returns the render sessionId; poll quiz_video_get_render until its status is "completed" (typically 1-5 minutes), then call quiz_video_download_render to obtain the signed MP4 URL. The quiz itself is viewable immediately at /quiz/{slug}/ regardless of render status.1 param▾

Queue a new video render for an existing quiz. Returns the render sessionId; poll quiz_video_get_render until its status is "completed" (typically 1-5 minutes), then call quiz_video_download_render to obtain the signed MP4 URL. The quiz itself is viewable immediately at /quiz/{slug}/ regardless of render status.

NameTypeRequiredDescription

quizIdstringrequiredID of the quiz to render into a video.

quizvideomcp_quiz_video_create_template#Save a new custom template authored in the drag-and-drop editor. Required: template (the CustomTemplate JSON). Optional: name, description, thumbnail, isDefault, isPublic.6 params▾

Save a new custom template authored in the drag-and-drop editor. Required: template (the CustomTemplate JSON). Optional: name, description, thumbnail, isDefault, isPublic.

NameTypeRequiredDescription

templateobjectrequiredCustomTemplate JSON with scenes.hook/question/answer and canvas.

descriptionstringoptionalNo description.

isDefaultbooleanoptionalMark as your default template (replaces any existing default).

isPublicbooleanoptionalMake discoverable to other users.

namestringoptionalNo description.

thumbnailstringoptionalOptional preview image URL or data URI.

quizvideomcp_quiz_video_delete_flashcard_deck#Permanently delete a flashcard deck and all of its cards.1 param▾

Permanently delete a flashcard deck and all of its cards.

NameTypeRequiredDescription

deckIdstringrequiredFlashcard deck ID.

quizvideomcp_quiz_video_delete_quiz#Permanently delete a quiz and all of its questions, answers, and hooks.1 param▾

Permanently delete a quiz and all of its questions, answers, and hooks.

NameTypeRequiredDescription

quizIdstringrequiredQuiz ID in YouTube-style 11-character base64url format.

quizvideomcp_quiz_video_delete_quiz_hook#Delete a single hook from a quiz.2 params▾

Delete a single hook from a quiz.

NameTypeRequiredDescription

hookIdnumberrequiredNumeric id of the hook to delete.

quizIdstringrequiredQuiz ID in YouTube-style 11-character base64url format.

quizvideomcp_quiz_video_delete_template#Permanently delete a custom template you own. Quizzes that have a snapshot of this template are unaffected — the snapshot remains in their themeCustomization.1 param▾

Permanently delete a custom template you own. Quizzes that have a snapshot of this template are unaffected — the snapshot remains in their themeCustomization.

NameTypeRequiredDescription

templateIdstringrequiredNo description.

quizvideomcp_quiz_video_download_render#Request a signed download URL for a completed render.1 param▾

Request a signed download URL for a completed render.

NameTypeRequiredDescription

sessionIdstringrequiredRender session id for a completed render.

quizvideomcp_quiz_video_generate_quiz#AI-generate and save a quiz from a topic. Prefer providing themeDescription or themeCustomization; when omitted, the server derives and saves a topic-based custom theme. Omit backgroundMusicId to use default YouTube-safe shared background music, or set null for silent. The response `data` always includes a `watchUrl` (the public quiz-viewer page, instantly playable). When autoRender is true, `data.render` also contains the queued render session so the agent can poll quiz_video_get_render for the MP4.15 params▾

AI-generate and save a quiz from a topic. Prefer providing themeDescription or themeCustomization; when omitted, the server derives and saves a topic-based custom theme. Omit backgroundMusicId to use default YouTube-safe shared background music, or set null for silent. The response `data` always includes a `watchUrl` (the public quiz-viewer page, instantly playable). When autoRender is true, `data.render` also contains the queued render session so the agent can poll quiz_video_get_render for the MP4.

NameTypeRequiredDescription

topicstringrequiredSubject the AI should build the quiz around.

answerOptionCountnumberoptionalFor multiple-choice quizzes, generate 3 or 4 answer options per question. Defaults to 4.

autoRenderbooleanoptionalIf true, immediately queue a video render for the new quiz. The render session (sessionId, status) is returned under `data.render`; poll quiz_video_get_render with that sessionId for progress and the final videoUrl. Rendering typically takes 1-5 minutes. Quiz creation is not blocked by render-queue failures — the quiz is returned either way.

backgroundMusicIdnumberoptionalBackground music track id from /api/v1/music. Omit to use the default YouTube-safe shared track; set null for silent.

countdownSecondsnumberoptionalSeconds of countdown shown before each question (3-15).

difficultystringoptionalTarget difficulty level.

extraDirectionstringoptionalAdditional instructions to steer the AI (tone, focus areas, exclusions).

formatstringoptionalOutput aspect ratio. Defaults to "tiktok".

musicVolumenumberoptionalBackground music volume from 0 (silent) to 1 (full). Default 0.15.

numberOfQuestionsnumberoptionalHow many questions to generate (1–200).

progressBarStylestringoptionalCountdown progress indicator style.

quizTypestringoptionalQuiz mechanic to generate.

templatestringoptionalVisual template id. If omitted, the saved custom theme can suggest a matching template.

themeCustomizationobjectoptionalExplicit custom theme to save and apply to the generated quiz. Use themeDescription for prompt-style themes.

themeDescriptionstringoptionalNatural-language custom visual theme prompt. Example: "golden luxury game show", "ocean glass", or "cyber neon".

quizvideomcp_quiz_video_get_account#Get the authenticated user's account info, plan, and usage limits.0 params▾

Get the authenticated user's account info, plan, and usage limits.

quizvideomcp_quiz_video_get_flashcard_deck#Fetch a flashcard deck (including all cards) by id.1 param▾

Fetch a flashcard deck (including all cards) by id.

NameTypeRequiredDescription

deckIdstringrequiredFlashcard deck ID.

quizvideomcp_quiz_video_get_quiz#Fetch a single quiz (including settings and metadata) by id.1 param▾

Fetch a single quiz (including settings and metadata) by id.

NameTypeRequiredDescription

quizIdstringrequiredQuiz ID in YouTube-style 11-character base64url format.

quizvideomcp_quiz_video_get_render#Fetch the status and progress of a render session. When status is "completed", the response also contains a signed `videoUrl` (and `filename`) so the agent can share the MP4 directly without a separate quiz_video_download_render call. In-progress polls return status + progress.1 param▾

Fetch the status and progress of a render session. When status is "completed", the response also contains a signed `videoUrl` (and `filename`) so the agent can share the MP4 directly without a separate quiz_video_download_render call. In-progress polls return status + progress.

NameTypeRequiredDescription

sessionIdstringrequiredRender session id returned when the render was started.

quizvideomcp_quiz_video_get_template#Fetch a single custom template (including the full scenes/layers payload) by id.1 param▾

Fetch a single custom template (including the full scenes/layers payload) by id.

NameTypeRequiredDescription

templateIdstringrequiredTemplate id (tpl_...).

quizvideomcp_quiz_video_list_flashcard_decks#List flashcard decks owned by the authenticated user with optional pagination.2 params▾

List flashcard decks owned by the authenticated user with optional pagination.

NameTypeRequiredDescription

limitnumberoptionalResults per page (1–100, default 20).

pagenumberoptional1-indexed page number.

quizvideomcp_quiz_video_list_music#List available background music tracks.0 params▾

List available background music tracks.

quizvideomcp_quiz_video_list_quiz_hooks#List video hooks configured for a quiz.1 param▾

List video hooks configured for a quiz.

NameTypeRequiredDescription

quizIdstringrequiredQuiz ID in YouTube-style 11-character base64url format.

quizvideomcp_quiz_video_list_quiz_questions#List questions (and their answers) for a quiz.1 param▾

List questions (and their answers) for a quiz.

NameTypeRequiredDescription

quizIdstringrequiredQuiz ID in YouTube-style 11-character base64url format.

quizvideomcp_quiz_video_list_quizzes#List quizzes owned by the authenticated user with optional pagination (page, limit).2 params▾

List quizzes owned by the authenticated user with optional pagination (page, limit).

NameTypeRequiredDescription

limitnumberoptionalResults per page (1–100, default 20).

pagenumberoptional1-indexed page number.

quizvideomcp_quiz_video_list_templates#List the caller's saved custom templates (and optionally public ones). Templates are reusable scene-based designs that can be applied to many quizzes.3 params▾

List the caller's saved custom templates (and optionally public ones). Templates are reusable scene-based designs that can be applied to many quizzes.

NameTypeRequiredDescription

includePublicbooleanoptionalInclude public templates in addition to your own. Default true.

limitnumberoptionalNo description.

pagenumberoptionalNo description.

quizvideomcp_quiz_video_update_quiz#Update a quiz. `updates` accepts any subset of quiz settings (title, description, format, template, timing, music, TTS, publish status, etc.).2 params▾

Update a quiz. `updates` accepts any subset of quiz settings (title, description, format, template, timing, music, TTS, publish status, etc.).

NameTypeRequiredDescription

quizIdstringrequiredQuiz ID in YouTube-style 11-character base64url format.

updatesobjectrequiredPartial quiz settings object; only included fields are updated.

quizvideomcp_quiz_video_update_quiz_hook#Update an existing hook on a quiz. Requires quizId and numeric hookId; `updates` is a partial HookInput.3 params▾

Update an existing hook on a quiz. Requires quizId and numeric hookId; `updates` is a partial HookInput.

NameTypeRequiredDescription

hookIdnumberrequiredNumeric id of the hook to update (from list_quiz_hooks).

quizIdstringrequiredQuiz ID in YouTube-style 11-character base64url format.

updatesobjectrequiredPartial HookInput object; only included fields are updated.

quizvideomcp_quiz_video_update_template#Update an existing template. Any subset of fields may be supplied; omitted fields stay unchanged.7 params▾

Update an existing template. Any subset of fields may be supplied; omitted fields stay unchanged.

NameTypeRequiredDescription

templateIdstringrequiredNo description.

descriptionstringoptionalNo description.

isDefaultbooleanoptionalNo description.

isPublicbooleanoptionalNo description.

namestringoptionalNo description.

templateobjectoptionalNo description.

thumbnailstringoptionalNo description.