MCP Server

Clipform

            io.github.Clipform/mcp-server
        

Marketing & Advertising Media & Content Public & reachable MCP 2025-11-25

What this MCP does

Builds interactive video forms and quizzes, manages form logic and responses, and generates or renders narrated video, audio, graphics, and other media assets.

clipform_add_node

Add Node

Add a new node to an existing form. Inserted before the end screen by default; after_node_id controls insertion position. Inserting into a linear flow automatically re-links the chain (the node before the insertion point points to the new node, which points to what followed) - you do not need clipform_set_logic for a simple insert. Branching still needs an explicit logic write. Node types and config schemas match clipform_create_form.

Input schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['form_id', 'node', 'context'], 'properties': {'node': {'type': 'object', 'required': ['type', 'prompt'], 'properties': {'type': {'enum': ['choice', 'open', 'details', 'payment', 'button', 'redirect', 'file_download', 'end_screen'], 'type': 'string'}, 'label': {'type': 'string', 'description': 'Short label for the node (used in logic builder). Defaults to the prompt text.'}, 'config': {'type': 'object', 'description': 'Type-specific configuration keyed by node type. Omit to use defaults. Per-type keys, shapes, and defaults are listed in the clipform_create_form description; craft guidance via clipform_get_guide.', 'additionalProperties': {}}, 'prompt': {'type': 'string', 'description': 'The text shown to the respondent'}, 'options': {'type': 'array', 'items': {'type': 'object', 'required': ['content'], 'properties': {'score': {'type': 'number', 'description': 'Score value for this option (for scored quizzes). Use 1 for correct, 0 for wrong. Scored options automatically enable correct-answer marking (record_scores) and correct/incorrect answer feedback on the node; set config.choice.show_answer_feedback: false to hide the feedback.'}, 'content': {'type': 'string', 'description': 'Option text'}, 'is_correct': {'type': 'boolean', 'description': 'Mark this as the correct answer for a quiz (maps to score 1; other options score 0). Use this OR score, not both.'}}, 'additionalProperties': False}, 'description': 'Answer options. choice: required, min 1, max 6, content max 36 chars button: required, min 1, max 1, content max 28 chars'}, 'required': {'type': 'boolean', 'default': True}}, 'description': 'The node to add', 'additionalProperties': False}, 'context': {'type': 'string', 'description': "Describe the user's underlying goal in one sentence - not the tool you're calling."}, 'form_id': {'type': 'string', 'format': 'uuid', 'description': 'The form UUID (returned by clipform_create_form, not the short share_id from the URL)'}, 'after_node_id': {'type': 'string', 'description': 'Insert after this node ID. Omit to append before the end screen.'}}}

Output schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['node_id', 'type'], 'properties': {'type': {'type': 'string', 'description': 'Node type that was added'}, 'node_id': {'type': 'string', 'description': 'ID of the created node - pass to update_node / attach_node_media'}}, 'additionalProperties': False}

clipform_attach_node_media

Attach Node Media

Attach an existing workspace media asset (from clipform_upload_media_asset) to one or more nodes (max 10). Pass one item or many; multiple items attach sequentially. Only works on node types that support media (choice, open, scale, draw, binary, button). A media asset is reusable - attach the same media_asset_id to several nodes.

Destructive Idempotent

Input schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['form_id', 'items', 'context'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'required': ['node_id', 'media_asset_id'], 'properties': {'node_id': {'type': 'string', 'description': 'The node ID'}, 'fit_media': {'type': 'boolean', 'description': 'Show the whole frame (contain) instead of cover-cropping. ALWAYS set true when attaching renders from clipform_render_composition or clipform_generate_video - they are composed 9:16 frames that must never be cropped. Leave unset for user-supplied media (arbitrary aspect ratios want the cover default).'}, 'show_captions': {'type': 'boolean', 'description': 'Display captions/subtitles on the node. Defaults to on; pass false to hide them.'}, 'media_asset_id': {'type': 'string', 'description': 'A media asset ID returned by clipform_upload_media_asset'}}, 'additionalProperties': False}, 'maxItems': 10, 'minItems': 1, 'description': 'One or more attachments to make'}, 'context': {'type': 'string', 'description': "Describe the user's underlying goal in one sentence - not the tool you're calling."}, 'form_id': {'type': 'string', 'format': 'uuid', 'description': 'The form UUID (returned by clipform_create_form, not the short share_id from the URL)'}}}

Output schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['results'], 'properties': {'results': {'type': 'array', 'items': {'type': 'object', 'required': ['node_id', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'error': {'type': 'string'}, 'node_id': {'type': 'string'}, 'media_asset_id': {'type': 'string'}}, 'additionalProperties': False}, 'description': 'One result per item, in order'}}, 'additionalProperties': False}

clipform_check_render

Check Render Status

Check the status of render jobs started by clipform_generate_video, clipform_render_video_template, or clipform_render_composition. Pass job_ids to check a whole batch in ONE call - one line of status per job. Pass job_id for a single job. Returns the output URL for each completed render. Typical render time: 10-60 seconds. Attach is automatic when node_id was provided to the render tool - no need to poll to completion, and the attach outcome is reported here once known.

Read only Idempotent

Input schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['context'], 'properties': {'job_id': {'type': 'string', 'format': 'uuid', 'description': 'A single job ID returned by the render tool'}, 'context': {'type': 'string', 'description': "Describe the user's underlying goal in one sentence - not the tool you're calling."}, 'job_ids': {'type': 'array', 'items': {'type': 'string', 'format': 'uuid'}, 'maxItems': 20, 'minItems': 1, 'description': 'Multiple job IDs - check the whole batch in one call instead of one call per job'}}}

Output schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['jobs'], 'properties': {'jobs': {'type': 'array', 'items': {'type': 'object', 'required': ['job_id', 'status'], 'properties': {'error': {'type': 'string'}, 'job_id': {'type': 'string'}, 'status': {'enum': ['rendering', 'complete', 'failed', 'not_found'], 'type': 'string'}, 'attached': {'type': 'boolean', 'description': "True when the render's node_id was set and it attached to the node automatically."}, 'public_url': {'type': 'string'}, 'republished': {'type': 'boolean', 'description': 'True when the form was live and was republished to include this media.'}, 'attach_error': {'type': 'string', 'description': 'Present when node_id was set but auto-attach failed - the render itself still succeeded.'}, 'media_asset_id': {'type': 'string', 'description': 'The workspace media asset created from this render, when attached.'}, 'elapsed_seconds': {'type': 'number'}, 'duration_seconds': {'type': 'number'}}, 'additionalProperties': False}, 'description': 'One entry per queried job; attach completed public_urls via upload_media_asset then attach_node_media unless already auto-attached'}}, 'additionalProperties': False}

clipform_complete_media_upload

Complete Media Upload

Confirm a signed-PUT still image upload finished, after PUTting the bytes to the upload_url returned by clipform_upload_media_asset. The API verifies the object actually landed in storage before flipping the asset from processing to ready - call this right after the PUT succeeds, or the asset stays invisible in the library. Not needed for video uploads (TUS/Mux settle automatically).

Idempotent

Input schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['media_asset_id', 'context'], 'properties': {'context': {'type': 'string', 'description': "Describe the user's underlying goal in one sentence - not the tool you're calling."}, 'media_asset_id': {'type': 'string', 'format': 'uuid', 'description': 'The media_asset_id returned by clipform_upload_media_asset for the still image'}}}

Output schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['media_asset_id', 'status'], 'properties': {'status': {'type': 'string', 'description': "The asset's status after this call - ready on success, or its already-settled status when called again (noop)"}, 'media_asset_id': {'type': 'string'}}, 'additionalProperties': False}

clipform_create_form

Create Clipform

Create a new Clipform (interactive video-style form). Returns a viewer URL and form ID. When connected via an authenticated MCP client (e.g. claude.ai), the form lands directly in the user's workspace. Anonymous sessions get a claim URL to transfer ownership later. If the user hasn't said what to build yet, offer to build their first form and suggest starting points: lead-gen, feedback, quiz, or something else. Node types (omit config to use defaults where shown): - choice: Single or multiple choice node with predefined options (supports options array). Config: choice ({enable_branching, show_answer_feedback, record_scores}), selection_mode ("single"|"multiple", default: "single"), allow_text_response (boolean, default: false), randomise_options (boolean, default: false), show_option_count (boolean, default: false), option_display ("list"|"letters", default: "list"). Defaults: {"selection_mode":"single","choice":{"enable_branching":false},"randomise_options":false,"show_option_count":false,"option_display":"list"} - open: Free-form text responses from users. Config: formats (array of {format, order}), max_recording_seconds (number, default: 120). Defaults: {"formats":[{"order":0,"format":"text"},{"order":1,"format":"audio"},{"order":2,"format":"video"}]} - details: Collect several fields on one screen - name, email, phone, address, date, and more. Config: title (string), fields (array of {id, type, label, order, required, is_custom}), description (string), consent_items (array of {id, name, label, order, type, document, require_scroll_to_accept}), Available field IDs: first_name, last_name, email, phone. Defaults: {"fields":[{"id":"first_name","type":"first_name","label":"First Name","enabled":true,"required":true},{"id":"email","type":"email","label":"Email","enabled":true,"required":true}],"consent_items":[]} - payment: Collect a payment from respondents inline, charged to a connected Stripe account. Config: amount (number), currency ("usd"|"eur"|"gbp"|"cad"|"aud", default: "usd"), provider ("stripe"|"paddle", default: "stripe"), workspace_integration_id (string), title (string), description (string). Defaults: {"amount":null,"currency":"usd","provider":"stripe"} - button: Simple button for acknowledgment or navigation (supports options array). Config: button_text (string, default: "Continue"), button_style ("primary"|"secondary"|"outline", default: "primary") - redirect: Redirect users to an external URL. Config: url (string), auto_redirect (boolean, default: true). Defaults: {"url":"","auto_redirect":true} - file_download: Provide a file for respondents to download. Config: files (array of {file_name, display_name, file_path, file_size, mime_type}), button_text (string, default: "Continue"), description (string) - end_screen: Final screen shown when form is completed. Config: title (string, default: "Thank you!"), message (string, default: "Your response has been submitted."), icon ("tick"|"trophy"|"star"|"crown"|"party"|"none", default: "tick"), show_share_button (boolean, default: false), cta_type ("none"|"restart"|"external_link", default: "none"), cta_text (string, default: "Continue"), cta_url (string). Defaults: {"title":"Thank you!","message":"Your response has been submitted."} All type definitions and config schemas are derived from @vid-master/config (node-types). Refer to the config descriptions above for the correct keys and shapes. AI-PROTECTED parameters have restrictions noted in their descriptions. Example: A form that asks a question, collects contact info, then finishes: { title: "Quick Survey", nodes: [ { type: "open", prompt: "What's your biggest challenge?" }, { type: "details", prompt: "Leave your details", config: { fields: [{ id: "first_name", required: true }, { id: "email", required: true }] } }, { type: "end_screen", prompt: "Thanks for your response!" } ] }

