Docs

How ClickPop works

The studio, Vibe Direct, the MCP server and the API, in plain words.

Run ClickPop in Claude

Add a custom connector and sign in. It works on claude.ai, Claude Desktop and the Claude phone app.

https://www.clickpop.ai/api/mcp

How to connect

  1. In Claude, go to Customize → Connectors, press Add, then Custom → Web.
  2. Name it ClickPop, set the URL to https://www.clickpop.ai/api/mcp and press Continue twice.
  3. Choose Sign in now and press Add. Sign in to ClickPop and press Allow. No API key needed.

What it does

ClickPop hosts a remote MCP server at https://www.clickpop.ai/api/mcp. Claude, ChatGPT, Cursor and any MCP client that speaks streamable HTTP can run the studio on your account: the model catalog for video, images, audio and 3D, Vibe Direct and its editor, motion graphics, Character Swap, Film Studio, Productions, Dreamstage, your library, credits, schedules and social posting. The connector is named ClickPop.

Claude, ChatGPT, Claude Code and Cursor connect with a ClickPop sign-in (OAuth 2.1): add the URL, sign in, press Allow. The setup for each app is on the Claude & ChatGPT page. Scripts can use a key from the API keys page instead.

Instagram and the other networks never share a password with the agent. connect_social returns a secure sign-in link; you open it, sign in on the network, and the account comes back to ClickPop.

Spending

Every tool that spends credits takes quote: true (also dry_run or get_cost): it checks the request and returns the price without starting anything. max_credits refuses a job priced above it. An account without a plan gets a plan_required error with an upgrade_url before anything runs. Prices, holds and refunds are the same as in the studio.

Your files come in with media_upload (an upload link to PUT the bytes to, then media_confirm) or media_import_url. Long jobs return a job id: jobs_wait follows any of them, and apps that show tool results as cards render job_display as a live result card.

Vibe Direct from your own agent

An agent can direct Vibe Direct with the same tools and know-how as ClickPop's own: get_workflow_instructions serves the playbook (studio-director) and its craft skills, and every step the in-app agent takes is a tool. creative_intake returns the brief form (format, length, music, voice-over, on-screen text) with its defaults; pass the answers as intake. Or let ClickPop's agent direct with vibe_direct_chat, vibe_direct_answer, vibe_direct_confirm and vibe_direct_watch.

Presets and effects are listed with their ids (get_presets, effects_catalog, find_effects, effect_for) and a short, watermarked preview. Pass the ids to the render tools; the files stay on our side.

API key

Apps that sign in need no key. For scripts and clients without OAuth, send Authorization: Bearer YOUR_API_KEY on every request. x-api-key with the raw key also works. A request with no key returns 401 and points to the sign-in.

Tools

Discovery

Find the right model, preset, look, effect or step-by-step guide before you spend.

  • get_workflow_instructions: Step-by-step guides for multi-step jobs (an ad from your clips, a character swap, a film, a motion graphic). Call with no argument to list them.
  • get_workflow_bundle_file: Read an example file bundled with a guide (a montage edit list, a storyboard, a kinetic plan).
  • models_explore: List, search, inspect or get a recommendation from every model this account can run: video, image, audio and 3D.
  • get_presets: Browse or search every preset: the generation library, colour grades, camera moves, lighting, shot angles, prompt recipes, film looks, ad presets, motion looks, hooks, edit styles, quick starts, code formats, film styles, end cards, Dreamstage paths and looks, viral looks.
  • get_preset_instructions: One preset's full details and which tool and argument applies it.
  • execute_preset (spends credits): Generate from one library preset (its reference stays on our side).
  • find_effects: Search the 9,000+ item effects library: overlays, transitions, textures, Lottie, LUT grades and device mockups.
  • effects_catalog: The whole effects library as pages: ids, tags, length, blend, licence status and a short watermarked preview per item.
  • creative_intake: The Vibe Direct intake form: questions, options and defaults for a brief, to ask your user before a render.
  • effect_for: The right effects, filters and sounds for a treatment (flash, whip, glitch, film grain, reveal...) in one call.
  • shelf_effects: The FX shelf by family: what a picked shelf item is and how to apply it, or a few ready items to offer for a moment.
  • find_sound_effects: Search the sound-effect library: whooshes, risers, impacts, UI clicks and more, free to use.
  • list_formats: Every format the studios make: code video formats, film styles, caption styles, transitions, grades, drama genres.
  • list_voices: Studio voices and the narration catalog, with samples.
  • price_options: A price list for a job, cheapest first, so you can pick a model or offer a cheaper one.
  • list_hooks: Hook Library openers that can be dropped onto a finished clip.

