@instavar/mcp-server
Drive the full Instavar Studio video workflow — create, render, approve, publish, and get metrics — from Claude Code or Codex without leaving your terminal.
README
@instavar/mcp-server
Drive the full Instavar Studio video workflow — create → render → approve → publish → metrics — from Claude Code or Codex, without leaving your terminal.
The server is a thin HTTP client: it authenticates with a per-user API key and talks to the hosted Instavar API. It holds no database connection and stores no data of its own.
Setup
- Create an API key at https://instavar.com/studio/settings (shown once — copy it).
- Add the server to your MCP client config:
{
"mcpServers": {
"instavar": {
"command": "npx",
"args": ["-y", "@instavar/mcp-server"],
"env": { "INSTAVAR_API_KEY": "ik_live_..." }
}
}
}
- Restart the client. The
instavartools appear.
Environment
| Var | Required | Default | Purpose |
|---|---|---|---|
INSTAVAR_API_KEY |
yes | — | Your key from /studio/settings. Scoped to your org; revocable. |
INSTAVAR_BASE_URL |
no | https://instavar.com |
Override the API host. |
Tools
| 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. |
get_job_metrics |
Platform engagement snapshots for a published job. |
get_cost_summary |
Infra cost summary (Lambda / RunPod / R2 / WaveSpeed / PoYo). |
create_video_brief |
Create a job from a structured brief and start rendering. |
edit_video_brief |
Patch a brief and re-render. |
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. |
Writes require a key with the write scope; publish_job requires publish.
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
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.