Open world

Input schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['title', 'nodes', 'context'], 'properties': {'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': "Tags for indexing (e.g. ['quiz', 'trivia', 'arsenal']). Include format, genre, and topics."}, 'nodes': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'prompt'], 'properties': {'type': {'enum': ['choice', 'open', 'details', 'payment', 'button', 'redirect', 'file_download', 'end_screen'], 'type': 'string'}, 'label': {'type': 'string', 'description': 'Short label for the node (used in logic builder). Defaults to the prompt text.'}, 'config': {'type': 'object', 'description': 'Type-specific configuration keyed by node type. Omit to use defaults. Per-type keys, shapes, and defaults are listed in the clipform_create_form description; craft guidance via clipform_get_guide.', 'additionalProperties': {}}, 'prompt': {'type': 'string', 'description': 'The text shown to the respondent'}, 'options': {'type': 'array', 'items': {'type': 'object', 'required': ['content'], 'properties': {'score': {'type': 'number', 'description': 'Score value for this option (for scored quizzes). Use 1 for correct, 0 for wrong. Scored options automatically enable correct-answer marking (record_scores) and correct/incorrect answer feedback on the node; set config.choice.show_answer_feedback: false to hide the feedback.'}, 'content': {'type': 'string', 'description': 'Option text'}, 'is_correct': {'type': 'boolean', 'description': 'Mark this as the correct answer for a quiz (maps to score 1; other options score 0). Use this OR score, not both.'}}, 'additionalProperties': False}, 'description': 'Answer options. choice: required, min 1, max 6, content max 36 chars button: required, min 1, max 1, content max 28 chars'}, 'required': {'type': 'boolean', 'default': True}}, 'additionalProperties': False}, 'minItems': 1, 'description': 'Ordered list of nodes/steps for the form'}, 'title': {'type': 'string', 'description': 'Form title'}, 'context': {'type': 'string', 'description': "Describe the user's underlying goal in one sentence - not the tool you're calling."}, 'font_family': {'type': 'string', 'description': 'AI-PROTECTED: Only set when the user explicitly requests a specific font.'}, 'primary_color': {'type': 'string', 'pattern': '^#[0-9A-Fa-f]{6}$', 'description': "Primary/brand color as 6-digit hex (e.g. '#FF5500'). Used for buttons and accents."}, 'background_color': {'type': 'string', 'pattern': '^#[0-9A-Fa-f]{6}$', 'description': "Background color as 6-digit hex (e.g. '#1A1A2E')."}, 'show_step_counter': {'type': 'boolean', 'description': "Show step counter (e.g. '1/5'). Set true for quizzes."}, 'disable_back_navigation': {'type': 'boolean', 'description': 'Prevent going back. Set true for quizzes.'}}}

Output schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['form_id', 'viewer_url', 'nodes'], 'properties': {'plan': {'type': 'object', 'required': ['name', 'auth_mode'], 'properties': {'name': {'type': 'string'}, 'auth_mode': {'type': 'string'}}, 'description': 'Plan and auth context for this session', 'additionalProperties': False}, 'nodes': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'type', 'prompt'], 'properties': {'id': {'type': 'string'}, 'type': {'type': 'string'}, 'prompt': {'type': 'string'}}, 'additionalProperties': False}, 'description': 'Created nodes in order - IDs for attach_node_media / update_node'}, 'form_id': {'type': 'string', 'description': 'Form UUID - pass to follow-up tools'}, 'viewer_url': {'type': 'string', 'description': 'Form URL for respondents - a live public URL once authenticated/published, or a scoped preview-only link for an anonymous session'}, 'dashboard_url': {'type': 'string', 'description': 'Builder URL (sign in to edit)'}}, 'additionalProperties': False}

clipform_delete_form

Delete Clipform

Move a form and all its nodes to the trash. It stops accepting responses immediately and can be restored later. Requires user confirmation before it runs.

Destructive Open world Idempotent

Input schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['form_id', 'context'], 'properties': {'confirm': {'type': 'boolean', 'description': 'Set to true ONLY after the user has explicitly confirmed this destructive action. Leave unset otherwise - hosts that support confirmation dialogs will prompt the user automatically.'}, 'context': {'type': 'string', 'description': "Describe the user's underlying goal in one sentence - not the tool you're calling."}, 'form_id': {'type': 'string', 'format': 'uuid', 'description': 'The form UUID to delete (returned by clipform_create_form, not the short share_id from the URL)'}}}

clipform_delete_node

Delete Node

Delete a node from a form. The logic chain is automatically re-linked (the previous node will point to the next one). Cannot delete the start node or the last end screen. Requires user confirmation before it runs.

Destructive Idempotent

Input schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['form_id', 'node_id', 'context'], 'properties': {'confirm': {'type': 'boolean', 'description': 'Set to true ONLY after the user has explicitly confirmed this destructive action. Leave unset otherwise - hosts that support confirmation dialogs will prompt the user automatically.'}, 'context': {'type': 'string', 'description': "Describe the user's underlying goal in one sentence - not the tool you're calling."}, 'form_id': {'type': 'string', 'format': 'uuid', 'description': 'The form UUID (returned by clipform_create_form, not the short share_id from the URL)'}, 'node_id': {'type': 'string', 'description': 'The node ID to delete'}}}

clipform_delete_node_media

Delete Node Media

Remove media from a node. Deletes the media record and cleans up external resources (Mux video asset, storage file). Requires user confirmation before it runs.

Destructive Idempotent

Input schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['form_id', 'node_id', 'context'], 'properties': {'confirm': {'type': 'boolean', 'description': 'Set to true ONLY after the user has explicitly confirmed this destructive action. Leave unset otherwise - hosts that support confirmation dialogs will prompt the user automatically.'}, 'context': {'type': 'string', 'description': "Describe the user's underlying goal in one sentence - not the tool you're calling."}, 'form_id': {'type': 'string', 'format': 'uuid', 'description': 'The form UUID (returned by clipform_create_form, not the short share_id from the URL)'}, 'node_id': {'type': 'string', 'description': 'The node ID'}}}

clipform_fetch_boundary

Fetch Geographic Boundary

Fetch a GeoJSON boundary polygon for a country, city, or region. Returns simplified GeoJSON ready to use as the 'boundary' prop in the Map composition. mainlandOnly excludes small islands and overseas territories (e.g. Corsica for France, Hawaii for USA).

Read only Open world Idempotent

Input schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query', 'context'], 'properties': {'type': {'enum': ['country', 'city', 'state', 'region'], 'type': 'string', 'default': 'country', 'description': 'Type of place to search for'}, 'query': {'type': 'string', 'description': "Place name (e.g. 'France', 'Paris', 'Tokyo', 'Brazil')"}, 'context': {'type': 'string', 'description': "Describe the user's underlying goal in one sentence - not the tool you're calling."}, 'maxPoints': {'type': 'number', 'default': 500, 'description': 'Maximum points per polygon ring for simplification (default 500, lower = smaller payload)'}, 'mainlandOnly': {'type': 'boolean', 'default': True, 'description': 'Keep only the largest landmass, excluding small islands and overseas territories'}}}

Output schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['name', 'geometry_type', 'size_kb', 'mainland_only', 'geojson'], 'properties': {'name': {'type': 'string', 'description': 'Resolved place name'}, 'geojson': {'type': 'string', 'description': 'The Feature GeoJSON as a JSON string - use as the boundary prop in the Map composition'}, 'size_kb': {'type': 'number', 'description': 'Approximate size of the returned GeoJSON in KB'}, 'geometry_type': {'enum': ['Polygon', 'MultiPolygon'], 'type': 'string'}, 'mainland_only': {'type': 'boolean'}}, 'additionalProperties': False}

clipform_generate_tts

Generate Text-to-Speech

Generate narration audio from text with word-level captions. Use this for quiz question narration, survey introductions, form instructions, or any node that benefits from a human voice. Proactively suggest narration for quizzes and content-rich forms - it significantly improves engagement. Available voices: ryan (British male, clear), sonia (British female, warm), andrew (American male, smooth), ava (American female, vibrant), guy (American male, deep). Pick ONE voice that fits the topic - e.g. a London quiz gets ryan or sonia, a US sports quiz gets andrew or guy - and reuse that SAME voice for every item and every call across the whole form. Never mix voices within one form unless the user explicitly asks for multiple voices. Use the tone parameter to direct HOW the voice speaks. Always set a tone that matches the form's mood - e.g. quizzes: "Energetic and playful, like a quiz show host teasing the audience", surveys: "Professional but warm, encouraging honest answers", personality quizzes: "Curious and reflective". This dramatically improves the narration quality. Pass one item or many (max 10) - multiple items run in parallel. Returns audio_url and caption_ref per item - pass caption_ref downstream to clipform_render_composition / clipform_render_video_template / clipform_upload_media_asset to attach this run's word-level captions instead of hand-copying the captions array.

Input schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['items', 'context'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'required': ['text'], 'properties': {'text': {'type': 'string', 'maxLength': 5000, 'minLength': 1, 'description': 'Narration text'}, 'tone': {'type': 'string', 'maxLength': 500, 'description': "Style instructions for how the voice should sound. E.g. 'Speak like an energetic quiz show host, playful and teasing' or 'Warm and conversational, like chatting with a friend'. Infer from context if not specified by the user."}, 'voice': {'enum': ['ryan', 'sonia', 'andrew', 'ava', 'guy'], 'type': 'string', 'default': 'ryan', 'description': 'Voice: ryan (British male, clear/articulate), sonia (British female, warm/bright), andrew (American male, smooth/neutral), ava (American female, vibrant/friendly), guy (American male, deep/authoritative). Pick ONE voice for the whole form based on its topic and audience, then reuse that same voice on every item and every call - never mix voices within a form unless the user explicitly asks for more than one.'}}, 'additionalProperties': False}, 'maxItems': 10, 'minItems': 1, 'description': 'One or more TTS items to generate'}, 'context': {'type': 'string', 'description': "Describe the user's underlying goal in one sentence - not the tool you're calling."}}}