Create

Video, images, audio and 3D on any model in the catalog, one at a time or in batches.

  • generate_video (spends credits): A video from words, a first frame, references or audio on any video model, or Auto.
  • generate_image (spends credits): An image from words or references on any picture model, or Auto.
  • generate_audio (spends credits): Speech, music (Pop Music 01 or catalog models), sound effects or a sound bed for a clip.
  • generate_3d (spends credits): A 3D mesh from a picture or words, on Dreamstage or a catalog 3D model.
  • generate_video_batch (spends credits): Several independent video requests in one call, priced together under one budget.
  • generate_image_batch (spends credits): Several independent image requests in one call, priced together under one budget.
  • generate_audio_batch (spends credits): Several independent audio requests in one call, priced together under one budget.

Jobs

Wait for renders, show results in the chat, cancel what is still running.

  • jobs_wait: Wait up to 15 seconds for up to 12 jobs and return each one's status and result links.
  • job_display: Show one job's progress and result in the chat.
  • show_generation_by_ids: Show a set of finished jobs together as a gallery.
  • show_generations: Show your most recent generations.
  • cancel_job: Cancel a job that is still running. Held credits come back.

Media

Bring your own photos, clips and audio in by upload or link.

  • media_upload: Get an upload link for a photo, clip or audio file (or send small files inline), then confirm it.
  • media_confirm: Finish an upload and get the media id to pass to other tools.
  • media_import_url: Bring a public https image, video or audio file in by its link.
  • show_medias: List the photos, clips and audio files in this studio.
  • media_delete: Delete an uploaded file.
  • media_from_library: Turn a finished library video into a file other tools can edit.

Edit

Upscale, cut out, extend, relight, re-voice, caption or remake what you already have.

  • upscale_image (spends credits): Upscale a picture.
  • remove_background (spends credits): Cut a picture out of its background.
  • outpaint_image (spends credits): Extend a picture past its edges, or to a new aspect ratio.
  • relight_image (spends credits): Relight a picture.
  • erase_object (spends credits): Erase a named thing from a picture.
  • upscale_video (spends credits): Upscale a clip on a catalog upscaler.
  • edit_video (spends credits): An AI edit of your own clip in place: swap a person or product, restyle, change the scene.
  • motion_control (spends credits): A character or still copies the body and camera moves of a reference clip.
  • remake_video (spends credits): Remake your own video shot by shot on our own model, same shots and sound.
  • add_captions (spends credits): Animated word-by-word captions burned onto a clip.
  • voice_change (spends credits): Re-voice an audio file with another voice.
  • dubbing (spends credits): Translate and re-voice the speech of a Vibe Direct cut.
  • video_analysis (spends credits): Watch a clip: its length, sound, every shot with what it shows, and its look.
  • site_facts: Read a product's own website: title, tagline, headings, key copy and colours.

Vibe Direct

Finished ads and promos: kinetic type, beat-cut montages, directed timelines, and the editor.

  • vibe_direct_create (spends credits): Any Vibe Direct promo mode from one brief, the same request the studio and the promo API take.
  • vibe_direct_kinetic (spends credits): A voice-led kinetic-type piece; from a brief alone the kinetic director writes and directs it.
  • vibe_direct_montage (spends credits): A beat-cut montage of your photos and clips under a score made for the cut, with slams and an end card.
  • vibe_direct_directed (spends credits): One timeline mixing footage, kinetic type, motion looks and title cards under one score and one voice.
  • vibe_direct_promo (spends credits): A promo video from a public page and a short line.
  • vibe_direct_chat (spends credits): Talk to ClickPop's own Vibe Direct agent: it plans, asks, renders, reviews and fixes, like the web chat.
  • vibe_direct_answer (spends credits): Answer the agent's question form (the intake or any other question) by option values.
  • vibe_direct_confirm (spends credits): Approve or skip the cards the agent queued, priced on each card.
  • vibe_direct_watch: Follow a thread's renders, the finished links and how each was made; hand results back to the agent.
  • vibe_direct_status: A Vibe Direct piece's progress, its review report and the finished file.
  • vibe_edit_open: Open a production's finished scenes in the Vibe Direct editor.
  • vibe_edit_from_media: Put library videos and uploaded clips on a new Vibe Direct timeline.
  • vibe_edit_get: Read the Vibe Direct timeline: every track and clip.
  • vibe_edit_apply: Edit the timeline: trim, move, split, text, effects, grade, music, undo and redo.
  • vibe_edit_trim_silence (spends credits): Cut the dead air out of the timeline's clips.
  • vibe_edit_remove_fillers (spends credits): Remove um, uh and other filler words.
  • vibe_edit_captions (spends credits): Burned-in captions from what is said in the clips.
  • vibe_edit_highlights (spends credits): Cut long recordings down to their best moments.
  • vibe_edit_voiceover (spends credits): Voice narration onto the timeline.
  • vibe_edit_export (spends credits): Export the timeline to one finished video in the library.
  • vibe_edit_check: Check the last export against what was promised: length, sound, captions, frame.
  • project_get: Open any finished Vibe Direct video as one editable project timeline: layers, who made each, what the creator edited by hand.
  • project_apply_ops: Edit the project with the editor's own ops (undoable, shown in the creator's timeline); hand-edited layers stay as they are.
  • project_diff: What changed in the project: the creator's manual edits since the last agent run, or between two versions.
  • edit_pass: Edit the project like an editor, in passes: rough cut to the action, cuts on the beat, emphasis, captions, transitions by rule, sound, the critic's fixes; every step undoable.
  • apply_edit_ops: Specific timeline edits from the editing vocabulary (ripple, slip, slide, speed ramps, keyframes, J/L cuts, captions, grade...), each with a reason.
  • explain_edit: What the editing agent did and why, step by step.
  • undo_agent_step: Undo one editing-agent step, or all of them; the creator's own edits stay.
  • project_render (spends credits): Re-render the project after edits, redrawing only the changed segments or beats.

