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.

ToolForDoes
edit_videoMakeEdit your footage with the full brief, or cut clips from a long recording.
create_videoMakeMake a faceless video from an idea or a script.
create_videosMakeMake up to 10 faceless videos at once.
plan_contentMakeWrite a month of video ideas. Makes nothing yet.
edit_content_planMakeChange, move or drop ideas.
approve_planMakeMake the ideas you approved. They post on their days.
post_content_planPostPost ready videos after you connect an account.
get_content_planMakeSee a content calendar and how far each video got.
browse_stylesMakeShow editing styles.
copy_styleMakeMake a style from a reference video.
adjust_styleMakeChange a saved style in plain words.
import_assetMakeBring in an image, a logo or a song: attached, or by link.
list_assetsMakeList your pictures, clips and songs.
save_clipMakeKeep a clip to use as an intro or an insert.
check_videoWatchSee progress, or the finished video.
list_videosWatchList recent videos.
get_video_activityWatchWatch the editor work, step by step.
get_project_contextWatchRead scenes, captions and versions.
get_threadWatchRead every change made to a video.
list_versionsWatchList versions and which one is live.
revise_videoChangeAsk for a change in words.
remove_sceneChangeRemove a scene. Uses the direct-edit allowance.
remove_scene_layerChangeRemove a scene layer. Uses the direct-edit allowance.
replace_scene_screenChangeReplace scene graphics. Uses the direct-edit allowance.
set_scene_textChangeChange scene text. Uses the direct-edit allowance.
swap_scene_pictureChangeSwap a scene picture. Uses the direct-edit allowance.
move_sceneChangeChange scene timing. Uses the direct-edit allowance.
add_sceneChangeAdd a scene. Uses the direct-edit allowance.
cut_video_wordsChangeCut footage by words. Uses the direct-edit allowance.
set_word_emphasisChangeChange word emphasis. Uses the direct-edit allowance.
set_caption_styleChangeStyle captions. Uses the direct-edit allowance.
set_video_musicChangeChange video music. Uses the direct-edit allowance.
set_video_sound_effectsChangeChange sound effects. Uses the direct-edit allowance.
set_scene_soundsChangeChange scene sound cues. Uses the direct-edit allowance.
set_output_frameChangeChange video shape. Uses the direct-edit allowance.
put_video_overlayChangeAdd or update an overlay. Uses the direct-edit allowance.
remove_video_overlayChangeRemove an overlay. Uses the direct-edit allowance.
set_element_layoutChangeMove or resize an element. Uses the direct-edit allowance.
set_element_contentChangeChange an element. Uses the direct-edit allowance.
fix_captionsChangeFix caption words and names. Free.
restore_versionChangeUndo: bring back an earlier version.
cancel_jobChangeStop a running edit, change, style copy or upload.
get_selectionWatchSee what is open and selected in Clypmint.
start_videoMakeStart a blank video with no footage. Free.
open_canvasWatchShow the canvas in the conversation: your videos, or one with its timeline.
finish_workingChangeSay you are done: clears your label and gives the link.
canvas_liveWatchThe canvas app keeps itself up to date.
canvas_selectWatchThe canvas app reports what is selected.
get_basic_infoWatchRead a video: shape, length, frame rate, version.
get_timelineWatchRead every layer and overlay with its times.
get_projectWatchRead the whole project as JSON and everything the renderer can draw. Free.
get_transcriptWatchRead every spoken word with its number and seconds.
get_screenshotWatchLook at frames of the video as it is saved.
get_guideWatchRead how to edit on the canvas, and our editors' craft.
get_font_family_infoWatchList the fonts captions, overlays and graphics can use.
search_soundsWatchSearch the sound effect library by meaning.
find_brollMakeFind b-roll pictures and clips with a license; $0.02 a search.
import_mediaMakeBring in a picture, clip or song from a link.
import_fontMakeKeep a brand or open-catalog font for this account, to set graphics in.
put_overlayChangeAdd or replace text, a picture or a clip on the video. Free.
measure_motionWatchTime a move frame by frame and name its ease, to borrow it from a clip.
write_graphicChangeAdd or change a motion graphic, with real eases, or compare options side by side. Free.
apply_documentChangeChange anything in the project with a JSON patch. Free.
update_layerChangeMove, restyle, retime or swap a layer. Free.
delete_layerChangeRemove an overlay or hide a layer. Free.
cutChangeTake time out by seconds or words. Free.
set_captionsChangeChange the captions and their key words. Free.
set_audioChangeMusic, an exact sound effect, the footage sound. Free.
add_voiceoverChangeA narrator reads a script at a second, its words timed; by the voice-over minute.
set_lookChangeGrade, camera, shape and speaker cut-out. Free.
add_clipChangePut another video in with its own sound. Free.
exchange_projectChangeImport an After Effects comp or export Premiere, After Effects, and a portable project. Free.
project_notesChangeList pinned notes and mark one with a reply. Free.
rememberRememberKeep a preference for every later video.
list_memoryRememberSee what Clypmint remembers.
forgetRememberForget one preference.
get_social_accountsPostSee connected social accounts.
connect_social_accountsPostGet a link to connect accounts.
upload_for_postPostGet a link to upload a finished video to post.
schedule_postPostSchedule one video, or an Instagram trial reel.
schedule_planPostCheck, then schedule, many posts.
list_postsPostShow the content calendar.
update_postPostChange a scheduled post.
cancel_postPostCancel a scheduled post.
get_account_identityAccountIdentify the signed-in account for linking; no usage fields.
get_profileAccountSee the account and credits left.
get_workflowWatchRead 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.

MethodPathDoes
GET/meThe account and credits left.
POST/jobs/cancelStop a running edit, change, style copy or upload.
GET/stylesList styles.
POST/stylesCopy a style.
GET/videosList videos.
POST/videosStart an edit with the full brief. Gives an upload link when needed.
POST/videos/from-wordsMake a faceless video.
POST/videos/batchMake up to 10 faceless videos.
GET/videos/{id}Get one video.
GET/videos/{id}/activityWatch the editor work.
GET/videos/{id}/contextScenes, captions and versions.
GET/videos/{id}/threadEvery change made.
GET/videos/{id}/versionsList versions.
POST/videos/{id}/versions/{version_id}/restoreBring back a version.
POST/videos/{id}/outputs/{output_id}/assetKeep a clip to use in other videos.
POST/videos/{id}/changesAsk for a change in words.
POST/videos/{id}/editsChange scenes directly.
POST/videos/{id}/captionsFix captions.
GET/assetsList your media.
GET/memoryWhat Clypmint remembers.
POST/memoryRemember a preference.
DELETE/memory/{id}Forget one.
POST/content-plansWrite a month of ideas.
GET/content-plans/{id}See a content calendar.
POST/content-plans/{id}/itemsChange, move or drop ideas.
POST/content-plans/{id}/approveMake the approved ideas.
POST/content-plans/{id}/postPost the ready videos.
POST/scheduleCheck, then schedule, many posts.
GET/social/accountsYour connected social accounts.
POST/social/connectA link to connect an account.
POST/mediaAn upload link for a finished video to post.
POST/postsSchedule one post, or an Instagram trial reel.
GET/postsYour 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.jsonRead 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.