AI agents (MCP) Windsurf
Motion Text in Windsurf
Point Windsurf's Cascade at one MCP URL and it drafts real, editable videos.
Windsurf's Cascade agent supports MCP servers through its own config file. Add Motion Text under mcpServers using the serverUrl key Windsurf uses for remote servers, or add it from Cascade's Manage MCPs panel. Cascade can then build a video from your prompt and return an edit link.
Drafting is anonymous and instant. When you want Cascade working on your own saved projects (and, on Pro, real server renders), swap in the studio endpoint and sign in when prompted.
Connect Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"motion-text": { "serverUrl": "https://motiontext.video/mcp" }
}
}Edit ~/.codeium/windsurf/mcp_config.json, or use Cascade → Manage MCPs → Add. Windsurf remote servers use serverUrl (not url). Refresh the MCP list after editing.
That's the anonymous endpoint: drafting only, no account. For the full toolset on your own projects (and, on Pro, 1080p/4K server renders), use the studio endpoint https://motiontext.video/mcp/studio and sign in when Windsurf prompts you. Details on the main MCP page.
Your first prompt
Connected but staring at a blank prompt is where most people abandon an MCP server. Paste this into Windsurf and you will have an edit link back in a few seconds.
Draft a 25-second portrait lyric video from these lyrics with karaoke highlights and a neon look, then give me the edit link: Static on the radio Halfway to nowhere And the lights come up
Swap in your own words and change the length, format, or mood. Line breaks are load-bearing: the Director paces scenes and captions from them, so one beat per line gives it a rhythm to work with where a paragraph makes it guess.
What Windsurf can and cannot make
| What that means here | |
|---|---|
| Structure | Scenes, pacing, timed captions, text edits and deletions, visual presets, format, duration, layout validation. |
| Drafts | A complete project behind an edit link. Anonymous drafts last 30 days; save one to keep it. |
| Renders (Pro) | Signed in, it queues a real 1080p or 4K server render and polls the job to a download link. |
| Not media | Your audio, your photos, and AI imagery are added in the editor — never pulled in on your behalf. |
| Not sight | It cannot watch what it made. That is precisely why it hands you a link instead of a file. |
Good to know
- Windsurf uses
serverUrlfor remote HTTP servers, which is the most common gotcha coming from other clients. - Hit the refresh icon in the MCP panel after editing the JSON.
- The studio endpoint unlocks your own projects and Pro server renders.
Questions
Is the config key url or serverUrl?
Windsurf uses serverUrl for remote MCP servers. Using url is the most common reason a Windsurf connection fails to appear.
Where's the config file?
~/.codeium/windsurf/mcp_config.json, or add it through Cascade's Manage MCPs panel.
Is there a tool limit?
Windsurf caps active MCP tools; Motion Text's set fits comfortably, but disable unused servers if you hit the limit.