How to Use the Creatomate MCP in Windsurf

Let Cascade automate your video generation workflows directly inside Windsurf.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Creatomate MCP to Windsurf

Create your Vinkius account to connect Creatomate to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Creatomate with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Browse Creatomate templates from Windsurf

Cascade doesn't need you to hunt down asset IDs in a separate browser tab. When you want to build a new video workflow, your agent pulls everything straight into your editor using `list_video_templates` and `list_media_assets`. You just tell Windsurf to find the right base for a social media clip. It runs `search_templates_by_name` to grab the exact one, then uses `get_template_details` to map out the dynamic fields you need to populate.

Trigger and track renders autonomously

Generating a video usually involves a lot of waiting and checking back. Cascade chains the entire process together using this MCP integration by calling `render_video` with your modified template fields, then automatically polling `get_render_status`. Once the render finishes, your IDE has the final URL ready to use in your codebase. If something goes wrong or you need to see what ran overnight, `list_recent_renders` pulls that history right into your chat window.

Connect this MCP Server to your automation

Building complex video pipelines requires knowing how your workspace is configured. Windsurf pulls your environment defaults using `get_project_settings` before it starts modifying files. From there, your agent can review existing setups via `list_video_automations`. It understands the current video architecture and writes the exact integration code you need without breaking what already works.

Setup guide

Set up Creatomate MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Creatomate MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Creatomate payment history." If connected, Cascade will call the Creatomate tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "creatomate-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Creatomate. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Creatomate now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Creatomate MCP in Windsurf

Open your settings and navigate to the Cascade MCP Servers UI. You can also edit your `~/.codeium/windsurf/mcp_config.json` file to add the server manually. Click refresh in the panel to load the tools.

Yes. Cascade reads your prompt and figures out the required steps. It will search for a template, trigger the render, and wait for the status URL without needing permission for each action.

Cascade checks the progress using the status tool. If the render errors out, the agent reads the failure response and tells you exactly what went wrong in the chat.

Your agent inspects the structure directly. By calling the template details tool, it maps out every dynamic text and image field so it knows exactly what data to pass during the render.

Vinkius routes your requests through a strict V8 Isolate Sandbox. Your video templates, uploaded media assets, and render histories stay completely isolated from other users. Ephemeral execution means we drop the connection state the moment your render request finishes.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript