FlowHalo logoFlowHalo
MCP server

Clip videos from your favourite AI agent.

FlowHalo speaks the Model Context Protocol. Connect it to Claude, ChatGPT, Cursor or any MCP client and run your clipping workflow in plain English. Included on every plan.

Get started Setup guide

Server URL

https://flowhalo.ai/api/mcp

Ask for clips the way you would ask an editor.

Your agent can start projects, wait for processing, read the ranked clips, change caption styles and export finished videos. Anything that spends credits waits for your yes: the tool only reports the cost and your balance until it is called with confirm set to true.

  • “Clip this YouTube link into 10 shorts under 60 seconds.”
  • “Show me the five clips with the highest virality score and their hooks.”
  • “Switch every clip in this project to the Box caption style.”
  • “Find the moment where we talk about pricing and make it a clip.”
  • “Export the top three clips in 9:16 and give me the download links.”

Set up in under a minute

Claude

  1. 1Open Settings, then Connectors, then Add custom connector.
  2. 2Paste https://flowhalo.ai/api/mcp as the server URL.
  3. 3Sign in to FlowHalo and approve access.

ChatGPT

  1. 1Open Settings, then Apps and Connectors, then Create.
  2. 2Use https://flowhalo.ai/api/mcp with OAuth authentication.
  3. 3Sign in to FlowHalo and approve access.

Cursor

  1. 1Open Cursor Settings, then MCP, then Add new server.
  2. 2Add an HTTP server with the URL https://flowhalo.ai/api/mcp.
  3. 3Sign in when prompted, or add an API key header.
Claude Code
claude mcp add --transport http flowhalo https://flowhalo.ai/api/mcp

What your agent can do

flowhalo_get_context

Your plan, credits, brand kits and the caption style ids.

flowhalo_create_project

Start clipping a video from a YouTube, Vimeo, Twitch or Loom link. Nothing is spent until you say yes.

flowhalo_prepare_upload

Send a video file from your computer when it has no public link.

flowhalo_get_project

A project's status and progress while it is being processed.

flowhalo_list_clips

Ranked clips with scores, hooks, transcripts and thumbnail links.

flowhalo_find_moments

Search the transcript for where something was said.

flowhalo_clip_moment

Make a new clip from any time range of the video.

flowhalo_update_clip

Change a clip's caption style, aspect ratio, layout, title, hook or start and end.

flowhalo_ask_editor

Edit a clip in plain words, such as cutting the pauses or adding a headline.

flowhalo_export_clip

Render a clip to MP4. flowhalo_get_export returns the download link.

Secure by default

Connect with OAuth and approve access on a FlowHalo consent screen. Your agent only sees your own account, and every action follows the same plan limits as the dashboard.

API keys for your own code

Prefer scripts or automations? Create an API key in Settings and call the same tools over REST: send a POST to /api/v1/tools/<tool_name>with a JSON body of the tool's arguments and the key as a Bearer token. GET /api/v1/tools lists every tool, and the OpenAPI document at /api/v1/openapi.json is there for code generation.

REST
curl -X POST https://flowhalo.ai/api/v1/tools/flowhalo_list_projects \ -H "Authorization: Bearer $FLOWHALO_API_KEY" \ -H "Content-Type: application/json" \ -d '{"limit":5}'