The tools — Agent control (MCP) — VidVertex Docs

The tools

105 calls, mirroring the app surface. Grouped as the assistant uses them.

Reading state

Call What it does
list_stacks / get_stack All stacks with post type, channel count and render status; one stack in full.
get_editor The complete stack-editor state: every field, every widget's geometry per context, where each asset sits on the canvas, background, pools, captions config, the hook/endcard timing windows.
list_brands / list_pools Brands with platforms, language, posting time; the pool library with who uses what.
find_clips / list_files Inbox videos/images (used/unused), and the file picker's view of any folder.
get_transcript / get_clip_brief The caption transcript as timestamped text plus cached translations; the clip analysis brief.

Runs, queues and storage

Call What it does
get_calendar / upload_preflight What's scheduled (live from the posting service in use); the warnings a run would show.
render_status Progress of the running batch, kept/rendered/failed per stack, the frame context of finished variants.
upload_status The running or finished upload run: posts so far, skipped duplicates, failed tasks, pre-flight warnings — the full result once it ends, and an honest verdict after a restart.
get_review_queue / list_schedules Pending post approvals; the assembly schedules.
get_housekeeping / get_drive_uploads Disk usage per cache and per stack; the app's own Google Drive files with quota and in-use/free verdict.
list_backups / list_stack_snapshots Config backups and a stack's snapshots.

Catalogs and app state

Call What it does
list_presets / list_caption_styles / list_video_templates / list_motion_templates Presets and looks — motion templates with their settle time.
get_settings / get_app_status / get_license_status / check_for_update Settings (keys only as configured/not), engine status, license (key masked), update check.
list_zernio_profiles / list_metricool_brands / list_voiceover_voices / list_ai_providers / list_languages / list_caption_fonts / get_prompt_templates The catalogs behind the settings pages.

Building a post

Call What it does
create_stack New stack — video, text, carousel or story — ideally from a stack preset.
assign_media Set the footage: a file path or the newest unused inbox clip, auto-fitted into the layout; carousel or text-post images.
set_post_texts / import_csv / remove_texts Write titles, descriptions, first comments, hashtags — per brand and platform; or import/remove a CSV.
generate_hooks / generate_texts AI hook angles and endcard lines per brand language; titles/descriptions, first comments, text-widget lines.
transcribe / translate_captions / edit_transcript / reset_transcript Local Whisper transcript; translations; corrections that keep timings; a fresh start.
analyze_clip Content brief from the actual footage for better texts.

Rendering and publishing

Call What it does
render_batch / cancel_render / resume_render / clear_render_queue Render stacks into all variants (returns immediately, poll render_status); stop, resume, clear.
render_preview / view_frame / view_motion_template One fast single-variant render; real frames from a render, the raw footage or any asset; a title template's look.
schedule / run_assembly Run the upload plan or an assembly preset. Dry-run by default; a real post needs your approval. schedule returns a run id and keeps posting in the background — poll upload_status.
rebuild_csv One combined import CSV from the upload history: recorded media links are reused, nothing is uploaded or posted again.
decide_review Approve or reject a queued post (approve is confirmation-gated).

Editing stacks

Call What it does
update_stack Any editor field: hook/endcard setup, captions look, layout zones, templates, z-order, silence cut, cover frame. Rejects values the render would ignore.
set_widget_geometry Position and scale any widget — directly, or "fit it into this rectangle".
set_stack_brands / toggle_brand_channel Which brands a stack posts as; one platform on/off per brand (post-type rules enforced).
snapshot_stack / restore_stack_snapshot Freeze and restore a stack's configuration.
apply_preset / save_stack_preset / set_preset_included Presets onto stacks and back.

Brands and the asset library

Call What it does
create_brand / duplicate_brand / rename_brand / delete_brand / move_brand_to_folder Brand lifecycle (delete needs confirmation).
set_brand Posting time, timezone, content language, voice, logo, brand identity, platform accounts.
save_pool / duplicate_pool / delete_pool The pool library — explicit files and live folders.
assign_pools / set_brand_pools Point a brand's slots at pools, with platform tags (only / except); loose files become the brand's own pool.
distribute_assets / estimate_funnel The asset funnel — shared or exclusive per brand, optionally splitting videos — with a preview of the result.
set_brand_caption_style Pin a caption look for the brand.
apply_zernio_profile / import_zernio_profiles Wire a brand to its Zernio accounts; one brand per profile, in bulk.

Organizing, automation and housekeeping

Call What it does
rename_stack / duplicate_stack / delete_stack / move_stack_to_folder / set_stack_labels Stack lifecycle and hub tidiness.
get_folders / set_folders The hub's folder structure.
save_assembly_preset / save_schedule / delete_schedule Assembly presets and their daily schedules.
save_caption_style / save_video_template / rename_item / delete_item Custom looks and formats (built-ins protected).
set_settings / test_connection Settings (never keys, providers or guardrails); a live test of the stored keys.
clean_cache / delete_renders / delete_drive_uploads Housekeeping, including the app's Drive uploads (confirmation-gated; files a scheduled post still uses are refused).
restore_backup / fix_render_status / reset_stack_labels / open_in_explorer Restore a config backup, repair render bookkeeping, reset labels, show a file in Explorer.