Levea MCP Server

Levea MCP Server

An autonomous agentic video editor. Send a sentence. Get a finished video. No timelines, no keyframes, no plugin chains. Open-source MCP client connecting local AI agents (Claude, Cursor, Cline) to our cloud GPU video production harness.

Beta. The agent can make mistakes. Preview every output before publishing or sharing. For high-stakes or irreversible edits, pass requirePlanApproval: true so the agent stops after planning and waits for your approval before anything runs.

Contents

1. Quickstart — running in 60 seconds
2. What it does — say it, get it
3. Capability surface — the full toolset
4. Goals & briefs — from one line to a full creative brief
5. API reference — endpoints, request/response, streaming, async
6. Who it's for · vs. legacy editors · Safety · Media
7. Links & channels

Quickstart

The portable interface is the [`levea-mcp-server`](https://www.npmjs.com/package/levea-mcp-server) MCP server — one server, every MCP client (Claude Desktop, Claude Code, Cursor, Cline, OpenClaw, Hermes), one tool surface, one backend contract, so nothing drifts per platform.

1. Get an API key — sign up at [livecore.ai](https://livecore.ai/?openclaw=1&utm_source=npm&utm_medium=mcp-server&utm_campaign=levea-mcp-server) and generate a Levea API key.

2. Add the MCP server — the same npx line works for every MCP client:

{

"mcpServers": { "levea": { "command": "npx", "args": ["-y", "levea-mcp-server"], "env": { "LEVEA_API_URL": "https://api.livecore.ai", "LEVEA_API_KEY": "your-key-from-livecore.ai" } } } }

3. Use it — say to your AI: *"Use the levea tool to generate 5 viral clips from this video, add captions, reframe vertical."* The agent picks the tool, fills the prompt; the editor plans → executes → exports. A full edit takes minutes, not seconds; see Safety & limits for long edits.

Per-client setup

This package on npm: npx -y levea-mcp-server — no global install needed.

Hosted endpoint — no install

Clients that connect to a remote MCP server by URL (Smithery, Claude / ChatGPT connectors, Cursor remote servers) can skip npx entirely:

URL:    https://api.livecore.ai/api/v1/misc/mcp      (Streamable HTTP, stateless)

Auth: OAuth 2.1 sign-in (clients that support it open your Levea account in the browser) or Header: Authorization: Bearer your-key-from-livecore.ai

Same tools, same backend. Clients that can't set headers may pass ?apiKey=... instead. Every request is authenticated, including the tool list; an unauthenticated call gets 401 with a WWW-Authenticate challenge that points OAuth clients at the sign-in flow.

Every client calls the same backend: this MCP server, the hosted endpoint, the OpenClaw and Hermes plugins, and the ChatGPT action share one tool contract.

Two hosts — don't confuse them

Env vars are LEVEA_API_URL / LEVEA_API_KEY.

Tools the AI sees

One editing entry point. Everything else is typed state-management and polling — so integrators can build full editing experiences through one API key instead of mixing JWT and MCP.

No edit shims (add_captions, generate_viral_clips, …) and no editor_execute escape hatch. The backend's planner is the specialist — fragmenting the editing surface encourages calling LLMs to second-guess the planner and lose multi-step intent. State-management tools (brand / project / asset / caption-template CRUD) aren't editing, so they don't fragment intent — they just give integrators typed access.

→ For agent-integration details (schemas, async semantics, error handling, plan approval), see [AGENTS.md](https://github.com/brajendrak00068/agentic-ai-video-production/blob/main/AGENTS.md).

What it does

Say it in plain language; the agent plans and finishes the edit.

Capability surface

The full toolset behind the prompt. Everything below is reachable from natural language — mix and match in a single sentence.

🔍 Read & inspect

• Scene state — timeline / layer / scene structure, schema introspection
• Search — asset gallery (type, duration, name); transcript (keyword, semantic, timestamp)
• Vision — CV frame analysis (object, face, scene); on-screen text-region detection (locates chyrons / lower-thirds / burned-in captions so reframing avoids covering them)
• Intelligence — narrative peaks, speaker diarization, sentiment, pacing
• Jobs — async job status polling

✂️ Structural editing

• Layers — insert / update / replace / delete (video, audio, image, text, shape, solid, adjustment, group, light, vfx, visualizer, lottie)
• Timing — trim, split, retime (slow-mo 0.5×, fast-forward 2×, freeze-frame), reverse, stabilize
• Arrange — reposition, sequence, snap to transcript word boundaries
• Assemble — multi-cam sync + automatic angle switching, montage assembly (shot discovery + sequencing from source footage), slideshow generation, chapter markers, SRT import
• Safety — gap healing, audio normalize, duration reconcile (pre-export pass), multi-step undo / redo

🎬 Visual editing

• Color grade — brightness, contrast, saturation, hue, lift/gamma/gain, RGB curves, LUT / film-look presets (including your own .cube files), auto color, shot-to-shot color matching, vignette, chromatic aberration
• VFX — ~100 GPU effect presets: lens flares, film burn, bloom, rain, dust, smoke, fire, explosion, lightning, snow, glitch, scanlines, grain, lens blur, slit-scan, glassmorphism, bokeh, portal, …
• Transitions — 160+ named transitions (wipes, whips, light-band reveals, glitches, CRT power-off, …)
• Editing techniques — speed ramps and time remap, J/L, match, and smash cuts, AI outpainting to a new aspect ratio, eye-contact correction, face retouch
• Composite — chroma key, AI background removal (alpha matte), masking (luma / alpha / depth, with boolean multi-mask)
• Blend & opacity — 29 blend modes (multiply, screen, overlay, color dodge / burn, difference, hue / saturation / color / luminosity, additive) + per-layer & group opacity
• Shape & transform — clip shapes (circle, dome, star, hexagon, polygon), crop, 3D rotation / perspective, glow, shadow, gradient fills
• Lighting — up to 8 scene lights illuminating 3D-transformed layers
• Reframe & layout — caption-safe vertical reframe (9:16) + vertical montage, split screen (top/bottom, L/R, PiP, grid)
• Track — motion / face tracking with zoom-follow, branding overlays
• Camera — keyframed 3D camera moves (push-in, orbit, drift) with depth-based parallax

📊 Motion graphics & data viz

*Every graphic is placed clear of faces and reviewed by an AI critic before it reaches the timeline:*

• Data — transcript-driven charts (bar, line, pie), stat callouts, animated counters
• Lower-thirds & cards — lower-thirds, title / chapter cards, checklists, keyword pills
• Diagrams — flowcharts, timelines, geo callouts
• Layouts — collage layouts, text behind the subject, sticker cut-outs
• Films — standalone motion-graphic films from one sentence: 2D motion design and 3D character films with camera moves, lighting, music, and sound design
• CTAs — animated subscribe / call-to-action buttons

💬 Captions & text

• Generate — auto-cap