Revid MCP + Public API

The ultimate video creation MCP for AI agents

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.

Generate finished videos

Turn scripts, prompts, articles, audio, music, captions, avatars, and ads into short-form videos.

Built for autonomous agents

Expose the full Revid creation pipeline through MCP tools with clear resources and structured responses.

One endpoint, many workflows

Use the MCP wrapper for agent actions or call the same public API directly from your own backend.

Your API key

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.

MCP server config
{
  "mcpServers": {
    "revid": {
      "url": "https://www.revid.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_REVID_API_KEY"
      }
    }
  }
}
Direct API render call
curl -X POST "https://www.revid.ai/api/public/v3/render" \
  -H "Content-Type: application/json" \
  -H "key: YOUR_REVID_API_KEY" \
  -d '{
    "workflow": "script-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"
    }
  }'
Agent-readable reference
# 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_pack
Agent workflow

From prompt to published video

The MCP wraps Revid's public video API, so agents can generate, monitor, export, rename, and publish projects without inventing their own video pipeline.

1

Call `render_video` with a workflow and source payload.

2

Store the returned `pid` as the project identifier.

3

Poll `get_project_status` until the response includes `videoUrl`.

4

Optionally call `export_video`, `schedule_publish`, or `publish_now`.

Supported video workflows

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.

script-to-videoprompt-to-videoarticle-to-videoaudio-to-videomusic-to-videoavatar-to-videocaption-videoad-generator

MCP tools exposed

The tool names are stable and descriptive, which makes this page easy for humans to scan and easy for AI agents to parse.

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_pack

Build video agents that actually ship finished content

Revid handles scripting, visuals, voice, captions, music, rendering, exporting, and social publishing, so your agent can focus on intent, strategy, and iteration.

MCP workflows in action

Show agents what Revid can create

These 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`.

AI Magic

Turn simple ideas into
incredible videos

See how Revid transforms basic text, images, or documents into studio-quality videos in minutes.

YOUR IDEA
Tool:AI Movie Maker
Your Prompt

Script automatically generated by Revid

SCENE 1 – THE STRANGE BEGINNING Exterior, Modena city walls, early morning, 1325. Dark clouds gather over medieval Italy. The camera slowly pushes in toward MATTEO OF MODENA, a battle-worn soldier in steel armor and chainmail, standing waist-up on the stone wall facing the camera. Soldiers move behind him preparing weapons. [Matteo of Modena – Veteran Soldier of Modena] (looking directly at the viewer) You’d think wars start over land… or gold. But the war I fought in… started because of a bucket. --- SCENE 2 – THE BUCKET Camera slowly circles Matteo as he walks along the city well in Modena’s courtyard. He bends down and lifts an old wooden bucket. Townspeople move nervously in the background. [Matteo] A few of our men snuck into Bologna one night. They didn’t steal treasure… or weapons. (raises the bucket slightly toward camera) They stole this. A simple bucket from the city well. --- SCENE 3 – THE INSULT Camera pans with Matteo as he walks toward the edge of the wall overlooking distant hills. He points across the landscape. The city of Bologna can be seen faintly in the distance. [Matteo] Over those hills… lies Bologna. And to them… this wasn’t a joke. It was an insult. --- SCENE 4 – AN ARMY FOR A BUCKET Wide shot as Matteo walks through soldiers preparing armor and sharpening swords. The camera tracks backward while he walks toward it. Behind him thousands of soldiers gather. [Matteo] So Bologna did something unbelievable. They raised an army. Thirty thousand men… All marching here… For a bucket. --- SCENE 5 – THE BATTLE OF ZAPPOLINO Camera cuts to Matteo standing waist-up on a dusty battlefield. Smoke rises. Soldiers clash behind him. The camera slowly pushes in while arrows fly overhead. [Matteo] We had barely seven thousand. But we met them at Zappolino. Steel crashed. Arrows filled the sky. And suddenly… A joke turned into a war. --- SCENE 6 – CHAOS OF WAR Camera handheld now, moving slightly to create urgency. Matteo ducks slightly as soldiers rush past him fighting behind him. He gestures toward the chaos behind him. [Matteo] Look behind me. That’s Bologna’s army. Thirty thousand men… Running. --- SCENE 7 – THE RETREAT Tracking shot as Matteo walks forward through the battlefield while defeated soldiers flee behind him. [Matteo] The great army of Bologna broke. And they ran all the way back to their city walls. We chased them the entire way. --- SCENE 8 – THE TROPHY Camera slows and centers Matteo again. He now stands inside a stone tower room lit by torches. The bucket sits on a pedestal beside him. He places a hand on it. [Matteo] When the fighting ended… We still had the bucket. --- SCENE 9 – THE LEGEND The camera slowly pushes in close on Matteo's face. The room is quiet now. [Matteo] Seven hundred years later… People still come to see it. --- SCENE 10 – FINAL LINE Matteo lifts the bucket slightly and looks directly at the camera. [Matteo] The strangest trophy in history. A war… Fought over a bucket.
Visual FormatAI Video
Visual StyleUltra Realism
Characters
Matteo of Modena
Matteo of Modena
FINAL VIDEO