Build · MCPInstall
iLoveVideoAgents home
← All integrations

Agent integration

Codex integration

OpenAI Codex with MCP support. Configure via the Codex settings panel.

Requirements

  • ✓ MCP-compatible client with local process or remote transport support
  • ✓ VF_API_KEY stored in the client environment
  • ✓ Network access to the package registry or configured endpoint

Config location

Codex MCP Settings

Generate config

Verify without a render

Run this prompt after restarting the client:

List the available iLoveVideoEditor tools, then measure the text “Verified” with a sans-serif font. Do not render yet.

This records only the verification action; it does not send a key, prompt, or tool response.

Available tools (14)

list_templates

List all available templates for generating personalized videos.

get_template

Get detailed template information including variable schema.

search_catalog

Search composition catalog items by format, role, capability, motion, density, or free text.

get_catalog_item

Get one composition catalog item with slots, format coverage, motion metadata, and preview availability.

plan_content

Create a deterministic creative brief and scene plan using the canonical composition catalog.

render_json

Submit raw VideoJSON payload to the render queue. Returns a job ID for tracking.

render_template

Generate video from a named template + variables. Queue for rendering and return a job ID.

get_render_status

Check the status of a render job by ID. Returns progress, status, and download URL when complete.

get_download_url

Get a fresh signed download URL for a completed render.

get_layer_capabilities

Return compatible effects and transitions for a given layer type. Use BEFORE choosing effects.

local_preview

Start or stop a local preview dev server with Vite HMR for real-time video preview.

local_capture

Capture a screenshot from the running local preview at a given time.

local_analyze

Analyze VideoJSON layout in the local preview. Returns structured metrics, overflow, overlap, and font fallback issues.

measure_text

Measure text with real fonts before choosing maxWidth, lineHeight, and font size.

Troubleshooting

  • • Confirm the client can launch npx and has network access.
  • • Keep VF_API_KEY in the local environment, not in the prompt or config committed to git.
  • • Start with a read-only tool call before queueing a render.