Quickstart and architecture

A video engine your agent can actually understand.

iLoveVideoAgents connects agent intent to a deterministic composition contract, a render pipeline, and a delivery URL. Here is the shortest path through the system.

Install the interface

Add the MCP server to your client, expose VF_API_KEY, and restart your agent.

Open guide 02

Compose the video

Start from a template or write VideoJSON when you need full control over scenes and layers.

Open guide 03

Render and deliver

Queue a job, poll its state, and hand your workflow the signed download URL.

Open guide

System map

From agent intent to MP4 delivery.

The interface is modular, but the mental model stays simple: choose a way in, keep the composition structured, and let the render pipeline do the heavy work.

home.architecture.nodes.agentsClaude · Codex · Cursor

MCP · SDK · CLIhome.architecture.nodes.interface

VideoJSONhome.architecture.nodes.composition

home.architecture.nodes.renderPipelineBrowser · Server · Edge

home.architecture.nodes.deliveryR2 · signed URL · webhook

First render

Install once. Ask once. Ship.

Use this as the first prompt after your MCP client reconnects.

terminal

npx -y @ilovevideoeditor/mcp-server

# Then ask your agent:
"List available video templates and render a 10-second product promo for my launch."

Server connected VF_API_KEY available Template selected Render job returned

Need the full API?

The developer portal contains REST, SDK, billing, webhooks, and project management references.

Open API docs

Want deeper creative knowledge?

Install the agent skills package for VideoJSON, effects, animation, templates, and render review workflows.

Install skills