MCP server
MakeRoll inside your AI assistant.
Connect your MakeRoll account to ChatGPT, Claude, Claude Code or Cursor and ask it to import a video, pick the clips, export them and schedule the posts. It works on every plan, the free one included.
Server address
https://makeroll.app/api/mcpStreamable HTTP with OAuth sign-in. Paste it into your client, sign in with your MakeRoll account, click Allow.
Things you can ask
“Import this podcast episode and tell me when the clips are ready.”
“Show me the five best clips, export the top two and give me a link I can send to a friend.”
“Find clips about pricing in the last video I imported.”
Connect it
ChatGPT
- In Settings, open Connectors and turn on Developer mode.
- Create a connector with the server address above and keep authentication on OAuth.
- Sign in to MakeRoll when asked, click Allow, then mention MakeRoll in a chat.
Claude (web and desktop)
- Open Settings, then Connectors, and add a custom connector.
- Paste the server address and confirm.
- Sign in to MakeRoll, click Allow, then enable the connector in a conversation.
Claude Code
- Run the command below in a terminal.
- Type /mcp and pick MakeRoll to sign in.
- Ask it to import a file: this client can upload local videos.
claude mcp add --transport http makeroll https://makeroll.app/api/mcpCursor
- Add the entry below to your mcp.json, global or per project.
- Open the MCP settings and click the sign-in link next to MakeRoll.
- Allow the connection, then use the tools from the chat.
{
"mcpServers": {
"makeroll": {
"url": "https://makeroll.app/api/mcp"
}
}
}What the assistant can do
27 tools, each one a step of the normal MakeRoll workflow. The assistant reads the same account you see in the app, and every limit of your plan applies exactly as it does there.
| Tool | What it does | Kind |
|---|---|---|
| get_account | Your plan, the minutes left this month and the limits. | reads |
| open_clip_panel | Show a video's progress, then its best clips as numbered cards you can export, inside the conversation. | reads |
| import_url | Import a video link (YouTube, Loom, Google Drive, Dropbox or a direct file) and start transcription and clip finding. | acts |
| create_upload | Start a local file upload: a link to send the bytes to. | acts |
| confirm_upload | Finish the upload and start the analysis. | acts |
| list_videos | Your videos with their processing status and clip counts. | reads |
| get_video | One video's progress, ready or not, and its refine allowance. | reads |
| get_transcript | The transcript with timestamps, by time window. | reads |
| list_clips | The AI-found clips, best score first, with hook and headline. | reads |
| get_clip | One clip in detail, with its score breakdown and its poster image shown in the chat. | acts |
| create_clip | Cut a clip from words you quote or a range in seconds, snapped to pauses and scene cuts. | acts |
| retime_clip | Move the start or end of a clip, keeping the edits inside it; the moved edge snaps to a pause or scene cut. | acts |
| set_clip_hook | Rewrite a clip’s hook, the headline shown on screen: punchier, shorter, translated. The look stays the template’s. | acts |
| set_clip_status | Like or dislike a clip, like the thumbs in the app. | acts |
| find_clips | Run the clip finder again with a focus prompt, a length and a count. | acts |
| list_templates | Your saved templates and the account default. | reads |
| apply_template | Restyle a video's clips with a template. | acts |
| get_brand_kit | Your brand kit: logos, fonts, colours with their roles, and the handle, plus the plan's slot counts. | acts |
| create_template | Save a new template, started from your brand kit when asked: first logo, handle as watermark, your font and primary colour on captions and hook. | acts |
| export_clip | Render a clip to MP4 at up to your plan's resolution. | acts |
| get_export | The export's progress and the download link when done. | acts |
| share_clip | A public, unlisted page to watch an exported clip, with a link that previews when pasted anywhere. | acts |
| unshare_clip | Turn that link off. | acts |
| list_connections | Your connected TikTok, YouTube and Instagram accounts. | reads |
| schedule_post | Publish or schedule a clip to connected accounts. | acts |
| list_posts | Your scheduled and published posts. | reads |
| cancel_post | Cancel a scheduled post before it goes out. | acts |
Same limits as your plan
Imports use your monthly minutes, refines and exports have the same caps, and the export resolution is your plan's. When a limit is reached the assistant is told plainly and stops. Nothing is billed beyond your plan.
You stay in control
The assistant acts as you, through a token that only reaches MakeRoll. You approve each app on a consent screen, and it asks you before it posts to a social account or makes a clip public. You can disconnect it at any time from Settings, Connections. Disconnecting revokes its access immediately.
Questions
Does it cost extra?
No. MCP access is part of every plan, including the free one. You only spend what your plan already includes.
Can ChatGPT upload a file from my computer?
Not yet: ChatGPT cannot send files to a third-party server, so it imports by link: YouTube, Loom, a Google Drive or Dropbox share, or a direct link to a video file. Claude Code and Cursor can upload local files through the create_upload tool.
Is there a REST API?
Not yet. The MCP server is the integration that exists today. A REST API is announced on the Pro plan.
Do I have to wait in the chat while a video is processed?
No. Processing takes a few minutes, and MakeRoll emails you when the clips are ready. Come back to the chat and ask for them, or open the video in the app.
Can I see a clip in the chat?
Yes. The assistant can show a clip’s preview image. Once a clip is exported it can also give you a share link: a public, unlisted page that plays the clip and shows a preview when you paste it in a message. You can turn the link off at any time.