Give Cursor, Claude, ChatGPT, internal automations, and custom AI agents a direct way to create viral-ready videos with Revid. Use MCP for tool calling, or call the public API directly when you want full backend control.
Turn scripts, prompts, articles, audio, music, captions, avatars, and ads into short-form videos.
Expose the full Revid creation pipeline through MCP tools with clear resources and structured responses.
Use the MCP wrapper for agent actions or call the same public API directly from your own backend.
Checking your session so we can personalize the examples with your Revid API key.
Keep this key secret. Requests made with it consume credits from your Revid account or active workspace.
{
"mcpServers": {
"revid": {
"url": "https://www.revid.ai/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_REVID_API_KEY"
}
}
}
}curl -X POST "https://www.revid.ai/api/public/v3/render" \
-H "Content-Type: application/json" \
-H "key: YOUR_REVID_API_KEY" \
-d '{
"workflow": "voiceover-to-video",
"source": {
"text": "Create a 30-second short video about 3 surprising AI productivity tips."
},
"media": {
"type": "moving-image",
"quality": "pro",
"animation": "soft"
},
"voice": {
"enabled": true,
"voiceId": "cgSgspJ2msm6clMCkdW9"
},
"captions": {
"enabled": true,
"preset": "Wrap 1",
"position": "bottom"
}
}'# Revid MCP quick reference
endpoint: https://www.revid.ai/api/mcp
transport: Streamable HTTP
auth: Authorization Bearer, x-revid-api-key, x-api-key, or key
primary flow: render_video -> get_project_status -> export_video or publish_now
render docs resource: revid://docs/render
mcp guide resource: revid://docs/mcp
tools: render_video, get_project_status, list_projects, calculate_credits, export_video, rename_project, clone_voice, list_characters, create_character, delete_character, schedule_publish, publish_now, buy_credit_packThe MCP wraps Revid's public video API, so agents can generate, monitor, export, rename, and publish projects without inventing their own video pipeline.
Call `render_video` with a workflow and source payload.
Store the returned `pid` as the project identifier.
Poll `get_project_status` until the response includes `videoUrl`.
Optionally call `export_video`, `schedule_publish`, or `publish_now`.
Agents can choose the workflow that matches the user's intent, then pass only the relevant source, media, voice, caption, music, avatar, and render fields.
The tool names are stable and descriptive, which makes this page easy for humans to scan and easy for AI agents to parse.
Revid handles scripting, visuals, voice, captions, music, rendering, exporting, and social publishing, so your agent can focus on intent, strategy, and iteration.
The `revid-cli` package is the fastest way to give shell-based agents, CI jobs, and local scripts access to Revid video creation. It supports exact API payloads, stable `--json` output, guided human setup, async waiting, exports, credits, docs, and project listing.
npm install -g revid-cli
export REVID_API_KEY="your_revid_api_key"
revid --helprevid create --prompt "A cinematic 30 second product launch video" --wait --json
revid create --payload payload.json --wait --json
revid projects --limit 10 --json
revid status <pid> --json
revid export <pid> --jsonThese examples map directly to Revid MCP and API workflows, from prompts and PDFs to motion transfer and music videos. Use them as a visual reference for what an agent can generate after calling `render_video`.
See how Revid transforms basic text, images, or documents into studio-quality videos in minutes.
Script automatically generated by Revid
