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. Go to Customize → Connectors
  2. Click + Add, then Add custom connector
  3. Enter the name Vyra and the URL https://api.usevyra.com/mcp, then click Continue
  4. Review the detected sign-in and click Continue
  5. Under Authentication, choose Sign in now, then click Add and you'll be redirected to authorize

To use in a conversation, click the + button in the chat input, then Connectors, and toggle Vyra on. On a Team or Enterprise plan, an Owner adds Vyra in Organization settings → Connectors first, then you click Connect on it in Customize → Connectors. Free plans allow one custom connector.

After Connecting

1

Pick a project

Ask the agent to list your projects or create a new one. Vyra's MCP server is headless, so nothing needs to be open on your side. Each agent gets its own editing container on our servers, and it keeps working with your laptop closed or your phone off.

2

Start editing

Ask the agent to edit your video. It has access to 50+ tools covering the full editing workflow, plus voiceover, image, sound effect, and music generation. It can work on several projects at once.

3

Review in the app

Every project the agent builds opens in the Vyra editor at app.usevyra.com and in the iPhone app, so you can check it or make hand edits any 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
  • An MCP-compatible client (Claude Code, Claude Desktop, claude.ai, the Claude mobile app, ChatGPT, Codex, Cursor, etc.)
  • Nothing open in your browser. The server is headless.

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

The agent asks you to open a browser tab
Your client is still using the old tool list from before the headless server. Refresh the tools list, reconnect the Vyra MCP connector, start a new session, and reload your AI app. Still stuck? Email caleb@usevyra.com.
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