Output schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['results'], 'properties': {'results': {'type': 'array', 'items': {'type': 'object', 'required': ['ok'], 'properties': {'ok': {'type': 'boolean'}, 'error': {'type': 'string'}, 'captions': {'type': 'array', 'items': {'type': 'object', 'required': ['start', 'end', 'text', 'words'], 'properties': {'end': {'type': 'number'}, 'text': {'type': 'string'}, 'start': {'type': 'number'}, 'words': {'type': 'array', 'items': {'type': 'object', 'required': ['word', 'start', 'end'], 'properties': {'end': {'type': 'number'}, 'word': {'type': 'string'}, 'start': {'type': 'number'}}, 'additionalProperties': False}, 'minItems': 1}}, 'additionalProperties': False}, 'description': 'Word-level captions, for reference only - prefer passing caption_ref downstream instead of copying this array.'}, 'audio_url': {'type': 'string'}, 'caption_ref': {'type': 'string', 'description': "Pass this as the caption_ref param on clipform_render_composition / clipform_render_video_template / clipform_upload_media_asset to attach this run's word-level captions - never hand-copy the captions array."}}, 'additionalProperties': False}, 'description': 'One result per item, in order'}}, 'additionalProperties': False}

clipform_generate_video

Generate Video

Generate a video from images, video clips, or both, synced to an audio track. Use this for narrated question backgrounds, topic visualisations, or any form node that benefits from video. Combine with clipform_generate_tts for narrated audio and clipform_search_media for royalty-free images. Creates 9:16 (720x1280) with Ken Burns pan/zoom effects and transitions. Returns a public URL when complete. Items: type "image" (Ken Burns motion) or "video" (cover-cropped, muted by default). Duration matches audio_url or set duration_seconds explicitly. For multi-question builds, pass wait: false on every render: each call returns a job ID immediately, so all renders run in parallel - then collect URLs with clipform_check_render. Sequential waiting renders take 15-120 seconds EACH. Choosing a render tool: for a recognisable form/quiz beat (guess-the-city, this-or-that, mystery reveal, multiple choice, photo montage...) reach for a video template first (clipform_list_video_templates + clipform_render_video_template) - it is a one-call recipe. Use clipform_generate_video for a narrated or audio-synced media montage (images/clips timed to a voice track). Use clipform_render_composition only when neither fits and you need a custom layer stack. Montage disambiguation: choose clipform_generate_video when the montage is narrated or synced to an audio track; choose the slideshow video template when it is silent (motion + transitions only, no voice-over). A render for a form node is not done until it is attached to that node. Pass node_id (and form_id) so the completed render attaches itself automatically - do not poll clipform_check_render to completion or manually chain clipform_upload_media_asset + clipform_attach_node_media; fire the render and move on.

Destructive Open world

Input schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['items', 'context'], 'properties': {'wait': {'type': 'boolean', 'default': True, 'description': 'true (default) blocks until the video is ready and returns its URL. false returns a job ID immediately - fire all renders first, then poll clipform_check_render. Use false whenever rendering more than one video.'}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'url'], 'properties': {'fit': {'enum': ['cover', 'blur-pad', 'auto'], 'type': 'string', 'description': 'Framing mode (image only). auto = cover for portrait, blur-pad for landscape.'}, 'url': {'type': 'string', 'format': 'uri', 'description': 'Media URL'}, 'type': {'enum': ['image', 'video'], 'type': 'string', 'description': "'image' for still images with Ken Burns effects, 'video' for video clips"}, 'effect': {'enum': ['pan-left', 'pan-right', 'pan-up', 'pan-down', 'zoom-in-pan-left', 'zoom-in-pan-right', 'zoom-in', 'zoom-out', 'static', 'random'], 'type': 'string', 'description': "Advanced override: a specific Ken Burns effect (image only), overriding the preset look's own effect choice"}, 'volume': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Clip audio volume 0-1 (video only, default 0 = muted)'}, 'start_from': {'type': 'number', 'minimum': 0, 'description': 'Start time in seconds (video only). Trims the clip.'}, 'aspect_ratio': {'type': 'number', 'description': 'Image width/height ratio (image only). Enables auto blur-pad for landscape images.', 'exclusiveMinimum': 0}}, 'additionalProperties': False}, 'maxItems': 20, 'minItems': 1, 'description': 'Media items (images, video clips, or a mix)'}, 'preset': {'enum': ['clean', 'editorial', 'punchy', 'bold-poster'], 'type': 'string', 'default': 'clean', 'description': "Named look driving transition + motion + colour treatment together (default: 'clean'). One of: clean, editorial, punchy, bold-poster. The advanced fields below (transition, style_preset, texture, duotone, background_color, per-item effect) override individual pieces of the chosen look when set."}, 'context': {'type': 'string', 'description': "Describe the user's underlying goal in one sentence - not the tool you're calling."}, 'duotone': {'type': 'object', 'required': ['shadow', 'highlight'], 'properties': {'shadow': {'type': 'string', 'description': "Darker tone (maps to image shadows), e.g. '#1a1633'"}, 'contrast': {'type': 'number', 'description': 'Contrast boost before mapping (default 1.1)', 'exclusiveMinimum': 0}, 'highlight': {'type': 'string', 'description': "Lighter tone (maps to image highlights), e.g. '#f5c542'"}}, 'description': "Advanced override: two-tone editorial recolour on image items, overriding the preset look's own duotone - desaturates then maps to a shadow->highlight palette. Pair with a halftone texture for a screen-print poster look.", 'additionalProperties': False}, 'form_id': {'type': 'string', 'format': 'uuid', 'description': 'The form UUID (required when node_id is set).'}, 'node_id': {'type': 'string', 'description': "Form node to attach this render to automatically once it completes - skips the manual clipform_upload_media_asset + clipform_attach_node_media steps and republishes the form if it's currently live. Requires form_id."}, 'texture': {'type': 'object', 'required': ['type'], 'properties': {'type': {'enum': ['checker', 'halftone', 'scanlines'], 'type': 'string', 'description': 'checker = square dither mesh, halftone = dot grid, scanlines = horizontal lines'}, 'sizePx': {'type': 'number', 'description': 'Pattern cell size in px (default 4)', 'exclusiveMinimum': 0}, 'opacity': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Pattern darkness 0-1 (default 0.35)'}}, 'description': "Advanced override: print-style pattern overlay on image items, overriding the preset look's own texture - makes stock imagery read as designed (screen-print dither look)", 'additionalProperties': False}, 'captions': {'type': 'array', 'items': {'type': 'object', 'required': ['start', 'end', 'text', 'words'], 'properties': {'end': {'type': 'number', 'description': 'Segment end time in seconds'}, 'text': {'type': 'string', 'description': 'Full segment text'}, 'start': {'type': 'number', 'description': 'Segment start time in seconds'}, 'words': {'type': 'array', 'items': {'type': 'object', 'required': ['word', 'start', 'end'], 'properties': {'end': {'type': 'number'}, 'word': {'type': 'string'}, 'start': {'type': 'number'}}, 'additionalProperties': False}, 'minItems': 1, 'description': 'Per-word timestamps within the segment. Required - copy the full array from clipform_generate_tts verbatim.'}}, 'additionalProperties': False}, 'description': 'Word-level captions from clipform_generate_tts - carried onto the attached media asset. Only used when node_id is set.'}, 'audio_url': {'type': 'string', 'format': 'uri', 'description': 'Audio track URL. Video duration matches audio duration.'}, 'transition': {'type': 'object', 'properties': {'type': {'enum': ['fade', 'slide', 'wipe', 'none'], 'type': 'string', 'description': "Advanced override: fade, slide, wipe, none - overrides the preset look's own transition"}, 'duration': {'type': 'number', 'maximum': 5, 'minimum': 0.1, 'description': "Advanced override: transition duration in seconds (0.1-5). For a hard cut use type: 'none' instead - duration is ignored then."}}, 'description': "Advanced: overrides the preset look's transition", 'additionalProperties': False}, 'style_preset': {'enum': ['cinematic', 'dramatic', 'calm', 'documentary', 'dreamy', 'moody', 'energetic'], 'type': 'string', 'description': "Advanced override: a raw Ken Burns motion preset, overriding the preset look's own motion."}, 'random_effects': {'type': 'boolean', 'default': True, 'description': 'Shuffle Ken Burns effects across image items (default: true)'}, 'background_color': {'type': 'string', 'description': "Advanced override: background color, overriding the preset look's own background (default '#000')"}, 'duration_seconds': {'type': 'number', 'description': 'Video duration in seconds (required if no audio_url)', 'exclusiveMinimum': 0}, 'background_audio_url': {'type': 'string', 'format': 'uri', 'description': 'Ambience/music bed under the narration (crowd noise, room tone). Loops to fill the video. Find tracks with clipform_search_music.'}, 'background_audio_volume': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Background bed volume 0-1 (default 0.15 - sits under speech)'}}}

Output schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status'], 'properties': {'job_id': {'type': 'string', 'description': "Present when status is 'rendering' - pass to check_render"}, 'status': {'enum': ['rendering', 'complete'], 'type': 'string', 'description': "'rendering' when wait:false (poll check_render); 'complete' with a public_url when wait:true"}, 'attached': {'type': 'boolean', 'description': 'True when node_id was provided and the render was attached to the node automatically (present once the attach outcome is known).'}, 'public_url': {'type': 'string', 'description': "Present when status is 'complete' - attach via upload_media_asset then attach_node_media (fit_media: true), unless node_id was set (auto-attached)"}, 'republished': {'type': 'boolean', 'description': 'True when the form was live and was republished to include this media.'}, 'attach_error': {'type': 'string', 'description': 'Present when node_id was provided but auto-attach failed - the render itself still succeeded.'}, 'media_asset_id': {'type': 'string', 'description': 'The workspace media asset created from this render, when attached.'}, 'duration_seconds': {'type': 'number'}}, 'additionalProperties': False}

clipform_get_form

Get Clipform

Retrieve a form's details including all nodes in sequential order and their routing. Returns title, settings, and every node with its options, config, media status, and next node (from clipform_set_logic).

Read only Idempotent

Input schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['form_id', 'context'], 'properties': {'context': {'type': 'string', 'description': "Describe the user's underlying goal in one sentence - not the tool you're calling."}, 'form_id': {'type': 'string', 'format': 'uuid', 'description': 'The form UUID (returned by clipform_create_form, not the short share_id from the URL)'}}}

