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.

Quick Start

1

Add the MCP server

Run this in your terminal:

claude mcp add vyra --transport http https://api.usevyra.com/mcp

For other MCP clients, use the server URL https://api.usevyra.com/mcp

2

Authenticate

The first time you connect, your browser will open to authorize the agent with your Vyra account. Sign in and click Approve.

3

Open a project

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

4

Start editing

Ask the agent to edit your video. It has access to 50+ tools covering the full editing workflow.

Other Clients

Claude Desktop App

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "vyra": {
      "type": "url",
      "url": "https://api.usevyra.com/mcp"
    }
  }
}

claude.ai

Go to Settings → Integrations → Add MCP Server and paste https://api.usevyra.com/mcp.

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

How It Works

Vyra's MCP server implements the Model Context Protocol (2025-03-26 Streamable HTTP transport).

  • Authentication: OAuth 2.1 with PKCE. The agent authenticates with your Vyra account through a browser consent flow.
  • Backend tools (asset search, project info, stock search) execute on the server directly.
  • Frontend tools (timeline edits, adding media, effects) are dispatched to your browser where the editor is open, executed against the live editor state, and results are returned to the agent.
  • Resources provide read access to project state, assets, template, and style configuration.

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.

Troubleshooting

"No browser connected"

The editor isn't open. Open a project at app.usevyra.com — timeline tools require the editor to be active in your browser.

Authentication fails

Try removing and re-adding the MCP server. 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, you need to restart the connection.

← Back to docs