Instavar Video Templates and Studio
You can use this MCP server to plan and prepare Instavar video templates locally for free, and optionally unlock hosted Studio production workflows with an API key.
Discover capabilities, creative guidance, published templates, VideoSpec schemas/examples, and carousel structures.
Propose video storyboards, scaffold VideoSpecs, build carousel decks, and prepare paired announcement cards.
Realise VideoSpecs as local Remotion or HyperFrames source, get render instructions, and diagnose local render errors.
With an API key, inspect jobs, status, video state, render diagnostics, engagement metrics, and infrastructure costs.
Create or edit video briefs, retry or audit QA, and regenerate narration.
Inspect, draft, patch, validate, preview, compare, and approve Studio workflows.
Approve and publish rendered jobs, and connect or poll social-account connections.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Instavar Video Templates and Studio create a video brief for my new product launch"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@instavar/mcp-server
One MCP package starts free and grows with the work. Make local videos with Instavar's independent, open-source templates for Remotion from Claude Code or Codex without an account or API key.
Instavar is an independent project and is not affiliated with, sponsored by, or endorsed by Remotion AG. Remotion is a trademark of Remotion AG.
Add an Instavar API key when you want the hosted workflow: create → render → approve → publish → metrics. The authenticated tools are thin HTTP clients to the hosted Instavar API. The package holds no database connection and stores no data of its own. You keep the free tools and do not install a second server.
Start with the right capability
Use Instavar when an agent needs reusable video templates for Remotion or
HyperFrames, creative guidance, a VideoSpec example, an editorial carousel, or
help with a local render error. Call get_capabilities first, then
get_creative_guide before drafting copy or design. For an ordinary video
request, propose_video_storyboard suggests three visual beats and a template.
Use list_templates and get_template to choose a supported structure, and
get_example or scaffold_video_spec to prepare its specification.
prepare_video_template turns that specification into local Remotion or
HyperFrames source. get_render_instructions supplies the separate local
validation, preview and render workflow. Planning and scaffolding do not
render, upload or publish media.
Prefer a hosted HTTP connection for browser-based agents? Use
https://instavar.com/api/mcp/templates, also listed as
Instavar Video Templates on Smithery.
It offers the same account-free template, storyboard and carousel tools, plus a
ChatGPT planner widget. Its optional OAuth tools list and review private
projects only. It is not the full protected Studio endpoint. Public planning does
not require an Instavar account; a directory or gateway may require its own login.
Hosted Studio production is optional and may incur costs. Never treat a request to plan a video as permission to render a paid job or publish a social post.
Related MCP server: remotion-mcp-server
Which model runs?
The MCP host supplies the general-purpose LLM.
In Claude Code, the selected Claude model interprets the request and calls Instavar tools.
In Codex, the selected OpenAI model interprets the request and calls the same tools.
Other compatible hosts use their own selected model and authentication.
The MCP server does not provide Sonnet, GPT, or another general-purpose model. It exposes typed Instavar capabilities to the model already running in the user's host. Depending on the host and sign-in method, that model usage may draw from a personal or workspace subscription, separate usage credits, or API billing. Those provider rules can change.
Local Remotion rendering uses your own machine. Instavar meters or charges its hosted services, including rendering, storage, specialist media generation, QA, publishing, and other declared job costs. Using a subscription-backed agent does not make those services free.
For public setup guidance and examples, see Instavar video templates.
Setup
Add the server to your MCP client config:
{
"mcpServers": {
"instavar": {
"command": "npx",
"args": ["-y", "@instavar/mcp-server"]
}
}
}This starts with the free local template tools. To unlock hosted Studio tools, create an API key at https://instavar.com/studio/settings, then add it:
{
"mcpServers": {
"instavar": {
"command": "npx",
"args": ["-y", "@instavar/mcp-server"],
"env": { "INSTAVAR_API_KEY": "ik_live_..." }
}
}
}Restart the client. The free tools appear in both modes. Hosted tools appear when the key is configured.
Environment
Var | Required | Default | Purpose |
| no | — | Unlocks hosted Studio tools. Scoped to your org; revocable. |
| no |
| Override the API host. |
| no | on | Set to |
Tools
From npm 0.6.0 the package also includes prepare_announcement: one paired
announcement card for Remotion and HyperFrames. It returns local source and a
portable copy document, not a saved hosted project or rendered video. Ask for a
framework when it is unspecified; continue with the latest returned project and
matching expectedRevision. Only title, body and action survive a framework switch.
From npm 0.7.0, prepare_video_template realises one VideoSpec for any of the
five template families in Remotion (the public renderer, pinned) or HyperFrames
(generated source). Both frameworks accept the same fields; a field neither
renderer honours is rejected rather than dropped. 0.7.0 also adds the
storyboard and carousel tools the hosted endpoint already had, from the same
code, and the hosted tools below now reject unknown input keys instead of
dropping them.
Free local tools:
Tool | What it does |
| Reports free and optional account features. |
| Reads concise copy, story, design and review guidance. |
| Proposes three visual beats and a template. |
| Lists published template families. |
| Returns one template contract. |
| Returns the public VideoSpec JSON Schema. |
| Returns a starter VideoSpec. |
| Creates a deterministic VideoSpec skeleton. |
| Realises a VideoSpec in Remotion or HyperFrames. |
| Prepares one paired announcement card. |
| Lists the editorial carousel story structures. |
| Returns the CarouselDeck JSON Schema. |
| Builds a deterministic carousel deck from copy. |
| Returns the local validation and render workflow. |
| Classifies common local render failures. |
Hosted tools, available when INSTAVAR_API_KEY is configured:
Tool | What it does |
| List recent jobs (newest first). |
| Runs, artifacts, verifications, current video + thumbnail URLs. |
| Materialized composition state for a job. |
| Read-only joined render diagnosis with evidence limits and retry recommendations. |
| Platform engagement snapshots for a published job. |
| Infra cost summary (Lambda / RunPod / R2 / WaveSpeed / PoYo). |
| Read the current workflow and its version history. |
| Create a job from a structured brief and start rendering. |
| Patch a brief (incl. objective / publishTarget); re-renders unless only publishTarget changed. |
| Retry degraded or unavailable QA against the same current frozen video artifact. |
| Run an advisory Qwen3.6-Plus second opinion against the same frozen video. |
| Regenerate narration and its dependent video from the unchanged durable brief. |
| Store a complete workflow using the inspected |
| Create a conflict-aware workflow version from a recursive patch. |
| Validate and compile the inspected workflow version without rendering. |
| Read the compiled UniversalVideo brief without rendering. |
| Compare two durable workflow versions field by field. |
| Approve the inspected valid version without approving or publishing the video job. |
| Approve a rendered job so it can be published. |
| Publish an approved job to its connected social destination. |
| Start connecting a social account (headless OAuth pairing). |
| Poll a pending account connection until it is connected. |
Workflow inspection, preview, and comparison require read. Workflow draft,
patch, validation, and approval require write. publish_job requires
publish.
Workflow tools reject unknown arguments instead of silently discarding them.
API calls time out after 15 seconds. A stale-version 409 tells the caller to
inspect the latest version, while an unavailable upload or other dependency
conflict tells the caller to resolve that dependency before retrying.
Connecting a social account from the terminal
connect_account returns an approve URL and a short confirm code. Open
the URL in a browser where you are signed in to Instavar, check the code matches
the one in your terminal, and approve — you go through the platform's normal
sign-in, then return to Instavar. Poll connect_account_status with the returned
pairingId until it reports connected. Pairings expire after 10 minutes and
can only be approved by an owner/admin of the workspace.
CLI
npx @instavar/mcp-server --version
npx @instavar/mcp-server --helpLicense
MIT
Creative guidance
get_creative_guide works without a key. Omit guideId to discover the four
guides, or choose visual-copy, carousel-stories, visual-design or
human-review. The same text is available as Markdown resources at
instavar://creative-guides/<guideId>. The calling assistant applies the guidance
to the user's brief; this tool does not generate copy, render, save feedback or
publish media. Carousel recipes are planning guidance, not additional npm renderers.
The monorepo sources live in docs/guides/creative/. After an edit, run
node scripts/build-creative-guides.mjs; --check rejects a stale bundle.
The generated TypeScript is bundled into the package, so installed clients need
no checkout files or access to private knowledge stores. Source changes require
a normal npm release before installed clients receive them.
Available Tools
29 toolsapprove_jobApprove jobAIdempotentInspect
Approve a rendered job so it becomes publishable (draft_ready/awaiting_review/needs_changes -> approved) and revoke active review links. Required before publish_job will accept the job.
Inputs: jobId (required).
approve_workflowApprove workflowAIdempotentInspect
Validate and approve the inspected workflow version. This does not approve or publish the video job.
Inputs: jobId (required), expectedVersion (required).
audit_video_qaAudit video QAAInspect
Run Qwen3.6-Plus as an advisory second evaluator against the same current frozen video. Use only on an explicit request for another model, second opinion, or evaluator escalation. The result is separate from default QA and has no publish-gate effect.
Inputs: jobId (required), runId (required), videoArtifactId (required).
compare_workflowsCompare workflow versionsBRead-onlyInspect
Compare two durable workflow versions field by field.
Inputs: jobId (required), toVersion (required), fromVersion (required).
connect_accountConnect social accountAInspect
Start connecting a social account headlessly (no local browser needed). Returns an approve URL + a short confirm code: open the URL in a browser signed in to Instavar, check the code matches THIS terminal, and approve. Then poll connect_account_status with the returned pairingId until it reports 'connected'.
Inputs: provider (required).
connect_account_statusCheck account connectionARead-onlyInspect
Poll a pending account connection started by connect_account. Returns status 'pending' | 'connected' | 'expired', plus the connected account label once connected.
Inputs: pairingId (required).
create_video_briefCreate video briefAInspect
Create a new video job from a structured brief and trigger the render pipeline. Returns the job and run IDs immediately; rendering continues asynchronously (typically a few minutes) — poll get_job_status until draft_ready. Requires a key with write scope. To change an existing job, use edit_video_brief instead of creating a duplicate.
Inputs: title (required), script (required), caption (required), objective (required), +11 more.
diagnose_render_errorDiagnose render errorBRead-onlyInspect
Classify a local validation or render error.
Inputs: errorText (required).
draft_workflowDraft workflowAInspect
Create a durable Documentary Journey or Transformation Montage workflow version. Inspect first and pass its current version, or 0 only when no workflow exists.
Inputs: jobId (required), expectedVersion (required), document.
edit_video_briefEdit video briefAInspect
Edit an existing job's brief (only provided fields change). Changing the script, caption, title, lessonTitle, objective, steps, scenes, aspectRatio or voiceId triggers a re-render and returns the new run ID; objective also re-routes the composition. Changing only publishTarget updates the job's target platform without re-rendering. For a brand-new video use create_video_brief.
Inputs: jobId (required), steps, title, scenes, +10 more.
get_capabilitiesGet video capabilitiesARead-onlyInspect
Call first. Reports free local features and optional account features.
Inputs: no named parameters.
get_cost_summaryGet cost summaryARead-onlyInspect
Query production infrastructure costs (Lambda, RunPod, R2, WaveSpeed, PoYo), optionally with reconciliation drift. This is spend data, not engagement — for a published job's audience numbers use get_job_metrics.
Inputs: since, groupBy, provider, includeReconciliation.
get_exampleGet VideoSpec exampleARead-onlyInspect
Return a starter example for one template.
Inputs: templateId (required).
get_job_metricsGet job metricsARead-onlyInspect
Get the latest platform engagement metric snapshots for a published job (newest first). Read-only. Only meaningful after publish_job; for render progress use get_job_status.
Inputs: jobId (required), limit.
get_job_statusGet job statusARead-onlyInspect
Get detailed status for a job: runs, artifacts, verifications, plus the current video and thumbnail URLs. The main polling target after create_video_brief or edit_video_brief; for post-publish engagement numbers use get_job_metrics instead.
Inputs: jobId (required).
get_render_instructionsGet local render instructionsCRead-onlyInspect
Return clone, install, validate, preview, and render commands.
Inputs: client.
get_templateGet Remotion templateBRead-onlyInspect
Get one public template contract.
Inputs: templateId (required).
get_video_schemaGet VideoSpec schemaARead-onlyInspect
Return the public VideoSpec JSON Schema.
Inputs: no named parameters.
get_video_stateGet video stateARead-onlyInspect
Get the materialized video state for a job (composition decisions: scenes, duration, aspect ratio, etc.). Use it to inspect what the video contains; for pipeline progress and video URLs use get_job_status.
Inputs: jobId (required).
inspect_workflowInspect workflowARead-onlyInspect
Inspect the current Studio workflow and its version history for a job.
Inputs: jobId (required).
list_jobsList jobsARead-onlyInspect
List recent video jobs for the current organization (newest first). Start here to discover job IDs; for one job's full detail use get_job_status.
Inputs: limit, status.
list_templatesList Remotion templatesARead-onlyInspect
List public templates, optionally filtered by aspect ratio.
Inputs: aspect.
patch_workflowPatch workflowAInspect
Create a new workflow version by recursively merging a patch into the current version.
Inputs: jobId (required), patch (required), expectedVersion (required).
preview_workflowPreview workflowARead-onlyInspect
Return the current workflow's compiled UniversalVideo brief for a safe pre-render preview.
Inputs: jobId (required).
publish_jobPublish jobADestructiveInspect
Publish an APPROVED job to its connected social destination via the gated publish API. All production gates run (paid plan, ownership, abuse, QA, disclosure, destination, rights, moderation). Requires a key with publish scope; the post goes live on the external platform and cannot be recalled by the API. For YouTube pass youtubePrivacyStatus:'private' for safe runs.
Inputs: jobId (required), tiktokPostMode, confirmQaOverride, youtubePrivacyStatus, +2 more.
regenerate_narrationRegenerate narrationAInspect
Regenerate narration from the unchanged durable brief and then regenerate its dependent video in a paid adaptation run. Use only on an explicit user request or when get_job_status recommends retryTarget tts. This is an audio_and_video cascade, consumes rerender quota, and requires fresh QA.
Inputs: jobId (required), trigger (required), sourceRunId (required).
retry_video_qaRetry video QAAInspect
Retry the default QA evaluator against the same current frozen video. Use only when get_job_status recommends retryTarget qa_only, or when QA is missing, unavailable, or parse-degraded. This does not regenerate media and cannot clear publish gates by itself.
Inputs: jobId (required), runId (required), videoArtifactId (required).
scaffold_video_specScaffold VideoSpecARead-onlyInspect
Return a deterministic VideoSpec skeleton without writing files.
Inputs: title (required), templateId (required), aspect, mediaSrc.
validate_workflowValidate workflowAInspect
Validate and compile the inspected workflow version without rendering or publishing it.
Inputs: jobId (required), expectedVersion (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 29 tools
The tool set covers distinct resources and actions, but a few pairs like validate_workflow vs preview_workflow and retry_video_qa vs audit_video_qa require careful reading of descriptions to avoid confusion. Overall, the purposes are mostly clear.
All tools use a consistent verb_noun snake_case pattern, e.g., list_templates, create_video_brief, approve_job. The naming is uniform and predictable.
29 tools is well above the typical range and likely overwhelms agents, especially with many closely related workflow and QA operations. The scope could be consolidated or documented in batches.
The server covers a full video creation pipeline: templates, workflows, job creation/editing, status polling, QA, approval, publication, and account connection. Minor gaps like explicit delete/cancel operations exist but do not block the primary workflow.
Maintenance
Related MCP Connectors
Generate images and video from Claude with one API key.
Brand-aware creative studio for Claude: 200+ tools for on-brand ads, video, email and campaigns.
Create HD vertical videos with Claude and auto-post them to TikTok, YouTube Shorts and Reels.
Make AI videos and images in Qulture Studio from ChatGPT, Claude, Cursor or any MCP client.
Related MCP Servers
- AlicenseAqualityBmaintenanceTurn any YouTube video, article, PDF, or image into a reusable Claude Code skill — without leaving your editor.6340 PyPI36MIT
- AlicenseNot gradedqualityDmaintenanceEnables Claude to analyze reference videos (download, transcripts, frames) and generate new branded Instagram Reels/YouTube Shorts as React/TSX compositions, rendered to MP4 via Remotion.1MIT
- AlicenseBqualityCmaintenanceProvides Claude Code with local ffmpeg-based tools to probe, trim, concat, transform, overlay, mix audio, render JSON timelines, and run automated QA on video files—no API key required.9Apache 2.0
- FlicenseNot gradedqualityAmaintenanceEnables Claude Code, Codex, Hermes, OpenCode, and other MCP hosts to turn natural-language prompts over raw video clips into finished, beat-synced montage edits with music matching, subtitles, transitions, and picture-in-picture, while returning reviewable timeline digests and contact sheets before rendering.-