Output schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['form_id', 'title', 'is_live', 'has_unpublished_changes', 'nodes'], 'properties': {'urls': {'type': 'object', 'properties': {'embed': {'type': 'string', 'description': 'Embed setup for websites. Not present for an anonymous caller.'}, 'share': {'type': 'string', 'description': 'Share tab - link, QR, social. Not present for an anonymous caller.'}, 'viewer': {'type': 'string', 'description': "Live respondent link, or a scoped preview link for an anonymous caller's draft. Omitted for a non-anonymous caller's unpublished draft."}, 'builder': {'type': 'string', 'description': 'Build tab - the node/canvas editor. Not present for an anonymous caller.'}, 'summary': {'type': 'string', 'description': 'Summary tab - form overview and key stats. Not present for an anonymous caller.'}, 'analytics': {'type': 'string', 'description': 'Analytics tab - views, starts, completion rate, drop-off per node. Not present for an anonymous caller.'}, 'responses': {'type': 'string', 'description': 'Responses tab - individual submissions. Not present for an anonymous caller.'}, 'dynamic_link': {'type': 'string', 'description': 'Dynamic/personalized link setup. Not present for an anonymous caller.'}}, 'description': "Dashboard/viewer deeplinks for this form. An anonymous caller gets only 'viewer'.", 'additionalProperties': False}, 'nodes': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'type', 'prompt', 'required'], 'properties': {'id': {'type': 'string'}, 'next': {'type': 'object', 'required': ['target_id', 'target_type'], 'properties': {'target_id': {'type': 'string', 'description': 'The node/screen ID this node routes to'}, 'target_type': {'enum': ['node', 'end_screen', 'redirect', 'link_list'], 'type': 'string', 'description': 'What kind of target target_id is'}}, 'description': "This node's outgoing edge, set via clipform_set_logic. Omitted for a chain tail or terminal node.", 'additionalProperties': False}, 'type': {'type': 'string'}, 'config': {'type': 'object', 'additionalProperties': {}}, 'prompt': {'type': 'string'}, 'options': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'content'], 'properties': {'id': {'type': 'string'}, 'content': {'type': 'string'}}, 'additionalProperties': False}}, 'required': {'type': 'boolean'}}, 'additionalProperties': False}, 'description': 'Nodes in sequential order - IDs for update_node / attach_node_media'}, 'title': {'type': 'string', 'description': 'Form title'}, 'form_id': {'type': 'string', 'description': 'Form UUID'}, 'is_live': {'type': 'boolean', 'description': 'Whether the form is published'}, 'has_unpublished_changes': {'type': 'boolean', 'description': 'Live form has edits not yet republished'}}, 'additionalProperties': False}

clipform_get_guide

Get Craft Guide

Retrieve craft knowledge for building a specific form type. Returns question psychology, difficulty curves, narration style, scoring setup, and writing principles as markdown. Does NOT return a step-by-step build workflow - use clipform_get_workflow for that. Available types: quiz, survey, interview, funnel, testimonial, application, booking, intake, lead-capture. Aliases also accepted: trivia → quiz, test → quiz, exam → quiz, feedback → survey, poll → survey, nps → survey, questionnaire → survey, case-study → interview, callout → interview, lead-gen → funnel, qualification → funnel, lead-magnet → funnel, story → testimonial, review → testimonial, job-application → application, admission → application, enrollment → application, grant → application, registration → booking, signup → booking, event → booking, rsvp → booking, workshop → booking, client-intake → intake, onboarding → intake, enquiry → intake, inquiry → intake, new-client → intake, lead → lead-capture, lead-form → lead-capture, enquiry-form → lead-capture, waitlist → lead-capture, get-a-quote → lead-capture. Quiz variants (optional): personality, comprehension, composition - appends variant-specific addendum to the base quiz guide.

Read only Idempotent

Input schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['type', 'context'], 'properties': {'type': {'type': 'string', 'description': "Form type to get the craft guide for (accepts aliases like 'feedback' → survey)"}, 'context': {'type': 'string', 'description': "Describe the user's underlying goal in one sentence - not the tool you're calling."}, 'variant': {'enum': ['personality', 'comprehension', 'composition'], 'type': 'string', 'description': "Quiz sub-variant. Only used when type is 'quiz'. Omit for a standard scored quiz."}}}

clipform_get_node_media

Get Node Media

Get the media attached to a node, including processing status. Useful for checking if a video upload has finished processing.

Read only Idempotent

Input schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['form_id', 'node_id', 'context'], 'properties': {'context': {'type': 'string', 'description': "Describe the user's underlying goal in one sentence - not the tool you're calling."}, 'form_id': {'type': 'string', 'format': 'uuid', 'description': 'The form UUID (returned by clipform_create_form, not the short share_id from the URL)'}, 'node_id': {'type': 'string', 'description': 'The node ID'}}}

Output schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['media'], 'properties': {'media': {'anyOf': [{'type': 'object', 'required': ['media_type', 'status'], 'properties': {'status': {'type': 'string'}, 'duration': {'type': 'number'}, 'media_type': {'type': 'string'}, 'transcription_status': {'type': ['string', 'null']}}, 'additionalProperties': False}, {'type': 'null'}], 'description': 'Attached media (null if the node has none)'}}, 'additionalProperties': False}

clipform_get_responses

List form responses

List a Clipform form's individual responses (submissions) with time filtering - complements clipform_get_results (aggregates). Answers questions like 'what came in during the last 24 hours', 'what's the longest answer', 'what did people say'. Text answers plus a non-PII payment summary (amount and status); contact details, file uploads, and audio/video answers are redacted to placeholders and the customer's payment details stay in the dashboard (the responses URL from clipform_get_form). Responses are sorted newest first unless sort: 'oldest'.

Read only Idempotent

Input schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['form_id', 'context'], 'properties': {'sort': {'enum': ['newest', 'oldest'], 'type': 'string', 'description': 'Order by submission time. Default: newest'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Max responses to return (default 20, max 50)'}, 'query': {'type': 'string', 'description': 'Only responses whose text answers contain this string (case-insensitive)'}, 'since': {'type': 'string', 'format': 'date-time', 'description': "Only responses submitted at or after this ISO 8601 time (e.g. '2026-08-29T00:00:00Z')"}, 'until': {'type': 'string', 'format': 'date-time', 'description': 'Only responses submitted at or before this ISO 8601 time'}, 'context': {'type': 'string', 'description': "Describe the user's underlying goal in one sentence - not the tool you're calling."}, 'form_id': {'type': 'string', 'description': 'Form UUID (from clipform_list_forms / clipform_create_form)'}}}

Output schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['total_matching', 'returned', 'locked_over_plan_limit', 'responses'], 'properties': {'returned': {'type': 'number', 'description': 'Responses in this result'}, 'responses': {'type': 'array', 'items': {'type': 'object', 'required': ['submitted_at', 'status', 'answers'], 'properties': {'status': {'type': 'string'}, 'answers': {'type': 'array', 'items': {'type': 'object', 'required': ['question', 'type', 'answer'], 'properties': {'type': {'type': 'string'}, 'answer': {'type': 'string', 'description': 'Text answer, or a redaction placeholder'}, 'question': {'type': 'string'}}, 'additionalProperties': False}}, 'submitted_at': {'type': 'string', 'description': 'ISO 8601 submission time'}}, 'additionalProperties': False}, 'description': 'Matching responses, filtered/sorted/capped per the inputs'}, 'total_matching': {'type': 'number', 'description': 'Responses matching the filters (before the limit cap)'}, 'locked_over_plan_limit': {'type': 'number', 'description': "Matching responses hidden by the plan's response limit"}}, 'additionalProperties': False}

clipform_get_results

Get Clipform Results

View response counts, choice/action answer breakdowns, and recent open-text answers for a form. Contact, file, draw, camera, and payment answers are counts only - use the dashboard for per-response detail.

Read only Idempotent

Input schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['form_id', 'context'], 'properties': {'context': {'type': 'string', 'description': "Describe the user's underlying goal in one sentence - not the tool you're calling."}, 'form_id': {'type': 'string', 'description': 'The form UUID (returned by clipform_create_form, not the short share_id from the URL)'}}}

Output schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['total_responses', 'nodes'], 'properties': {'nodes': {'type': 'array', 'items': {'type': 'object', 'required': ['node_id', 'node_type', 'prompt', 'total_responses', 'total_views'], 'properties': {'prompt': {'type': 'string'}, 'node_id': {'type': 'string'}, 'options': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'count', 'percentage'], 'properties': {'count': {'type': 'number'}, 'label': {'type': 'string'}, 'percentage': {'type': 'number'}}, 'additionalProperties': False}, 'description': 'Answer breakdown - choice and action-category (booking/file_download/shopping) nodes only'}, 'node_type': {'type': 'string'}, 'total_views': {'type': 'number'}, 'recent_answers': {'type': 'array', 'items': {'type': 'object', 'required': ['text', 'submitted_at'], 'properties': {'text': {'type': 'string'}, 'submitted_at': {'type': 'string'}}, 'additionalProperties': False}, 'description': 'Most recent open-text answers, capped at 20 - open questions only'}, 'total_responses': {'type': 'number'}}, 'additionalProperties': False}, 'description': 'Nodes in form order. Contact/file/draw/camera/payment nodes carry only total_responses/total_views - no per-response detail.'}, 'results_url': {'type': 'string', 'description': 'Dashboard Responses tab for this form. Not present for an anonymous caller.'}, 'total_responses': {'type': 'number', 'description': 'Total unique respondents to the form'}}, 'additionalProperties': False}

clipform_get_workflow

Get Build Workflow

Retrieve a step-by-step build workflow for creating a specific form type. Returns the exact tool sequence, form settings, node configuration, scoring setup, and end screen config as a build recipe. Does NOT return craft knowledge (question psychology, difficulty curves, narration style) - use clipform_get_guide for that. Available types: quiz, survey, interview, testimonial, application, booking, intake, lead-capture. Aliases also accepted: trivia → quiz, test → quiz, exam → quiz, feedback → survey, poll → survey, nps → survey, questionnaire → survey, case-study → interview, callout → interview, lead-gen → funnel, qualification → funnel, lead-magnet → funnel, story → testimonial, review → testimonial, job-application → application, admission → application, enrollment → application, grant → application, registration → booking, signup → booking, event → booking, rsvp → booking, workshop → booking, client-intake → intake, onboarding → intake, enquiry → intake, inquiry → intake, new-client → intake, lead → lead-capture, lead-form → lead-capture, enquiry-form → lead-capture, waitlist → lead-capture, get-a-quote → lead-capture. Quiz variants (optional): personality, comprehension, composition - returns the variant-specific workflow instead of the base quiz workflow. Optional args by type: - quiz: topic, question_count (8) - quiz (variant: personality): topic, categories, question_count (8) - quiz (variant: comprehension): youtube_url, question_count (8), audience - interview: purpose, response_format (all), needs_consent (true) - survey: topic, anonymous (true) - funnel: outcomes, criteria, needs_contact (true) - testimonial: use_case - application: role - booking: event_name, event_type - intake: use_case, response_format (all) - lead-capture: use_case

Read only Idempotent

