Connect Katto to Cursor, VS Code & Windsurf

Katto’s official MCP server turns long videos into scored, captioned 9:16 clips from inside your editor. Add it with the hosted URL (OAuth, nothing on disk) or a local npx command with an API key. One config block per client below.

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per-project), then enable Katto in Settings → MCP.

Hosted (OAuth, recommended):

{
  "mcpServers": {
    "katto": { "url": "https://mcp.katto.tech/mcp" }
  }
}

Local (API key, for CI / no-OAuth):

{
  "mcpServers": {
    "katto": {
      "command": "npx",
      "args": ["-y", "katto-mcp"],
      "env": { "KATTO_API_KEY": "sk_live_..." }
    }
  }
}

VS Code (Copilot / MCP)

Add .vscode/mcp.json to your workspace (or run MCP: Add Server from the Command Palette):

{
  "servers": {
    "katto": { "type": "http", "url": "https://mcp.katto.tech/mcp" }
  }
}

Windsurf

Open Settings → Cascade → MCP servers → Add server and either paste the hosted URL https://mcp.katto.tech/mcp, or add the same local npx katto-mcpblock as above to Windsurf’s MCP config.

Then just ask

Clip the 3 best moments from
https://www.youtube.com/watch?v=… into 9:16 with
word-timed captions, then give me the download links.

The agent calls katto_create_clip_job, polls until it’s done, and returns the MP4 + caption URLs. Every tool is documented on the tools reference. One clip job uses 1 video from your monthly quota (25 on Creator, 2 on Free); re-renders and dubs are free.

Troubleshooting