Clypmint for developers
Run a whole video account from a chat or your code. Make, change, clip, fix and schedule.
MCP server
https://clypmint.com/mcp
It uses Streamable HTTP and OAuth 2.1 sign-in. 87 tools. Each one that spends says its credit cost, and takes dry_run: true to price a request first.
| Tool | For | Does |
|---|---|---|
edit_video | Make | Edit your footage with the full brief, or cut clips from a long recording. |
create_video | Make | Make a faceless video from an idea or a script. |
create_videos | Make | Make up to 10 faceless videos at once. |
plan_content | Make | Write a month of video ideas. Makes nothing yet. |
edit_content_plan | Make | Change, move or drop ideas. |
approve_plan | Make | Make the ideas you approved. They post on their days. |
post_content_plan | Post | Post ready videos after you connect an account. |
get_content_plan | Make | See a content calendar and how far each video got. |
browse_styles | Make | Show editing styles. |
copy_style | Make | Make a style from a reference video. |
adjust_style | Make | Change a saved style in plain words. |
import_asset | Make | Bring in an image, a logo or a song: attached, or by link. |
list_assets | Make | List your pictures, clips and songs. |
save_clip | Make | Keep a clip to use as an intro or an insert. |
check_video | Watch | See progress, or the finished video. |
list_videos | Watch | List recent videos. |
get_video_activity | Watch | Watch the editor work, step by step. |
get_project_context | Watch | Read scenes, captions and versions. |
get_thread | Watch | Read every change made to a video. |
list_versions | Watch | List versions and which one is live. |
revise_video | Change | Ask for a change in words. |
remove_scene | Change | Remove a scene. Uses the direct-edit allowance. |
remove_scene_layer | Change | Remove a scene layer. Uses the direct-edit allowance. |
replace_scene_screen | Change | Replace scene graphics. Uses the direct-edit allowance. |
set_scene_text | Change | Change scene text. Uses the direct-edit allowance. |
swap_scene_picture | Change | Swap a scene picture. Uses the direct-edit allowance. |
move_scene | Change | Change scene timing. Uses the direct-edit allowance. |
add_scene | Change | Add a scene. Uses the direct-edit allowance. |
cut_video_words | Change | Cut footage by words. Uses the direct-edit allowance. |
set_word_emphasis | Change | Change word emphasis. Uses the direct-edit allowance. |
set_caption_style | Change | Style captions. Uses the direct-edit allowance. |
set_video_music | Change | Change video music. Uses the direct-edit allowance. |
set_video_sound_effects | Change | Change sound effects. Uses the direct-edit allowance. |
set_scene_sounds | Change | Change scene sound cues. Uses the direct-edit allowance. |
set_output_frame | Change | Change video shape. Uses the direct-edit allowance. |
put_video_overlay | Change | Add or update an overlay. Uses the direct-edit allowance. |
remove_video_overlay | Change | Remove an overlay. Uses the direct-edit allowance. |
set_element_layout | Change | Move or resize an element. Uses the direct-edit allowance. |
set_element_content | Change | Change an element. Uses the direct-edit allowance. |
fix_captions | Change | Fix caption words and names. Free. |
restore_version | Change | Undo: bring back an earlier version. |
cancel_job | Change | Stop a running edit, change, style copy or upload. |
get_selection | Watch | See what is open and selected in Clypmint. |
start_video | Make | Start a blank video with no footage. Free. |
open_canvas | Watch | Show the canvas in the conversation: your videos, or one with its timeline. |
finish_working | Change | Say you are done: clears your label and gives the link. |
canvas_live | Watch | The canvas app keeps itself up to date. |
canvas_select | Watch | The canvas app reports what is selected. |
get_basic_info | Watch | Read a video: shape, length, frame rate, version. |
get_timeline | Watch | Read every layer and overlay with its times. |
get_project | Watch | Read the whole project as JSON and everything the renderer can draw. Free. |
get_transcript | Watch | Read every spoken word with its number and seconds. |
get_screenshot | Watch | Look at frames of the video as it is saved. |
get_guide | Watch | Read how to edit on the canvas, and our editors' craft. |
get_font_family_info | Watch | List the fonts captions, overlays and graphics can use. |
search_sounds | Watch | Search the sound effect library by meaning. |
find_broll | Make | Find b-roll pictures and clips with a license; $0.02 a search. |
import_media | Make | Bring in a picture, clip or song from a link. |
import_font | Make | Keep a brand or open-catalog font for this account, to set graphics in. |
put_overlay | Change | Add or replace text, a picture or a clip on the video. Free. |
measure_motion | Watch | Time a move frame by frame and name its ease, to borrow it from a clip. |
write_graphic | Change | Add or change a motion graphic, with real eases, or compare options side by side. Free. |
apply_document | Change | Change anything in the project with a JSON patch. Free. |
update_layer | Change | Move, restyle, retime or swap a layer. Free. |
delete_layer | Change | Remove an overlay or hide a layer. Free. |
cut | Change | Take time out by seconds or words. Free. |
set_captions | Change | Change the captions and their key words. Free. |
set_audio | Change | Music, an exact sound effect, the footage sound. Free. |
add_voiceover | Change | A narrator reads a script at a second, its words timed; by the voice-over minute. |
set_look | Change | Grade, camera, shape and speaker cut-out. Free. |
add_clip | Change | Put another video in with its own sound. Free. |
exchange_project | Change | Import an After Effects comp or export Premiere, After Effects, and a portable project. Free. |
project_notes | Change | List pinned notes and mark one with a reply. Free. |
remember | Remember | Keep a preference for every later video. |
list_memory | Remember | See what Clypmint remembers. |
forget | Remember | Forget one preference. |
get_social_accounts | Post | See connected social accounts. |
connect_social_accounts | Post | Get a link to connect accounts. |
upload_for_post | Post | Get a link to upload a finished video to post. |
schedule_post | Post | Schedule one video, or an Instagram trial reel. |
schedule_plan | Post | Check, then schedule, many posts. |
list_posts | Post | Show the content calendar. |
update_post | Post | Change a scheduled post. |
cancel_post | Post | Cancel a scheduled post. |
get_account_identity | Account | Identify the signed-in account for linking; no usage fields. |
get_profile | Account | See the account and credits left. |
get_workflow | Watch | Read current editing, music, styles and host integration guidance. |
Recipes
A month of faceless posts. plan_content writes the ideas. You pick. approve_plan makes them and posts each on its day.
Clip a podcast. edit_video with clips: { count: 'all', shape: '9:16' }. Then schedule_plan.
An ad with 3 hooks. edit_video with purpose: 'ad', hooks: 3. Change one opening with revise_video and its output_id.
Fix a name. fix_captions with replace: [{ heard, spelled }]. Then remember, so every next video gets it right.
Safe requests and retries
For every tool that makes or changes something, supply a stable operation_id. Keep it unchanged when retrying the same request; use a new ID for a deliberate new operation. Reusing an ID with different instructions is refused. create_videos makes each item once, as operation_id.1, .2 and on.
A revision can include base_version from check_video. Its original version remains pinned during retries. Progress reads never start another job.
edit_video takes the full brief: purpose, hooks, shorts (or 'all'), formats, sound_effects, speaker_name, instructions up to 8,000 characters, or clips for a long recording. A wrong field is answered with its name and the reason. Video links stay in private widget metadata; ask check_video for a download with with_download: true.
Scheduling never happens on its own: schedule_plan checks with approve: false, and schedules only with approve: true and the publishing permission. When an account is out of credits, the answer is a 402 with a link to add more.
Connect from ChatGPT. MCP authorization is available through OAuth; development setup depends on the features enabled in your ChatGPT workspace.
REST API
Base URL: https://clypmint.com/api/v1
Create a cm_live_... API key in Studio settings. Send it as a bearer token. A key can edit videos and post to the accounts you connect. See the OpenAPI file for request and response shapes.
| Method | Path | Does |
|---|---|---|
| GET | /me | The account and credits left. |
| POST | /jobs/cancel | Stop a running edit, change, style copy or upload. |
| GET | /styles | List styles. |
| POST | /styles | Copy a style. |
| GET | /videos | List videos. |
| POST | /videos | Start an edit with the full brief. Gives an upload link when needed. |
| POST | /videos/from-words | Make a faceless video. |
| POST | /videos/batch | Make up to 10 faceless videos. |
| GET | /videos/{id} | Get one video. |
| GET | /videos/{id}/activity | Watch the editor work. |
| GET | /videos/{id}/context | Scenes, captions and versions. |
| GET | /videos/{id}/thread | Every change made. |
| GET | /videos/{id}/versions | List versions. |
| POST | /videos/{id}/versions/{version_id}/restore | Bring back a version. |
| POST | /videos/{id}/outputs/{output_id}/asset | Keep a clip to use in other videos. |
| POST | /videos/{id}/changes | Ask for a change in words. |
| POST | /videos/{id}/edits | Change scenes directly. |
| POST | /videos/{id}/captions | Fix captions. |
| GET | /assets | List your media. |
| GET | /memory | What Clypmint remembers. |
| POST | /memory | Remember a preference. |
| DELETE | /memory/{id} | Forget one. |
| POST | /content-plans | Write a month of ideas. |
| GET | /content-plans/{id} | See a content calendar. |
| POST | /content-plans/{id}/items | Change, move or drop ideas. |
| POST | /content-plans/{id}/approve | Make the approved ideas. |
| POST | /content-plans/{id}/post | Post the ready videos. |
| POST | /schedule | Check, then schedule, many posts. |
| GET | /social/accounts | Your connected social accounts. |
| POST | /social/connect | A link to connect an account. |
| POST | /media | An upload link for a finished video to post. |
| POST | /posts | Schedule one post, or an Instagram trial reel. |
| GET | /posts | Your posts and what happened to each. |
| PATCH | /posts/{id} | Change a post’s caption or time. |
| DELETE | /posts/{id} | Cancel a scheduled post. |
| GET | /openapi.json | Read the OpenAPI file. |
Two requests
List styles
curl https://clypmint.com/api/v1/styles \
-H 'Authorization: Bearer cm_live_...'Start an ad edit
curl -X POST https://clypmint.com/api/v1/videos \
-H 'Authorization: Bearer cm_live_...' \
-H 'Content-Type: application/json' \
--data '{"purpose":"ad","hooks":3,"formats":["9:16","1:1"],"instructions":"Cut the pauses. Lead with the price."}'The response includes a private upload link when Clypmint needs the video file.
Make a week of faceless videos
curl -X POST https://clypmint.com/api/v1/videos/batch \
-H 'Authorization: Bearer cm_live_...' \
-H 'Content-Type: application/json' \
--data '{"operation_id":"week-42","defaults":{"seconds":30,"voice":"liam"},"items":[{"idea":"3 habits that save an hour"},{"idea":"Why budgets fail"}],"dry_run":true}'With dry_run it answers the credits and starts nothing. Send it again without dry_run to make them.
Post a trial reel
Instagram shows a trial reel only to people who do not follow you. With graduation: auto, Instagram shares it to your followers if it does well. It needs an Instagram Business or Creator account.
curl -X POST https://clypmint.com/api/v1/media -H 'Authorization: Bearer cm_live_...' -H 'Content-Type: application/json' --data '{"content_type":"video/mp4","bytes":48000000}'
curl -X PUT -H 'Content-Type: video/mp4' --upload-file reel.mp4 '<upload_url>'
curl -X POST https://clypmint.com/api/v1/posts -H 'Authorization: Bearer cm_live_...' -H 'Content-Type: application/json' --data '{"mediaId":"<media_id>","platforms":["INSTAGRAM"],"platformOptions":{"INSTAGRAM":{"trial":true,"graduation":"auto"}},"caption":"Three rules for a better hook","postAt":"2026-11-08T17:00:00-06:00","timezone":"America/Chicago","operationId":"trial-1"}'A Clypmint video posts the same way with videoId, outputId and expectedEditId. A public link to the file works as mediaUrl.
ChatGPT and Claude
The same server works inside both. Read Clypmint in ChatGPT and Clypmint in Claude for the steps.
In Claude Code, with an API key:
claude mcp add --transport http clypmint https://clypmint.com/mcp --header "Authorization: Bearer cm_live_YOUR_KEY"Just need footage? The B-Roll API
A separate API with its own key and its own prices. Real photos and footage of exactly what a script names, checked and licensed, for any agent. REST and MCP. The first 100 searches are free, then you pay per search. Read the B-Roll API docs or try it.