Input schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['type', 'context'], 'properties': {'role': {'type': 'string', 'description': 'What the application is for (application)'}, 'type': {'type': 'string', 'description': "Form type to get the build workflow for (accepts aliases like 'feedback' → survey)"}, 'topic': {'type': 'string', 'description': 'Topic or theme (quiz, survey)'}, 'context': {'type': 'string', 'description': "Describe the user's underlying goal in one sentence - not the tool you're calling."}, 'purpose': {'type': 'string', 'description': "What you're collecting (interview)"}, 'variant': {'enum': ['personality', 'comprehension', 'composition'], 'type': 'string', 'description': "Quiz sub-variant. Only used when type is 'quiz'. Omit for a standard scored quiz."}, 'audience': {'type': 'string', 'description': 'Target audience (quiz variant: comprehension)'}, 'criteria': {'type': 'string', 'description': 'Routing criteria (funnel)'}, 'outcomes': {'type': 'string', 'description': 'Segments or recommendations (funnel)'}, 'use_case': {'type': 'string', 'description': 'What stories to collect (testimonial)'}, 'anonymous': {'type': 'boolean', 'description': 'Anonymous survey (survey)'}, 'categories': {'type': 'string', 'description': 'Comma-separated outcome categories (quiz variant: personality)'}, 'event_name': {'type': 'string', 'description': 'Event or offering name (booking)'}, 'event_type': {'type': 'string', 'description': 'Type of event (booking)'}, 'youtube_url': {'type': 'string', 'description': 'YouTube video URL (quiz variant: comprehension)'}, 'needs_consent': {'type': 'boolean', 'description': 'Include consent statement (interview)'}, 'needs_contact': {'type': 'boolean', 'description': 'Include contact capture (funnel)'}, 'question_count': {'type': 'number', 'description': 'Number of questions, default 8 (quiz types)'}, 'response_format': {'enum': ['video', 'audio', 'text', 'all'], 'type': 'string', 'description': 'How respondents reply (interview)'}}}

clipform_import_form

Import Form

Convert a public Google Form, Typeform, or Tally form into a new Clipform. Supported URLs: Google Forms (docs.google.com or forms.gle - must be shared as "Anyone with the link"), Typeform (form.typeform.com/to/...), and Tally (tally.so - must be public). The source form must be publicly accessible; a private form's questions cannot be read. The new Clipform is created as a DRAFT - review it, then republish with clipform_update_form (is_live: true) once it's ready. Some question types don't map cleanly to a Clipform node and are skipped rather than guessed at; the result always reports exactly what was imported vs skipped, and why.

Open world

Input schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['url', 'context'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Public URL of the Google Form, Typeform, or Tally form to import'}, 'context': {'type': 'string', 'description': "Describe the user's underlying goal in one sentence - not the tool you're calling."}}}

Output schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['form_id', 'viewer_url', 'import_summary'], 'properties': {'form_id': {'type': ['string', 'null'], 'description': "New form's UUID - pass to follow-up tools. Null when no importable questions were found (nothing was created)."}, 'viewer_url': {'type': ['string', 'null'], 'description': 'The address this form WILL be live at once published (clipform_update_form with is_live: true) - it is a draft and is NOT viewable by anyone yet; opening it now shows a maintenance screen, not the form. Null when no importable questions were found.'}, 'import_summary': {'type': 'object', 'required': ['title', 'total_questions', 'imported', 'skipped', 'skipped_details', 'warnings'], 'properties': {'title': {'type': 'string', 'description': 'Title of the source form'}, 'skipped': {'type': 'number', 'description': 'Questions that could not be converted'}, 'imported': {'type': 'number', 'description': 'Questions successfully converted into Clipform nodes'}, 'warnings': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Non-fatal issues surfaced during the import'}, 'skipped_details': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': {'type': 'string'}}, 'description': 'Per-skipped-question title, reason, and source question type'}, 'total_questions': {'type': 'number', 'description': 'Total questions found in the source form'}}, 'additionalProperties': False}}, 'additionalProperties': False}

clipform_list_assets

List Assets

List available creative assets (sound effects, animations, fonts) for video compositions.

Read only Idempotent

Input schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['context'], 'properties': {'type': {'enum': ['sfx', 'animation', 'font', 'all'], 'type': 'string', 'default': 'all', 'description': 'Asset type to list (default: all)'}, 'context': {'type': 'string', 'description': "Describe the user's underlying goal in one sentence - not the tool you're calling."}}}

Output schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['sfx', 'animations', 'fonts'], 'properties': {'sfx': {'type': 'array', 'items': {'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string'}, 'path': {'type': 'string'}, 'description': {'type': ['string', 'null']}}, 'additionalProperties': False}}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string'}, 'weights': {'type': 'array', 'items': {'type': ['string', 'number']}}}, 'additionalProperties': False}}, 'animations': {'type': 'array', 'items': {'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string'}, 'path': {'type': 'string'}, 'description': {'type': ['string', 'null']}}, 'additionalProperties': False}}}, 'additionalProperties': False}

clipform_list_compositions

List Compositions

Browse available video compositions and their expected props schemas. Call this before using clipform_render_composition to discover visual styles and their input props. For an image or photo montage, reach for a video template (clipform_list_video_templates + clipform_render_video_template) or clipform_generate_video instead of a composition.

Read only Idempotent

Input schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['context'], 'properties': {'context': {'type': 'string', 'description': "Describe the user's underlying goal in one sentence - not the tool you're calling."}}}

Output schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['compositions'], 'properties': {'compositions': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'width', 'height', 'fps', 'durationInFrames', 'props'], 'properties': {'id': {'type': 'string'}, 'fps': {'type': 'number'}, 'props': {'type': 'string', 'description': 'Compact props summary (name*: type)'}, 'width': {'type': 'number'}, 'height': {'type': 'number'}, 'propsSchema': {'type': 'object', 'description': 'Full JSON Schema for inputProps', 'additionalProperties': {}}, 'durationInFrames': {'type': 'number'}}, 'additionalProperties': False}, 'description': 'Available compositions - pass an id to render_composition'}}, 'additionalProperties': False}

clipform_list_forms

List Clipforms

List forms in your workspace with optional filtering. Returns paginated results (cursor-based). next_cursor is included when more results exist. To find or open a form by name, pass search with part of its title instead of paging through results.

Read only Idempotent

Input schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['context'], 'properties': {'tag': {'type': 'string', 'description': 'Filter by tag name(s), comma-separated. AND logic: only forms with ALL tags are returned.'}, 'sort': {'enum': ['created_at', 'updated_at'], 'type': 'string', 'description': 'Sort field (default: created_at)'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Number of forms to return (default 25, max 100)'}, 'order': {'enum': ['asc', 'desc'], 'type': 'string', 'description': 'Sort order (default: desc, newest first)'}, 'cursor': {'type': 'string', 'description': "Pagination cursor from previous response's next_cursor"}, 'search': {'type': 'string', 'description': 'Filter to forms whose title contains this text (case-insensitive substring). Use this to resolve a form by name in one call instead of paginating.'}, 'context': {'type': 'string', 'description': "Describe the user's underlying goal in one sentence - not the tool you're calling."}, 'published': {'enum': ['true', 'false'], 'type': 'string', 'description': 'Filter by publish status'}}}

Output schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['forms', 'next_cursor'], 'properties': {'forms': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'share_id', 'is_live', 'has_unpublished_changes', 'tags'], 'properties': {'id': {'type': 'string'}, 'tags': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'color'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'color': {'type': ['string', 'null']}}, 'additionalProperties': False}}, 'title': {'type': 'string'}, 'is_live': {'type': 'boolean'}, 'share_id': {'type': 'string'}, 'viewer_url': {'type': 'string', 'description': 'Live respondent link. Only present for a published (is_live) form, and not for an anonymous caller.'}, 'builder_url': {'type': 'string', 'description': 'Dashboard Build tab for this form. Not present for an anonymous caller.'}, 'has_unpublished_changes': {'type': 'boolean'}}, 'additionalProperties': False}, 'description': 'Matching forms (empty if none)'}, 'next_cursor': {'type': ['string', 'null'], 'description': 'Pass as cursor to fetch the next page, or null when no more'}}, 'additionalProperties': False}

clipform_list_video_templates

List Video Templates

Browse available video templates - curated Scene arrangements (bed + overlay + sane defaults) that render through the Scene composition from a small controls object. Call this before clipform_render_video_template to see template names and their exposed controls. For a fully custom layer stack, assemble Scene layers directly via clipform_render_composition instead.

Read only Idempotent

Input schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['context'], 'properties': {'context': {'type': 'string', 'description': "Describe the user's underlying goal in one sentence - not the tool you're calling."}}}

Output schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['templates'], 'properties': {'templates': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'tier', 'description', 'keywords', 'controls'], 'properties': {'name': {'type': 'string'}, 'tier': {'type': 'string'}, 'controls': {'type': 'array', 'items': {'type': 'string'}, 'description': "Control names, '?'-suffixed when optional"}, 'keywords': {'type': 'array', 'items': {'type': 'string'}, 'description': "Natural-language phrases a user's intent might match against this template"}, 'description': {'type': 'string'}, 'exampleControls': {'type': 'object', 'description': 'A worked, ready-to-render controls object for this template - copy and adapt it', 'additionalProperties': {}}}, 'additionalProperties': False}, 'description': 'Available video templates - pass a name + controls to clipform_render_video_template'}}, 'additionalProperties': False}

clipform_log_generation

Log Form Generation Audit

Internal audit step run by a form-generation workflow. Records a completed generation's content provenance (sources, image attributions) for the flow that just built the form. Not a user action - only call it as the final step of a generation workflow you are running, never in response to a plain create or edit request.