Motion graphics

Motion graphics, infographics and code-drawn explainers.

  • motion_graphics_looks: The 21 motion-graphics looks, with what each is for.
  • motion_graphics_preview (spends credits): Draw a start, middle and end still of a motion graphic before it renders.
  • motion_graphics_create (spends credits): A motion graphic rendered in code in one of the looks: titles, data stories, product UI, loops.
  • motion_graphics_explainer (spends credits): A narrated motion-graphics explainer or infographic video from a topic.
  • code_video_create (spends credits): A video drawn in code with a voiceover in any code format (launch promo, app walkthrough, reel...).

Character Swap & characters

Locked characters, character sheets, swaps, recasts and lip sync.

  • character_swap_create (spends credits): Put a character into your clip, replacing a person or thing, keeping the motion, camera and sound.
  • character_sheet_create (spends credits): A character sheet: four views and three expressions in one picture, saved as @Sheet for swaps.
  • list_characters: Your characters and their reference sheets.
  • get_character: One character and its reference sheets.
  • create_character (spends credits): Save an adult character (or a mascot, animal or object), or have one designed.
  • update_character: Update a character you created.
  • lipsync_list_models: Lip Sync models.
  • lipsync_create (spends credits): A talking portrait from a picture and audio, or a clip re-timed to new audio.
  • lipsync_get: One lip sync job.
  • recast_list_models: Swap and reshape engines.
  • recast_create (spends credits): Swap or reshape a clip: a new person or object, or the same people in a new world.
  • recast_get: One recast job.
  • recast_with_character (spends credits): Recast a clip with a saved character.

Film Studio

Storyboards shot by shot with camera, lens and move, then cut into a film.

  • film_studio_storyboard_create (spends credits): A cinematic storyboard of shots from a brief, with a still for each shot.
  • film_studio_storyboard_get: Read a storyboard: shots, stills, selection and render status.
  • film_studio_storyboard_list: List your storyboards.
  • film_studio_shot_edit: Edit a shot's prompt, title, type or selection.
  • film_studio_shot_regenerate (spends credits): Redraw one storyboard still.
  • film_studio_shots_select: Pick which shots will render.
  • film_studio_render (spends credits): Render the selected shots, one clip each.
  • film_studio_shot_library: Browse the cinematic shot reference library.
  • film_studio_cut (spends credits): Cut finished videos together into one film with transitions.
  • cinema_studio_create (spends credits): A Film Studio video with a camera, lens, focal length and aperture.
  • cinema_presets_list: Built-in Film Studio looks and your saved camera presets.
  • cinema_preset_save: Save a Film Studio camera look.

Productions

One brief, every studio, one finished multi-scene film.

  • productions_create (spends credits): Plan a multi-scene film from a brief: concept, cast sheets and every scene.
  • productions_direct (spends credits): Write the shooting script for every planned scene.
  • productions_produce (spends credits): Film every planned scene from its opening frame.
  • productions_attach_scene: Use a finished library video as one of a production's scenes.
  • productions_assemble (spends credits): Cut a production's finished scenes into one film.
  • productions_list: List your productions and their stage.
  • productions_get: Read one production: script, scenes, decisions and cost so far.

