AI agents (MCP) Cursor
Motion Text in Cursor
Add one MCP entry and Cursor's agent drafts real videos you finish in the Motion Text editor.
Cursor reads MCP servers from a small JSON file, so adding Motion Text is a three-line entry, with no extension to install. In Agent mode, Cursor can then call the tools to build a paced, captioned video from your words and reply with a link that opens the full editor, timeline and all.
Scope it however suits you: a .cursor/mcp.json in the project keeps the connector with a specific repo, while ~/.cursor/mcp.json makes it available everywhere. Anonymous drafting needs no key. Point Cursor at the studio endpoint when you want it working on your saved projects.
Connect Cursor
Add to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):
{
"mcpServers": {
"motion-text": { "url": "https://motiontext.video/mcp" }
}
}Save the JSON to .cursor/mcp.json in your project, or ~/.cursor/mcp.json for every project. Cursor lists connected servers under Settings → MCP with a green dot when the handshake succeeds; reload the window after editing the file.
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 Cursor 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 Cursor and you will have an edit link back in a few seconds.
Use the Motion Text tools to draft a 20-second vertical video announcing this feature. Pull the copy from the changelog entry I just wrote, keep it punchy, three scenes, and give me the edit link.
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 Cursor 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
- Put the assistant in Agent (not Ask) mode; tool calls only fire there.
- If the server shows red, reload the window; Cursor reads the JSON at startup.
- Swap in the studio endpoint URL to work on your own workspace projects.
Questions
Which file does Cursor read?
.cursor/mcp.json in the project root, or ~/.cursor/mcp.json globally. Both use the same mcpServers shape.
Why isn't the agent calling the tools?
Make sure you're in Agent mode and the server shows connected under Settings → MCP. A window reload picks up config changes.
Do I need Cursor Pro?
No, MCP works on any Cursor plan. Motion Text's own Pro features (server renders) are separate, tied to your Motion Text account via the studio endpoint.