Enables AI agents to create, scaffold, and manage video projects using Remotion and HyperFrames templates through local or hosted workflows.
Also known as instavar/mcp-server, mcp-server, @instavar/mcp-server
- Stars
- 0
- Tools
- 15
- Downloads, 30 days
- 790
- Latest version
- 0.7.1
- Last commit
- Oct 28, 2026
- License
- —
What is Instavar MCP?
Instavar enables AI agents to create, scaffold, and manage video projects using Remotion and HyperFrames templates through local or hosted workflows. It exposes 15 tools, such as get_creative_guide, prepare_announcement, prepare_video_template.
Summary generated from the project's README
How to install Instavar MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Instavar MCP in Claude Code
$ claude mcp add --env 'INSTAVAR_API_KEY=<YOUR_INSTAVAR_API_KEY>' mcp-server -- npx -y @instavar/mcp-serverInstall Instavar MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@instavar/mcp-server"
],
"env": {
"INSTAVAR_API_KEY": "<YOUR_INSTAVAR_API_KEY>"
}
}
}
}Install Instavar MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@instavar/mcp-server"
],
"env": {
"INSTAVAR_API_KEY": "<YOUR_INSTAVAR_API_KEY>"
}
}
}
}Install Instavar MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp-server","type":"stdio","command":"npx","args":["-y","@instavar/mcp-server"],"env":{"INSTAVAR_API_KEY":"<YOUR_INSTAVAR_API_KEY>"}}'Install Instavar MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@instavar/mcp-server"
],
"env": {
"INSTAVAR_API_KEY": "<YOUR_INSTAVAR_API_KEY>"
}
}
}
}Install Instavar MCP in Codex
$ codex mcp add mcp-server --env 'INSTAVAR_API_KEY=<YOUR_INSTAVAR_API_KEY>' -- npx -y @instavar/mcp-serverInstall Instavar MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp-server] command = "npx" args = ["-y", "@instavar/mcp-server"] [mcp_servers.mcp-server.env] INSTAVAR_API_KEY = "<YOUR_INSTAVAR_API_KEY>"
Install Instavar MCP in Gemini CLI
$ gemini mcp add -s user -e 'INSTAVAR_API_KEY=<YOUR_INSTAVAR_API_KEY>' mcp-server npx -- -y @instavar/mcp-serverInstall Instavar MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@instavar/mcp-server"
],
"env": {
"INSTAVAR_API_KEY": "<YOUR_INSTAVAR_API_KEY>"
}
}
}
}Started by HostedMCP on 16 Nov 2026
We ran this command for @instavar/mcp-server 0.7.0 in an isolated container with no network and no keys. It answered and listed 15 tools.
Instavar MCP tools 15
Read from the server with tools/listget_creative_guideRead-onlyRead practical guidance before drafting concise plain or poetic copy, choosing carousel stories, designing visuals or recording human feedback. Returns guidance for the calling assistant to apply, not generated copy or saved feedback. Omit guideId to list guides.
prepare_announcementRead-onlyPrepare one paired announcement-card-v1 template, continue its caller-held project, edit copy or switch frameworks. Returns source files for local rendering. For the paired announcement-card-v1 or a HyperFrames announcement request, use prepare_announcement. Never infer a framework from creative wording. Omit framework unless the user explicitly chooses one or says no preference. If needs-selection, ask the user. Continue with the latest returned project and expectedRevision; apply edits through edits before switching. Keep the returned project document for later calls. Never describe this caller-held document as a saved hosted project. VideoSpec templates use prepare_video_template in either framework.
prepare_video_templateRead-onlyValidate one VideoSpec against the paired template contract and return local source for the chosen framework, or switch an existing project's framework. For a VideoSpec template in Remotion or HyperFrames, use prepare_video_template with the VideoSpec. Never infer a framework from creative wording; omit framework unless the user chose one or said no preference, and ask the user on needs-selection. Continue with the returned project: edit project.spec, then call again to regenerate or to switch frameworks. A rejected field is unsupported in both frameworks; fix it rather than dropping it. The tool returns local source and commands; it does not render, save or upload.
get_capabilitiesRead-onlyCall first. Reports free local features and optional account features.
list_carousel_templatesRead-onlyList the account-free editorial carousel story structures.
get_carousel_schemaRead-onlyReturn the JSON Schema for deterministic Instavar carousel decks.
scaffold_carousel_deckRead-onlyBuild a deterministic editorial carousel deck from accepted copy. This does not render, save, or publish it.
list_templatesRead-onlyList the published video template families, each available in Remotion and HyperFrames, and optionally filter by output aspect ratio.
get_templateRead-onlyGet one template's purpose, aspect ratios, scene kinds, and example identifier.
get_video_schemaRead-onlyReturn the published JSON Schema for VideoSpec version 1.0.
get_exampleRead-onlyReturn a valid starter example for one template family.
propose_video_storyboardRead-onlyTurn an ordinary video request into a three-beat visual proposal and recommended template. Pass templateId to preserve an accepted template when changing only the aspect; omit it for a new direction. This tool does not generate images, save a project, render, or publish.
Show all 15 toolsShow fewer tools
scaffold_video_specRead-onlyReturn a deterministic VideoSpec skeleton. This tool does not generate creative copy or write files.
get_render_instructionsRead-onlyReturn the clone, install, validate, preview, render, and QA workflow.
diagnose_render_errorRead-onlyClassify a local validation or render error and return a safe next step.
Configuration
INSTAVAR_API_KEYSecretOptional key from https://instavar.com/studio/settings that unlocks hosted workflows.
INSTAVAR_BASE_URLOverride the Instavar API host. Defaults to https://instavar.com.
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points
- Source repository linked and reachableinstavar/mcp-server is public and reachablegithub.com/instavar/mcp-server ↗Pass
- Package names this repository as its source@instavar/mcp-server names instavar/mcp-server as sourcenpmjs.com/package/@instavar/mcp-server ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-06github.com/instavar/mcp-server ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @instavar/mcp-serverPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model37 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 738 msPass
README
View on GitHub@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.
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 |
|---|---|---|---|
INSTAVAR_API_KEY |
no | — | Unlocks hosted Studio tools. Scoped to your org; revocable. |
INSTAVAR_BASE_URL |
no | https://instavar.com |
Override the API host. |
INSTAVAR_PAIRED_TEMPLATES |
no | on | Set to 0 to hide prepare_video_template and keep the VideoSpec tools Remotion-only. |
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 |
|---|---|
get_capabilities |
Reports free and optional account features. |
get_creative_guide |
Reads concise copy, story, design and review guidance. |
propose_video_storyboard |
Proposes three visual beats and a template. |
list_templates |
Lists published template families. |
get_template |
Returns one template contract. |
get_video_schema |
Returns the public VideoSpec JSON Schema. |
get_example |
Returns a starter VideoSpec. |
scaffold_video_spec |
Creates a deterministic VideoSpec skeleton. |
prepare_video_template |
Realises a VideoSpec in Remotion or HyperFrames. |
prepare_announcement |
Prepares one paired announcement card. |
list_carousel_templates |
Lists the editorial carousel story structures. |
get_carousel_schema |
Returns the CarouselDeck JSON Schema. |
scaffold_carousel_deck |
Builds a deterministic carousel deck from copy. |
get_render_instructions |
Returns the local validation and render workflow. |
diagnose_render_error |
Classifies common local render failures. |
Hosted tools, available when INSTAVAR_API_KEY is configured:
| Tool | What it does |
|---|---|
list_jobs |
List recent jobs (newest first). |
get_job_status |
Runs, artifacts, verifications, current video + thumbnail URLs. |
get_video_state |
Materialized composition state for a job. |
diagnose_render |
Read-only joined render diagnosis with evidence limits and retry recommendations. |
get_job_metrics |
Platform engagement snapshots for a published job. |
get_cost_summary |
Infra cost summary (Lambda / RunPod / R2 / WaveSpeed / PoYo). |
inspect_workflow |
Read the current workflow and its version history. |
create_video_brief |
Create a job from a structured brief and start rendering. |
edit_video_brief |
Patch a brief (incl. objective / publishTarget); re-renders unless only publishTarget changed. |
retry_video_qa |
Retry degraded or unavailable QA against the same current frozen video artifact. |
audit_video_qa |
Run an advisory Qwen3.6-Plus second opinion against the same frozen video. |
regenerate_narration |
Regenerate narration and its dependent video from the unchanged durable brief. |
draft_workflow |
Store a complete workflow using the inspected expectedVersion (0 only when none exists). |
patch_workflow |
Create a conflict-aware workflow version from a recursive patch. |
validate_workflow |
Validate and compile the inspected workflow version without rendering. |
preview_workflow |
Read the compiled UniversalVideo brief without rendering. |
compare_workflows |
Compare two durable workflow versions field by field. |
approve_workflow |
Approve the inspected valid version without approving or publishing the video job. |
approve_job |
Approve a rendered job so it can be published. |
publish_job |
Publish an approved job to its connected social destination. |
connect_account |
Start connecting a social account (headless OAuth pairing). |
connect_account_status |
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 --help
License
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.
Instavar MCP questions
How do I add Instavar MCP to Claude Code?
Run claude mcp add --env 'INSTAVAR_API_KEY=<YOUR_INSTAVAR_API_KEY>' mcp-server -- npx -y @instavar/mcp-server in your terminal. Add --scope user to make it available in every project.
How do I add Instavar MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Instavar MCP provide?
It exposes 15 tools, including get_creative_guide, prepare_announcement, prepare_video_template, get_capabilities, list_carousel_templates.
Do I need an account or API key to use Instavar?
No, you can use the free local templates for Remotion from Claude Code or Codex without an account or API key.
What does the hosted Studio workflow provide?
Adding an API key unlocks a hosted workflow that includes creating, rendering, approving, publishing, and viewing metrics.
How do I use the hosted tools?
To unlock hosted Studio tools, you must create an API key at the Instavar website and add it to your MCP client configuration as an environment variable.