Cospark MCP

Create end-to-end AI video ads from chat.

Turn a script and product media into UGC hooks, talking-head bodies, voiceover, and an editable timeline from ChatGPT, Codex, Claude, or your own agent.

https://api.cospark.so/api/mcp/cospark

Streamable HTTP + OAuth. No API keys. Read the docs.

cospark · mcp

Make a 9:16 UGC ad for the cold brew launch and put it on the timeline.

  • list_voices24 voices
  • generate_ugc_videorun_8f2ac1 · started
  • get_ugc_video_statuscompleted · 00:24
  • edit_timelinerev 7 · 3 items
Works withClaude CodeClaude DesktopCodexCursorWindsurfVS Code

One command, any agent

Paste this into Claude, Codex, Cursor, or any MCP client and it sets itself up.

ask your agent

Add the Cospark MCP server for me: it is a remote Streamable HTTP server at https://api.cospark.so/api/mcp/cospark that authenticates with OAuth. Register it as "cospark", allow a tool timeout of at least 900 seconds, then walk me through signing in.

Add to CursorAdd to VS Code

Add the server, sign in once

Hosted and remote. Nothing to self-host.

Point your client at the Cospark URL and authorize it in the browser. Generations run against your own account, so there are no keys to rotate or share.

Read the docs
terminal
claude mcp add --transport http cospark https://api.cospark.so/api/mcp/cospark

Run /mcp inside Claude Code and pick Cospark to finish the browser sign-in.

Seventeen tools, one account

Everything the Cospark agent uses, exposed to yours.

Generate

Images, video, talking-head UGC, and voiceover from one authenticated server.

  • generate_image

    Generate an image from a prompt.

  • generate_video

    Generate a video from text.

  • generate_video_from_frames

    Animate a starting image, with an optional ending frame.

  • generate_video_with_references

    Guide a video with reference images, video, or audio.

  • generate_ugc_video

    Start a complete 9:16 talking-head ad from a script and character image.

  • generate_voiceover

    Create narrated audio with duration and timestamped segments.

  • list_voices

    List voice IDs with tone, accent, and sex.

Track and import

Long renders return a run ID immediately, so your agent never blocks on a poll.

  • get_video_generation_status

    Poll a video run until it completes or fails.

  • get_ugc_video_status

    Poll a talking-head run until the reviewed final cut is ready.

  • inspect_media

    Read duration, transcript, scenes, silences, and contact-sheet frames.

  • upload_media

    Import a public URL, or get a signed upload for a local file up to 100 MB.

Workspaces and timeline

The same editor your team uses, driven by tool calls instead of a cursor.

  • list_projects

    List projects a workspace can attach to.

  • create_workspace

    Create an editable workspace and return its session ID and chat URL.

  • list_workspaces

    Page through recent workspaces, 10 at a time.

  • read_timeline

    Read current tracks, items, and revision.

  • compose_timeline

    Build a multi-track video, image, and audio cut.

  • edit_timeline

    Add, remove, move, trim, or split items by ID.

Ask for the ad, get the file

Long renders hand back a run ID instantly.

Create a realistic creator for my cold brew brand, then turn them into a talking-head UGC ad using my script.

  • generate_image
  • generate_ugc_video
  • get_ugc_video_status

Use these photos of my creator and cold brew product to make a natural 9:16 product video.

  • upload_media
  • generate_video_with_references
  • get_video_generation_status

Analyze this video and tell me what happens, what is said, and where each scene changes.

  • upload_media
  • inspect_media

Turn this product photo into a polished six-second vertical video ad.

  • upload_media
  • generate_video_from_frames
  • get_video_generation_status

Create three short UGC hook variations from this starting frame, each with a different opening line.

  • generate_video_from_frames
  • get_video_generation_status
  • inspect_media

Questions and answers

The details worth knowing before you connect.

Ready to turn your next product into ads ready to test?

Start with one product or brief. Cospark turns it into a complete, editable campaign you can launch, learn from, and iterate on.