Dreamstage 3D

Block out a 3D set from a line, fly the camera, then film it for real.

  • dreamstage_options: Dreamstage camera paths, lengths, looks and prices.
  • dreamstage_draft_scene (spends credits): Block out a living 3D set from one line: actors, crowds, props and a camera move.
  • dreamstage_camera_shot (spends credits): Fly a camera path around one picture.
  • dreamstage_model (spends credits): A 3D mesh from one picture.
  • dreamstage_film (spends credits): Make a saved 3D clip real: film it shot for shot in a chosen look.
  • dreamstage_angles (spends credits): Photoreal frames of a set from up to 6 angles.
  • dreamstage_status: A Dreamstage film's or sequence's progress, or every 3D clip you have.

More studios

Ad Studio, explainers, drama series, copy a reel, worlds.

  • drama_series_create (spends credits): Write a microdrama series: story bible, cast and episode list.
  • drama_list: List your drama series.
  • copy_reel_create (spends credits): Remake a reel's format with your own product and characters.
  • worlds_create (spends credits): Build an explorable world from a line or a picture.
  • worlds_list: List your worlds.
  • create_video (spends credits): Ad Studio: influencer, UGC, ad, brand, faceless and Film Studio videos, with every form choice.
  • list_presenters: UGC presenters (one face in every shot) and cloned products. No credits.
  • create_presenter (spends credits): A reusable UGC presenter from one of your characters. A presenter of your own face needs your consent clip in the app.
  • product_clone (spends credits): Clone a product from 1-5 photos or its page: cut-outs, packshot, 3/4 view, exact label text.
  • ugc_create (spends credits): One UGC ad: presenter on camera, product cutaways, captions, music, end card, labelled AI-generated.
  • ugc_variants (spends credits): An A/B batch of UGC ads: every presenter x every hook.
  • ugc_get: One UGC batch: script, hooks, each variant's video and status.
  • explainer_create (spends credits): Start a 3D Shorts Explainer from a topic (script, then look, then video).
  • explainer_get: A 3D Shorts Explainer project and what needs approval.
  • explainer_edit_beats: Edit, reorder or delete explainer beats before the script is approved.
  • explainer_approve_script (spends credits): Approve the explainer script; reserves keyframe credits.
  • explainer_approve_look (spends credits): Approve the explainer look; reserves video and voice credits.
  • explainer_regenerate_keyframe (spends credits): Redraw one explainer keyframe.

Library & projects

Your videos, files and timeline projects.

  • get_video: One video: status, library status, link, credits held and charged.
  • list_videos: Your library, in the same groups as the library page.
  • add_brand: A brand card on a finished video. No credits.

Account & billing

Plan, credits, what each job cost, and the plans.

  • balance: Plan, credit balance and this period's usage.
  • transactions: What each job held, charged and returned, newest first.
  • show_plans_and_credits: The plans, what each opens, top-ups, and where to subscribe.

Publishing & automations

Connect accounts, post or schedule, and run daily autopilot.

  • post_insights: What is working: top hooks, formats, platforms and the best posting times.
  • score_virality: ClickPop's own 0-100 hook score for a finished video, with a breakdown and fixes. Free; a heuristic, not a view prediction.
  • list_social_accounts: Connected social accounts.
  • connect_social: A secure login link for Instagram, TikTok, YouTube, Facebook, X, LinkedIn, Threads or Pinterest.
  • list_posts: Recent posts and their status.
  • post_video: Post or schedule a ready video to the accounts you pick.
  • list_products: Saved products.
  • list_affiliates: Saved affiliate products.
  • list_automations: Daily schedules.
  • create_automation: A daily schedule that makes and posts a video.
  • update_automation: Change or pause a schedule.
  • delete_automation: Delete a schedule.

Studio agent steps

Every other step ClickPop's in-app agent can take is registered under its own name, schema and price (for example start_explainer, start_music, start_image, save_character, schedule_post, plan_edit, review_edit, stage_craft).

Older names

These still work and run the tool they point to: get_account → balance, list_models → models_explore, recommend_model → models_explore, search_presets → get_presets, get_preset → get_preset_instructions, run_preset → execute_preset, long_format_create → cinema_studio_create, img2vid → generate_video, generate_voiceover → generate_audio, generate_sound_effect → generate_audio, dub_clip → generate_audio, character_sheet → character_sheet_create.

NextAPI →