MCP tools
The 31 tools on OpenClip's full MCP server and the 10-tool ChatGPT app scope.
The full OpenClip MCP server exposes 31 tools. This page is an overview so you know what is there. The canonical, always-current parameter reference is the skill bundle at https://openclip.app/mcp/skill (its SKILL.md and reference.md) and the machine-readable page at https://openclip.app/mcp.md. Those files are kept in lockstep with the server by CI; this page deliberately does not duplicate their parameter-level detail.
Not set up yet? Start at Connect over MCP.
Endpoint scope
| Endpoint | Authentication | Tools |
|---|---|---|
https://openclip.app/mcp | OAuth | Full 31-tool server |
https://openclip.app/mcp/key | Bearer token | Full 31-tool server |
https://openclip.app/mcp/app | OAuth | Curated 10-tool ChatGPT app |
The ChatGPT app exposes get_account, submit_video, list_videos, get_video_status, get_render_status, list_clips, render_clip, list_caption_presets, list_supported_providers, and get_transcript. The sections below describe the full 31-tool server.
Clipping pipeline
The paid core flow: submit a long video, poll until processed, read the ranked Viral Moments, render captioned clips.
| Tool | What it does |
|---|---|
submit_video | Submit a source video URL (YouTube, Vimeo, Google Drive, Dropbox, OneDrive, and more) to start clip detection |
get_video_status | Poll one video's processing status until it completes or fails |
list_clips | List a video's detected Viral Moments: hook, virality score, timestamps, clip URLs |
render_clip | Produce a final captioned render of one Viral Moment |
get_render_status | Check the render state of a video's Viral Moments |
list_caption_presets | List the caption style presets available for rendering |
get_transcript | Get a processed video's time-coded transcript, sliceable by millisecond window |
list_supported_providers | List the video sources submit_video accepts |
list_videos | List the team's videos, most recent first |
Uploads
| Tool | What it does |
|---|---|
create_upload | Start an upload of a local file; returns a presigned URL you PUT the bytes to |
complete_upload | Finish an upload and start the paid clipping pipeline (skip this for free tools) |
Free media utilities
These need an account but no subscription. All are async: they return a tool_job id you poll.
| Tool | What it does |
|---|---|
transcribe | Transcribe an uploaded video into time-coded text with JSON, SRT, and VTT downloads |
edit_video | Crop, trim, rotate, resize, compress, or mute an uploaded video |
convert_media | Convert an uploaded file to another video container, a GIF, or an audio format |
extract_thumbnails | Extract evenly spaced thumbnail frames from an uploaded video |
edit_image | Compress, resize, or crop an uploaded image |
remove_background | Remove an image's background and return a transparent PNG |
get_tool_job_status | Poll a free tool job until it completes or fails |
UGC generation
| Tool | What it does |
|---|---|
generate_ugc | Generate a short vertical UGC-style video from a creative brief |
get_ugc_job_status | Poll a UGC generation job for its status and final clip URL |
list_ugc_creators | List the UGC spokespersons available to your team, grouped by niche |
list_ugc_jobs | List the team's UGC generation jobs, most recent first |
Account and presets
| Tool | What it does |
|---|---|
get_account | Return the connected account: identity, team, and remaining credits |
get_usage | Return the team's credit balance and recent usage history |
list_agents | List the team's saved processing agents and caption presets |
create_agent | Create a processing agent for the team |
update_agent | Update one of the team's agents |
describe_agent_settings | Describe every nested agent setting, its type, and allowed values |
create_agent_logo_upload | Start uploading a logo image for an agent's watermark |
set_agent_logo | Finish setting an agent's logo after the upload |
Documentation
| Tool | What it does |
|---|---|
search_docs | Search this documentation and return the most relevant pages with excerpts |
How the tools behave
Three patterns show up everywhere:
- Poll, don't wait. Long jobs (
submit_video,render_clip, free tools, UGC) return an id immediately; poll the matching status tool until the state is terminal. - Ids are opaque hashids. Pass them back exactly as returned.
- Times are milliseconds across clips and transcripts, so a clip's window slots straight into
get_transcript.