Input schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['form_id', 'summary', 'details', 'context'], 'properties': {'context': {'type': 'string', 'description': "Describe the user's underlying goal in one sentence - not the tool you're calling."}, 'details': {'type': 'object', 'properties': {'images': {'type': 'array', 'items': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string'}, 'license': {'type': 'string'}, 'attribution': {'type': 'string'}}, 'additionalProperties': False}, 'description': 'Images used with attribution'}, 'sources': {'type': 'array', 'items': {'type': 'object', 'required': ['title'], 'properties': {'url': {'type': 'string'}, 'type': {'type': 'string'}, 'title': {'type': 'string'}}, 'additionalProperties': False}, 'description': 'Knowledge sources used'}}, 'description': 'Content sources and attributions', 'additionalProperties': False}, 'form_id': {'type': 'string', 'format': 'uuid', 'description': 'The form ID (UUID format, not the share ID)'}, 'summary': {'type': 'string', 'description': 'Short description of what was generated'}}}

clipform_render_composition

Render Composition

Render a specialised video composition to MP4 or PNG - custom animated visuals that clipform_generate_video can't provide, such as geography animations or designed motion graphics. Available composition names and their required input props schemas come from clipform_list_compositions. Output formats: mp4 (H.264, best for social media) or png (single frame). Returns a public URL when complete. For multi-render builds (e.g. one clip per quiz question), pass everything in ONE call via items (max 10): all renders fire in parallel and you get one job ID each - then collect the URLs in a single clipform_check_render call with job_ids. Single render: pass compositionId/inputProps at the top level (wait: true blocks and returns the URL; wait: false returns a job ID). Choosing a render tool: for a recognisable form/quiz beat (guess-the-city, this-or-that, mystery reveal, multiple choice, photo montage...) reach for a video template first (clipform_list_video_templates + clipform_render_video_template) - it is a one-call recipe. Use clipform_generate_video for a narrated or audio-synced media montage (images/clips timed to a voice track). Use clipform_render_composition only when neither fits and you need a custom layer stack. A render for a form node is not done until it is attached to that node. Pass node_id (and form_id) so the completed render attaches itself automatically - do not poll clipform_check_render to completion or manually chain clipform_upload_media_asset + clipform_attach_node_media; fire the render and move on. In batch mode, set node_id per item (see items) and form_id once at the top level.

Destructive Open world

Input schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['context'], 'properties': {'wait': {'type': 'boolean', 'default': True, 'description': 'Single render only: true (default) blocks until the render is ready and returns its URL; false returns a job ID for clipform_check_render. Batch items always run fire-and-poll.'}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['compositionId'], 'properties': {'node_id': {'type': 'string', 'description': "Form node to attach this item's render to automatically once it completes. Requires the batch's top-level form_id."}, 'captions': {'type': 'array', 'items': {'type': 'object', 'required': ['start', 'end', 'text', 'words'], 'properties': {'end': {'type': 'number', 'description': 'Segment end time in seconds'}, 'text': {'type': 'string', 'description': 'Full segment text'}, 'start': {'type': 'number', 'description': 'Segment start time in seconds'}, 'words': {'type': 'array', 'items': {'type': 'object', 'required': ['word', 'start', 'end'], 'properties': {'end': {'type': 'number'}, 'word': {'type': 'string'}, 'start': {'type': 'number'}}, 'additionalProperties': False}, 'minItems': 1, 'description': 'Per-word timestamps within the segment. Required - copy the full array from clipform_generate_tts verbatim.'}}, 'additionalProperties': False}, 'description': 'Word-level captions from clipform_generate_tts - carried onto the attached media asset. Only used when node_id is set.'}, 'inputProps': {'type': 'object', 'description': "Props matching the composition's schema - validated strictly", 'additionalProperties': {}}, 'caption_ref': {'type': 'string', 'description': "caption_ref from clipform_generate_tts - an opaque handle that attaches that TTS run's word-level captions to the media asset, resolved server-side. Preferred over captions. Only used when node_id is set."}, 'outputFormat': {'enum': ['mp4', 'png'], 'type': 'string', 'default': 'mp4', 'description': 'Output format (default: mp4)'}, 'compositionId': {'type': 'string', 'description': 'The composition ID (see clipform_list_compositions)'}}, 'additionalProperties': False}, 'maxItems': 10, 'minItems': 1, 'description': 'Batch mode: multiple renders in one call. All fire in parallel; returns one job ID per item - collect with clipform_check_render (job_ids). Use this whenever rendering more than one clip.'}, 'context': {'type': 'string', 'description': "Describe the user's underlying goal in one sentence - not the tool you're calling."}, 'form_id': {'type': 'string', 'format': 'uuid', 'description': 'The form UUID - required when node_id is set (single render) or any item sets node_id (batch).'}, 'node_id': {'type': 'string', 'description': 'Single render only: form node to attach this render to automatically once it completes. Requires form_id. For batch mode, set node_id per item instead.'}, 'captions': {'type': 'array', 'items': {'$ref': '#/properties/items/items/properties/captions/items'}, 'description': 'Single render only: word-level captions from clipform_generate_tts, carried onto the attached media asset. Only used when node_id is set. For batch mode, set captions per item instead.'}, 'inputProps': {'type': 'object', 'description': "Single render: props object matching the composition's schema from clipform_list_compositions. Validated STRICTLY - unknown or missing props fail with the schema in the error, nothing renders silently with defaults. For map compositions (Map), wide shots (camera.zoom < 9) may round lat/lng to 1 decimal place to improve cache hit rates; close shots and pin drops should keep full precision — the pin lands exactly on `target`.", 'additionalProperties': {}}, 'caption_ref': {'type': 'string', 'description': "Single render only: caption_ref from clipform_generate_tts - an opaque handle that attaches that TTS run's word-level captions to the media asset, resolved server-side. Preferred over captions. Only used when node_id is set. For batch mode, set caption_ref per item instead."}, 'outputFormat': {'enum': ['mp4', 'png'], 'type': 'string', 'default': 'mp4', 'description': 'Single render: output format (default: mp4)'}, 'compositionId': {'type': 'string', 'description': "Single render: the composition ID. Call clipform_list_compositions to see available options (e.g. 'Slideshow', 'Map', 'Grid'). Use items instead for multiple renders."}}}

Output schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['jobs'], 'properties': {'jobs': {'type': 'array', 'items': {'type': 'object', 'required': ['status'], 'properties': {'job_id': {'type': 'string', 'description': "Present when status is 'rendering' - pass to check_render"}, 'status': {'enum': ['rendering', 'complete'], 'type': 'string'}, 'attached': {'type': 'boolean', 'description': 'True when node_id was provided and the render was attached to the node automatically (present once the attach outcome is known).'}, 'public_url': {'type': 'string', 'description': "Present when status is 'complete' - attach via upload_media_asset then attach_node_media (fit_media: true), unless node_id was set (auto-attached)"}, 'republished': {'type': 'boolean', 'description': 'True when the form was live and was republished to include this media.'}, 'attach_error': {'type': 'string', 'description': 'Present when node_id was provided but auto-attach failed - the render itself still succeeded.'}, 'output_format': {'type': 'string'}, 'composition_id': {'type': 'string'}, 'media_asset_id': {'type': 'string', 'description': 'The workspace media asset created from this render, when attached.'}}, 'additionalProperties': False}, 'description': 'One entry per render (single or batch)'}}, 'additionalProperties': False}

clipform_render_video_template

Render Video Template

Render a curated video template (a pre-arranged Scene: bed + overlay + sane defaults) to MP4 or PNG from a small controls object, instead of hand-assembling Scene layers. Call clipform_list_video_templates first for available template names and their controls. Renders through the Scene composition under the hood. Choosing a render tool: for a recognisable form/quiz beat (guess-the-city, this-or-that, mystery reveal, multiple choice, photo montage...) reach for a video template first (clipform_list_video_templates + clipform_render_video_template) - it is a one-call recipe. Use clipform_generate_video for a narrated or audio-synced media montage (images/clips timed to a voice track). Use clipform_render_composition only when neither fits and you need a custom layer stack. A render for a form node is not done until it is attached to that node. Pass node_id (and form_id) so the completed render attaches itself automatically - do not poll clipform_check_render to completion or manually chain clipform_upload_media_asset + clipform_attach_node_media; fire the render and move on.

Destructive Open world

Input schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['template', 'controls', 'context'], 'properties': {'wait': {'type': 'boolean', 'default': True, 'description': 'true (default) blocks until the render is ready and returns its URL; false returns a job ID for clipform_check_render.'}, 'context': {'type': 'string', 'description': "Describe the user's underlying goal in one sentence - not the tool you're calling."}, 'form_id': {'type': 'string', 'format': 'uuid', 'description': 'The form UUID (required when node_id is set).'}, 'node_id': {'type': 'string', 'description': "Form node to attach this render to automatically once it completes - skips the manual clipform_upload_media_asset + clipform_attach_node_media steps and republishes the form if it's currently live. Requires form_id."}, 'captions': {'type': 'array', 'items': {'type': 'object', 'required': ['start', 'end', 'text', 'words'], 'properties': {'end': {'type': 'number', 'description': 'Segment end time in seconds'}, 'text': {'type': 'string', 'description': 'Full segment text'}, 'start': {'type': 'number', 'description': 'Segment start time in seconds'}, 'words': {'type': 'array', 'items': {'type': 'object', 'required': ['word', 'start', 'end'], 'properties': {'end': {'type': 'number'}, 'word': {'type': 'string'}, 'start': {'type': 'number'}}, 'additionalProperties': False}, 'minItems': 1, 'description': 'Per-word timestamps within the segment. Required - copy the full array from clipform_generate_tts verbatim.'}}, 'additionalProperties': False}, 'description': 'Word-level captions from clipform_generate_tts - carried onto the attached media asset. Only used when node_id is set.'}, 'controls': {'type': 'object', 'description': 'Template-specific controls (see clipform_list_video_templates for the exposed control surface).', 'additionalProperties': {}}, 'template': {'type': 'string', 'description': 'Video template name (see clipform_list_video_templates).'}, 'caption_ref': {'type': 'string', 'description': "caption_ref from clipform_generate_tts - an opaque handle that attaches that TTS run's word-level captions to the media asset, resolved server-side. Preferred over captions. Only used when node_id is set."}, 'outputFormat': {'enum': ['mp4', 'png'], 'type': 'string', 'default': 'mp4', 'description': 'Output format (default: mp4)'}}}

Output schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status'], 'properties': {'job_id': {'type': 'string', 'description': "Present when status is 'rendering' - pass to clipform_check_render"}, 'status': {'enum': ['rendering', 'complete'], 'type': 'string'}, 'attached': {'type': 'boolean', 'description': 'True when node_id was provided and the render was attached to the node automatically (present once the attach outcome is known).'}, 'template': {'type': 'string'}, 'public_url': {'type': 'string', 'description': "Present when status is 'complete' - attach via upload_media_asset then attach_node_media (fit_media: true), unless node_id was set (auto-attached)"}, 'republished': {'type': 'boolean', 'description': 'True when the form was live and was republished to include this media.'}, 'attach_error': {'type': 'string', 'description': 'Present when node_id was provided but auto-attach failed - the render itself still succeeded.'}, 'output_format': {'type': 'string'}, 'media_asset_id': {'type': 'string', 'description': 'The workspace media asset created from this render, when attached.'}}, 'additionalProperties': False}

clipform_search_media

Search Media

Search images or stock video clips. Pass one query or many (max 10) - multiple queries run in one call instead of separate tool calls. Use results to feed into clipform_generate_video for narrated slideshow videos, or upload directly as still images via clipform_upload_media_asset then clipform_attach_node_media. All results are pre-cleared for commercial use. Results include a description (alt text where the provider has it) - use it to pick visually distinct images. Example: { queries: [{ query: "saturn rings" }, { query: "mars surface", count: 3 }] } returns portrait images for both.

Read only Open world Idempotent

Input schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['queries', 'context'], 'properties': {'context': {'type': 'string', 'description': "Describe the user's underlying goal in one sentence - not the tool you're calling."}, 'queries': {'type': 'array', 'items': {'type': 'object', 'required': ['query'], 'properties': {'kind': {'enum': ['image', 'video'], 'type': 'string', 'default': 'image', 'description': 'image = stock photos (default), video = stock clips'}, 'count': {'type': 'number', 'default': 6, 'maximum': 20, 'minimum': 1, 'description': 'Max results per provider (default 6 for image, 3 for video)'}, 'query': {'type': 'string', 'description': "What to search for (e.g. 'african lion', 'saturn rings')"}, 'orientation': {'enum': ['portrait', 'landscape', 'any'], 'type': 'string', 'default': 'portrait', 'description': 'portrait (default) fills the 9:16 frame; landscape gets auto blur-pad framing in Ken Burns videos'}}, 'additionalProperties': False}, 'maxItems': 10, 'minItems': 1, 'description': 'One or more search queries to run'}}}

