How to Use the Kapwing MCP in Windsurf

Q: What data does the Kapwing server access when I use it with my agent?

The server only handles the JSON project data you send to createrender and the render IDs used to track jobs. Your Vinkius token authenticates the requests, and all data is processed ephemerally during the API call to Kapwing.

Automate video creation from a single prompt. Tell Windsurf what you want, and Cascade builds it with Kapwing.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Kapwing MCP to Windsurf

Create your Vinkius account to connect Kapwing 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 Kapwing with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Generate Videos from JSON

The `create_render` tool lets you kick off a new video render by feeding it a JSON object. You just define the project's layers, dimensions, and assets. Windsurf can generate this JSON for you based on a prompt or existing data. Cascade takes it from there. It calls `create_render`, then automatically uses `get_render_status` to poll the job. You don't have to write a polling loop or manually check anything.

Track and Manage Renders with Windsurf

The `get_render_status` tool checks on a specific render job. It returns the current state—queued, processing, or complete—and gives you the download URL when it's done. This is where Windsurf shines. You can ask it, "Did that last video for the social campaign finish rendering?" Cascade will use `list_renders` to find the job, then `get_render_status` to check it, and pull the final video right into your project.

Access Your Entire Kapwing Library

Use the `list_renders` tool to get a full history of all renders tied to your account. It’s a straightforward way to see what's been built or find a specific asset you rendered last week. Connect this MCP server, and Windsurf can use this tool to build an inventory of your existing videos. Ask it to "find all vertical videos with 'product demo' in the name," and it will scan the output of `list_renders` to get you the files.

Setup guide

Set up Kapwing 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 Kapwing 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 Kapwing payment history." If connected, Cascade will call the Kapwing tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "kapwing-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 Kapwing. 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 Kapwing 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 Kapwing MCP in Windsurf

You give Windsurf a goal, like "Create a 15-second promo video from these assets." Its Cascade agent plans the steps: it calls `create_render` with the project data, polls `get_render_status`, and delivers the final URL. You don't manage the individual tool calls.

Yes. Just ask Windsurf to find a video based on when it was made or other details. It uses the `list_renders` tool to pull your account history and find the asset you're looking for.

The tool expects a standard Kapwing project JSON. This object defines the canvas size and an array of layers for video clips, text, and images. You can often have Windsurf generate this for you from a simpler prompt.

No, it's for automation. This MCP server lets your agent programmatically create and manage renders. It's built for batch jobs or integrating video generation into other workflows, not for manual, one-off edits.

The server only handles the JSON project data you send to `create_render` and the render IDs used to track jobs. Your Vinkius token authenticates the requests, and all data is processed ephemerally during the API call to Kapwing.

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