MCP Server

Connect Claude Code, Codex, or any MCP-compatible agent to control your Vyra editor remotely. The agent can view your timeline, add media, edit properties, apply effects, and more — all while you see changes in real time in your browser.

Setup

Pick your client below. The first time you connect, your browser will open to authorize the agent with your Vyra account.

Watch on YouTube →

Works on both claude.ai and the Claude Desktop app:

  1. Click your profile icon → Settings → Connectors
  2. Click Add custom integration
  3. Enter the name Vyra and the URL https://api.usevyra.com/mcp
  4. Click Add — you'll be redirected to authorize

To use in a conversation, click the + button in the chat input, then Connectors, and toggle Vyra on. Requires Pro or Max plan.

After Connecting

1

Open a project

Open any project in the Vyra editor at app.usevyra.com. The agent needs the editor open in your browser to execute timeline tools.

2

Connect this tab

Click the Connect MCP button in the editor's top bar to bind this specific browser tab to your agent. Editing-tool calls from the agent only land in the tab you've connected — if you have multiple tabs open, this is how you pick which one the agent drives. A green status dot means you're bound.

Connect MCP button in the editor top bar, with the popover showing a Connect this tab button
3

Start editing

Ask the agent to edit your video. It has access to 50+ tools covering the full editing workflow. Changes appear in the editor in real time.

What You Can Do

View & Search

  • Browse project assets and references
  • View timeline state, tracks, items, and timing
  • Search footage by visual content, transcript, location, or date
  • Capture screenshots of the canvas at any timestamp
  • Search stock media (Pexels, Freesound)

Edit & Build

  • Add video, audio, images to the timeline with trim control
  • Add text overlays, shapes, and styled captions
  • Edit properties — position, scale, opacity, volume, speed
  • Move, split, slip, clone, and delete timeline items
  • Set keyframes for animation

Effects & Compositing

  • Apply and configure effects (color, stylize, distort)
  • Create and animate masks (rectangle, ellipse, pen tool)
  • AI-powered background removal
  • Build motion graphics with React/Remotion code

Project & Assets

  • Read project template and style configuration
  • Add assets from your library or stock to a project
  • Manage markers and consolidate tracks

Requirements

  • A Vyra account (free or paid)
  • A project open in the Vyra editor for timeline editing tools
  • An MCP-compatible client (Claude Code, Claude Desktop, claude.ai, Codex, etc.)

Managing Sessions

You can view active MCP sessions and revoke access from Settings → External Agent in the Vyra app. When an agent is connected, a "MCP" tab appears alongside your chat panel showing tool activity in real time.

Stuck?

Troubleshooting

"No browser connected"
The agent can't reach your editor. Make sure you have a project open at app.usevyra.com AND that you've clicked Connect MCP in the top bar of that tab. Editor tools require an explicit tab binding — opening the project alone isn't enough.
Multiple tabs / projects open
Only one tab can be bound to the agent at a time. If you click Connect MCP in a second tab, it offers a "Take over" option that disconnects the first. The agent's tool calls always land in the most-recently-bound tab.
Authentication fails
Try removing and re-adding the MCP server in your client. If using Claude Code, run claude mcp remove vyra then add it again.
Tools not appearing
Reconnect the MCP session. The tool list is fetched on initialization — if tools were updated, restart the connection.
← Back to docs