Output schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['searches'], 'properties': {'searches': {'type': 'array', 'items': {'type': 'object', 'required': ['query', 'kind', 'items'], 'properties': {'kind': {'enum': ['image', 'video'], 'type': 'string'}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string'}, 'title': {'type': 'string'}, 'width': {'type': 'number'}, 'height': {'type': 'number'}, 'source': {'type': 'string'}, 'duration': {'type': 'number'}, 'attribution': {'type': 'string'}}, 'additionalProperties': False}}, 'query': {'type': 'string'}}, 'additionalProperties': False}, 'description': 'Results grouped by query (items empty if a query found nothing or failed)'}}, 'additionalProperties': False}

clipform_search_music

Search Music

Search for royalty-free music tracks and ambient sounds. Quiz forms especially benefit from background music - it keeps energy up between questions. Also consider it for multi-step surveys and longer forms. Pass the returned URL as the audio track to clipform_generate_video, or as the audio for the slideshow video template via clipform_render_video_template. Returns download URLs, duration, artist, and license info.

Read only Open world Idempotent

Input schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query', 'context'], 'properties': {'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': "Genre/mood tags to filter by. Multiple tags are ANDed together (e.g. ['ambient', 'chill'] matches tracks tagged both)."}, 'count': {'type': 'integer', 'default': 5, 'maximum': 10, 'minimum': 1, 'description': 'Max results (default: 5)'}, 'query': {'type': 'string', 'minLength': 1, 'description': "What to search for (e.g. 'upbeat quiz background', 'calm ambient', 'playful pizzicato')"}, 'context': {'type': 'string', 'description': "Describe the user's underlying goal in one sentence - not the tool you're calling."}, 'maxDuration': {'type': 'number', 'description': 'Maximum duration in seconds', 'exclusiveMinimum': 0}, 'minDuration': {'type': 'number', 'description': 'Minimum duration in seconds', 'exclusiveMinimum': 0}, 'instrumentalOnly': {'type': 'boolean', 'default': True, 'description': 'Only instrumental tracks (default: true)'}}}

Output schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query', 'tracks'], 'properties': {'query': {'type': 'string'}, 'tracks': {'type': 'array', 'items': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string'}, 'title': {'type': 'string'}, 'artist': {'type': 'string'}, 'source': {'type': 'string'}, 'license': {'type': 'string'}, 'duration': {'type': 'number'}}, 'additionalProperties': False}, 'description': 'Matching tracks (empty if none); pass a url as the audio track to generate_video'}}, 'additionalProperties': False}

clipform_search_news

Search News (fallback)

Fallback news lookup for clients without native web search. Returns structured current-news articles from NewsAPI and The Guardian. Coverage: recent events, people, and topics (post-May-2025). Does NOT cover timeless topics (history, geography, science). Narrower and less current than native web search tools (WebSearch, web fetch) when available. Returns: article title, source, author, date, URL, description, and image URL per result.

Read only Open world Idempotent

Input schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query', 'context'], 'properties': {'count': {'type': 'number', 'default': 5, 'maximum': 15, 'minimum': 1, 'description': 'Max results per provider (default 5)'}, 'query': {'type': 'string', 'description': "News search query (e.g. 'Iran war 2026', 'Australian Open final', 'UK election')"}, 'context': {'type': 'string', 'description': "Describe the user's underlying goal in one sentence - not the tool you're calling."}}}

Output schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query', 'articles'], 'properties': {'query': {'type': 'string'}, 'articles': {'type': 'array', 'items': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string'}, 'title': {'type': 'string'}, 'author': {'type': 'string'}, 'source': {'type': 'string'}, 'image_url': {'type': 'string'}, 'description': {'type': 'string'}, 'published_at': {'type': 'string'}}, 'additionalProperties': False}, 'description': 'Matching articles (empty if none)'}}, 'additionalProperties': False}

clipform_set_logic

Set Node Logic

Set the next node for one or more nodes, wiring a linear route (A to B to C). Pass multiple nodes in one call instead of separate tool calls. Each node routes to exactly one target node. Branching by which option a respondent picks is not configured here; it is set up in the form's Build tab in the dashboard (the builder URL returned by clipform_get_form / clipform_create_form). A call replaces that node's routing entirely - it does not merge with any prior target. Example: nodes: [ { node_id: "q1-id", rules: [{ target_node_id: "q2-id" }] }, { node_id: "q2-id", rules: [{ target_node_id: "q3-id" }] } ]

Destructive Idempotent

Input schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['form_id', 'nodes', 'context'], 'properties': {'nodes': {'type': 'array', 'items': {'type': 'object', 'required': ['node_id', 'rules'], 'properties': {'rules': {'type': 'array', 'items': {'type': 'object', 'required': ['target_node_id'], 'properties': {'target_node_id': {'type': 'string', 'description': 'The node ID this node routes to'}}, 'additionalProperties': False}, 'maxItems': 1, 'minItems': 1, 'description': 'Exactly one rule: the single node this node routes to'}, 'node_id': {'type': 'string', 'description': 'The node ID to set routing on'}}, 'additionalProperties': False}, 'maxItems': 20, 'minItems': 1, 'description': 'One or more nodes to set logic on'}, 'context': {'type': 'string', 'description': "Describe the user's underlying goal in one sentence - not the tool you're calling."}, 'form_id': {'type': 'string', 'format': 'uuid', 'description': 'The form UUID (returned by clipform_create_form, not the short share_id from the URL)'}}}

Output schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['results'], 'properties': {'results': {'type': 'array', 'items': {'type': 'object', 'required': ['node_id', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'error': {'type': 'string'}, 'node_id': {'type': 'string'}, 'rules_count': {'type': 'number'}}, 'additionalProperties': False}, 'description': 'One result per node, in order'}}, 'additionalProperties': False}

clipform_update_form

Update Clipform

Update a form's title, publish status, settings, or tags. Only sends fields that are provided - omitted fields remain unchanged. AI-PROTECTED parameters have restrictions noted in their descriptions.

Destructive Open world Idempotent

Input schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['form_id', 'context'], 'properties': {'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': "Replace all tags on this form. Pass the full desired set (e.g. ['quiz', 'trivia', 'slug:elephants']). Omit to leave tags unchanged."}, 'title': {'type': 'string', 'description': 'New form title'}, 'author': {'type': ['string', 'null'], 'description': 'AI-PROTECTED: Only set when the user explicitly provides an author name. Set null to clear.'}, 'context': {'type': 'string', 'description': "Describe the user's underlying goal in one sentence - not the tool you're calling."}, 'form_id': {'type': 'string', 'format': 'uuid', 'description': 'The form UUID (returned by clipform_create_form, not the short share_id from the URL)'}, 'is_live': {'type': 'boolean', 'description': 'Setting true publishes/republishes the snapshot respondents see. Forms are live from creation, but edits and media attached AFTER creation are not visible until you re-send true - republishing is the expected final step of a build, never skip it after attaching media. Setting false takes the form offline (keeps the last published snapshot) - AI-PROTECTED: only take a form offline when the user explicitly asks.'}, 'logo_url': {'type': ['string', 'null'], 'description': 'AI-PROTECTED: Only set when the user explicitly provides a logo URL. Set null to clear.'}, 'brand_name': {'type': ['string', 'null'], 'description': 'AI-PROTECTED: Custom brand name shown in footer. Only set when user explicitly provides.'}, 'description': {'type': ['string', 'null'], 'description': 'SEO description (meta description, og:description). Set null to clear.'}, 'font_family': {'type': 'string', 'description': 'AI-PROTECTED: Only set when the user explicitly requests a specific font.'}, 'total_steps': {'type': ['number', 'null'], 'description': 'Override the total step count shown in the step counter. Set null to auto-calculate.'}, 'primary_color': {'type': 'string', 'pattern': '^#[0-9A-Fa-f]{6}$', 'description': "Primary/brand color as 6-digit hex (e.g. '#FF5500'). Used for buttons and accents."}, 'show_branding': {'type': 'boolean', 'description': 'Show Clipform branding. Set false to remove (Pro plan).'}, 'background_color': {'type': 'string', 'pattern': '^#[0-9A-Fa-f]{6}$', 'description': "Background color as 6-digit hex (e.g. '#1A1A2E')."}, 'show_step_counter': {'type': 'boolean', 'description': "Show step counter (e.g. '1/5'). Recommended for quizzes."}, 'disable_back_navigation': {'type': 'boolean', 'description': 'Prevent respondents from going back. Recommended for quizzes.'}}}

Output schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['form_id', 'updated_fields'], 'properties': {'form_id': {'type': 'string', 'description': 'Form UUID'}, 'updated_fields': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Names of the fields that were changed by this call'}}, 'additionalProperties': False}

clipform_update_node

Update Node

Update one or more existing nodes' text, type, config, or options. Pass multiple updates in one call instead of separate tool calls. Requires node IDs (returned by clipform_create_form, clipform_add_node, or clipform_get_form). Does not change node positions in the flow. All type definitions and config schemas are derived from @vid-master/config (node-types).

Destructive Idempotent

Input schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['form_id', 'updates', 'context'], 'properties': {'context': {'type': 'string', 'description': "Describe the user's underlying goal in one sentence - not the tool you're calling."}, 'form_id': {'type': 'string', 'format': 'uuid', 'description': 'The form UUID (returned by clipform_create_form, not the short share_id from the URL)'}, 'updates': {'type': 'array', 'items': {'type': 'object', 'required': ['node_id'], 'properties': {'type': {'enum': ['choice', 'open', 'details', 'payment', 'button', 'redirect', 'file_download', 'end_screen'], 'type': 'string', 'description': 'Change the node type'}, 'label': {'type': 'string', 'description': 'Short label for the node (used in logic builder)'}, 'config': {'type': 'object', 'description': 'Type-specific configuration keyed by node type. Omit to use defaults. Per-type keys, shapes, and defaults are listed in the clipform_create_form description; craft guidance via clipform_get_guide. Merged shallowly into the stored config - only the keys you pass are changed. Set a key to null to delete it; nested objects are replaced wholesale. When type is changed in the same call, config replaces the stored configuration instead of merging.', 'additionalProperties': {}}, 'prompt': {'type': 'string', 'description': 'New node prompt text'}, 'node_id': {'type': 'string', 'description': 'The node ID to update'}, 'options': {'type': 'array', 'items': {'type': 'object', 'required': ['content'], 'properties': {'score': {'type': 'number', 'description': 'Score value for this option (for scored quizzes). Use 1 for correct, 0 for wrong. Scored options automatically enable correct-answer marking (record_scores) and correct/incorrect answer feedback on the node; set config.choice.show_answer_feedback: false to hide the feedback.'}, 'content': {'type': 'string', 'description': 'Option text'}, 'is_correct': {'type': 'boolean', 'description': 'Mark this as the correct answer for a quiz (maps to score 1; other options score 0). Use this OR score, not both.'}}, 'additionalProperties': False}, 'description': 'Replace all options (for choice nodes). Omit to keep existing options.'}, 'required': {'type': 'boolean', 'description': 'Whether an answer is required'}}, 'additionalProperties': False}, 'maxItems': 20, 'minItems': 1, 'description': 'One or more node updates to apply'}}}

Output schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['results'], 'properties': {'results': {'type': 'array', 'items': {'type': 'object', 'required': ['node_id', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'error': {'type': 'string'}, 'node_id': {'type': 'string'}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'description': 'One result per requested update, in order'}}, 'additionalProperties': False}

clipform_upload_media_asset

Upload Media Asset

Put one or more media files into your workspace media library (max 10, uploaded sequentially). This is step one of attaching media to a node - follow up with clipform_attach_node_media to place the returned media_asset_id on a node. When a public URL is provided, the media is fetched and stored automatically. For video: ingested via Mux. For image: stored in Supabase. Word-level captions from clipform_generate_tts enable per-word highlighting in the viewer once attached - pass the caption_ref it returned instead of hand-copying the captions array. Provide media via `items` (explicit type + URL), `files` (files attached by the host client), or both. At least one is required.

Input schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['context'], 'properties': {'files': {'type': 'array', 'items': {'anyOf': [{'type': 'string'}, {'type': 'object', 'required': ['download_url'], 'properties': {'name': {'type': 'string'}, 'size': {'type': 'number'}, 'file_id': {'type': 'string', 'description': 'Host-assigned identifier for the attached file'}, 'file_name': {'type': 'string'}, 'mime_type': {'type': 'string', 'description': 'Declared MIME type - determines whether the file becomes a video or still asset'}, 'download_url': {'type': 'string', 'description': "Short-lived URL the server downloads the file's bytes from"}}, 'additionalProperties': True}]}, 'maxItems': 10, 'minItems': 1, 'description': 'Files attached by the host client. Each becomes a video or still library asset based on its declared mime_type.'}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['media_type'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Public URL that links directly to the media file itself. When provided, the server fetches and stores it directly.'}, 'captions': {'type': 'array', 'items': {'type': 'object', 'required': ['start', 'end', 'text', 'words'], 'properties': {'end': {'type': 'number', 'description': 'Segment end time in seconds'}, 'text': {'type': 'string', 'description': 'Full segment text'}, 'start': {'type': 'number', 'description': 'Segment start time in seconds'}, 'words': {'type': 'array', 'items': {'type': 'object', 'required': ['word', 'start', 'end'], 'properties': {'end': {'type': 'number'}, 'word': {'type': 'string'}, 'start': {'type': 'number'}}, 'additionalProperties': False}, 'minItems': 1, 'description': 'Per-word timestamps within the segment. Required - copy the full array from clipform_generate_tts verbatim.'}}, 'additionalProperties': False}, 'description': 'Word-level captions from clipform_generate_tts. `words` is a required field on each caption (schema-enforced) - pass the full objects returned by clipform_generate_tts unmodified.'}, 'media_type': {'enum': ['video', 'still'], 'type': 'string', 'description': 'Type of media'}, 'caption_ref': {'type': 'string', 'description': "caption_ref from clipform_generate_tts - an opaque handle that attaches that TTS run's word-level captions to this asset, resolved server-side. Preferred over captions."}, 'ai_generated': {'type': 'boolean', 'description': "Whether this media was AI-generated. Drives the viewer's disclosure chip - set true for AI-rendered/synthesized media."}, 'media_source': {'enum': ['uploaded', 'recorded'], 'type': 'string', 'default': 'uploaded', 'description': 'How the media was created'}}, 'additionalProperties': False}, 'maxItems': 10, 'minItems': 1, 'description': 'One or more media items to create as workspace library assets'}, 'context': {'type': 'string', 'description': "Describe the user's underlying goal in one sentence - not the tool you're calling."}}}

Output schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['results'], 'properties': {'results': {'type': 'array', 'items': {'type': 'object', 'required': ['media_type', 'stored', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'error': {'type': 'string'}, 'stored': {'type': 'boolean', 'description': 'Bytes already stored (URL-based); false when an upload_url is pending'}, 'media_type': {'type': 'string'}, 'upload_url': {'type': 'string'}, 'upload_method': {'type': 'string'}, 'media_asset_id': {'type': 'string'}}, 'additionalProperties': False}, 'description': 'One result per item, in order'}}, 'additionalProperties': False}

clipform_whoami

Who Am I

Show the current identity: auth mode (api key, oauth, session, or anonymous), active workspace, and plan limits.

Read only Idempotent

Input schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['context'], 'properties': {'context': {'type': 'string', 'description': "Describe the user's underlying goal in one sentence - not the tool you're calling."}}}

Output schema

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['auth_mode', 'is_authenticated', 'workspace', 'plan'], 'properties': {'plan': {'type': 'object', 'required': ['name', 'tier', 'node_limit', 'form_limit'], 'properties': {'name': {'type': 'string'}, 'tier': {'type': 'number'}, 'form_limit': {'type': ['number', 'null'], 'description': 'Max forms in the workspace, or null if unlimited'}, 'node_limit': {'type': ['number', 'null'], 'description': 'Max nodes per form, or null if unlimited'}}, 'description': 'Plan limits for the active workspace', 'additionalProperties': False}, 'links': {'type': 'object', 'required': ['dashboard', 'forms'], 'properties': {'forms': {'type': 'string', 'description': 'Forms list for the active workspace.'}, 'dashboard': {'type': 'string', 'description': 'Dashboard home for the active workspace.'}}, 'description': 'Workspace-level dashboard links - only present for a non-anonymous caller.', 'additionalProperties': False}, 'auth_mode': {'enum': ['api_key', 'oauth', 'session', 'anonymous'], 'type': 'string', 'description': 'How this session is authenticated'}, 'workspace': {'anyOf': [{'type': 'object', 'required': ['id', 'name'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'null'}], 'description': 'Active workspace, or null when anonymous'}, 'workspaces': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}}, 'additionalProperties': False}, 'description': "All workspaces in the caller's company - only present for session (dashboard) auth"}, 'is_authenticated': {'type': 'boolean', 'description': 'True for api_key, oauth, or session auth; false for anonymous'}}, 'additionalProperties': False}

get_more_tools

Check for additional tools whenever your task might benefit from specialized capabilities - even if existing tools could work as a fallback.

Read only Open world Idempotent

Input schema

{'type': 'object', 'required': ['context'], 'properties': {'context': {'type': 'string', 'description': 'A description of your goal and what kind of tool would help accomplish it.'}}}

Changed

                            clipform_search_music
                        

Oct. 1, 2026, 2:44 a.m.

Changed

                            clipform_generate_video
                        

Oct. 1, 2026, 2:44 a.m.

Changed

                            clipform_upload_media_asset
                        

Oct. 1, 2026, 2:44 a.m.

Added

                            get_more_tools
                        

Sept. 17, 2026, 12:40 p.m.

Added

                            clipform_get_workflow
                        

Sept. 17, 2026, 12:40 p.m.

Added

                            clipform_get_guide
                        

Sept. 17, 2026, 12:40 p.m.

Added

                            clipform_fetch_boundary
                        

Sept. 17, 2026, 12:40 p.m.

Added

                            clipform_check_render
                        

Sept. 17, 2026, 12:40 p.m.

Added

                            clipform_list_assets
                        

Sept. 17, 2026, 12:40 p.m.

Added

                            clipform_render_video_template
                        

Sept. 17, 2026, 12:40 p.m.

Added

                            clipform_list_video_templates
                        

Sept. 17, 2026, 12:40 p.m.

Added

                            clipform_list_compositions
                        

Sept. 17, 2026, 12:40 p.m.

Added

                            clipform_search_music
                        

Sept. 17, 2026, 12:40 p.m.

Added

                            clipform_render_composition
                        

Sept. 17, 2026, 12:40 p.m.

Added

                            clipform_search_media
                        

Sept. 17, 2026, 12:40 p.m.

Added

                            clipform_generate_video
                        

Sept. 17, 2026, 12:40 p.m.

Added

                            clipform_generate_tts
                        

Sept. 17, 2026, 12:40 p.m.

Added

                            clipform_search_news
                        

Sept. 17, 2026, 12:40 p.m.

Added

                            clipform_log_generation
                        

Sept. 17, 2026, 12:40 p.m.

Added

                            clipform_set_logic
                        

Sept. 17, 2026, 12:40 p.m.

Added

                            clipform_delete_node_media
                        

Sept. 17, 2026, 12:40 p.m.

Added

                            clipform_get_node_media
                        

Sept. 17, 2026, 12:40 p.m.

Added

                            clipform_attach_node_media
                        

Sept. 17, 2026, 12:40 p.m.

Added

                            clipform_complete_media_upload
                        

Sept. 17, 2026, 12:40 p.m.

Added

                            clipform_upload_media_asset
                        

Sept. 17, 2026, 12:40 p.m.

Added

                            clipform_delete_node
                        

Sept. 17, 2026, 12:40 p.m.

Added

                            clipform_update_node
                        

Sept. 17, 2026, 12:40 p.m.

Added

                            clipform_add_node
                        

Sept. 17, 2026, 12:40 p.m.

Added

                            clipform_get_responses
                        

Sept. 17, 2026, 12:40 p.m.

Added

                            clipform_get_results
                        

Sept. 17, 2026, 12:40 p.m.

Server details

Version

3.0.0

Transport

Streamable HTTP

Tools

Latency

1044 ms

Last scan

Oct. 1, 2026, 2:44 a.m.

First seen

Sept. 13, 2026, 2:14 a.m.

Endpoint

https://mcp.clipform.io

Recent scans

Success

Oct. 1, 2026, 2:44 a.m.

Success

Sept. 29, 2026, 2:51 a.m.

Success

Sept. 27, 2026, 2:44 a.m.

Success

Sept. 25, 2026, 2:51 a.m.

Success

Sept. 23, 2026, 2:42 a.m.

Success

Sept. 21, 2026, 2:50 a.m.

Success

Sept. 19, 2026, 2:41 a.m.

Success

Sept. 17, 2026, 12:40 p.m.

Clipform

What this MCP does

Tools

Recent tool changes

Similar MCP servers

Hermoso

Heista

Spook SEO

VarynForge

AfterLaunch: the agentic growth marketing engine

RoboWrite

ai-content-drop

Newswire Com