dev.clipkit/clipkit — MCP Server for Clipkit

The MCP server dev.clipkit/clipkit provides an MCP interface to Clipkit. It is described as a way for AI agents to access a “video toolbox” using the Clipkit schema. The server is intended to expose Clipkit functionality in a structured format compatible with Model Context Protocol clients.

🛠️ Key Features

MCP server for Clipkit
Exposes a “video toolbox” to AI agents
Uses the Clipkit schema

🚀 Use Cases

Connecting AI agents to Clipkit video capabilities through MCP
Building agent workflows that rely on the Clipkit schema

⚡ Developer Benefits

Schema-based integration via the Clipkit schema
Developer consumption through an MCP server interface

⚠️ Limitations

Provided details do not include specific tools, endpoints, authentication, or capabilities beyond the Clipkit schema and “video toolbox” description.

@clipkit/mcp-server

An MCP server that exposes the Clipkit schema as tools, letting AI agents compose video projects programmatically. The Clipkit schema is the protocol — agents don't speak a custom DSL, they construct schema-valid JSON.

Install + run

bash

npx -y @clipkit/mcp-server

Or wire it into a host like Claude Desktop:

json

{
  "mcpServers": {
    "clipkit": {
      "command": "npx",
      "args": ["-y", "@clipkit/mcp-server"],
      "env": {
        "CLIPKIT_API_URL": "https://clipkit.dev",
        "CLIPKIT_API_KEY": "ck_live_…"
      }
    }
  }
}

Environment

Var	Purpose
`CLIPKIT_API_URL`	Host for `create_promo` / `open_in_editor` links. Defaults to `https://clipkit.dev`. Set to `http://localhost:3000` when developing against a local web app.
`CLIPKIT_API_KEY`	Optional dashboard key (`ck_live_…`, from Settings → API keys). When set, projects are owned by your team (permanent on paid plans) and sent as `Authorization: Bearer`. Without it, projects are anonymous and expire after 7 days.

Tools

Tool	Description
`create_promo`	Fastest path to a designed promo: an ordered list of scenes → composed via the pattern library → returns a shareable editor link.
`create_project`	Reset to a blank source. Optional dimensions, duration, fps, output format.
`set_project`	Replace the entire source with a validated JSON object. The primary way to build (a composition, or many elements at once).
`add_element` / `edit_element` / `delete_element`	Tweak a single element in an existing composition. `edit_element` merges a partial element (only the keys you pass change).
`get_project`	Return the current Clipkit source JSON.
`describe_project`	Plain-language summary — dimensions, timeline by track, element counts, render-time warnings. Cheaper to read than the full JSON.
`validate_project`	Schema validation plus render-time warnings even when valid (emoji/non-ASCII dropped by the font atlas, elements past the end, missing duration).
`preview_still`	Render one frame to a PNG and return it as an image — how a chat-mode agent sees its work. Free + rate-limited.
`transcribe_to_captions`	Transcribe a media `url` (or local `path`) into a word-timestamped caption element. Whisper in-process — no key, no upload.
`open_in_editor`	Validate the current project and return a link that opens it in the Clipkit editor (free).
`load_project`	Re-import a shared project by share id or editor URL — the round-trip for `open_in_editor`.
`render_video`	Render the current project to a finished MP4 in the cloud (paid — consumes credits, needs `CLIPKIT_API_KEY`).

Every mutation goes through @clipkit/protocol's validator before being applied. Invalid edits return a structured error with the offending path; valid edits are committed atomically.

Workflow

Compose — create_promo for a designed video, or write a full source JSON and call set_project.
See — preview_still to look at a frame; validate_project / describe_project for a structural read-back. Loop: edit → preview_still → fix.
Tweak — add_element / edit_element / delete_element for single-element changes to a large composition.
Deliver — open_in_editor for a free editor link (and load_project to re-import it later), or render_video for a finished MP4.

State

State is in-memory per server session. Each MCP connection gets a fresh project. There is no persistence; agents that want to save a project should call get_project and store the JSON externally.

Schema reference

See @clipkit/protocol for the full element type catalog (video, image, text, shape, audio, composition, caption) and their fields.

width	integer	optional	Composition width in pixels. Default 1920.
height	integer	optional	Composition height in pixels. Default 1080.
duration	number	optional	Composition duration in seconds. Default 10.
frame_rate	number	optional	Frame rate. Default 30.
output_format	string	optional	Output container/codec. Default "mp4".
background_color	string	optional	Hex color, e.g. "#000000".
output_dither	any	optional	Anti-banding output dither — DEFAULT ON, leave unset. Pass false for byte-exact undithered output, or { amplitude, pattern } to tune. Stops gradients / soft shadows / blur from showing 8-bit banding; deterministic.
project_id	string	optional	Which project to act on — the id returned by create_project / set_project / create_promo / load_project. Omit when working on a single local project.

source	object	required	A full Clipkit source object.
project_id	string	optional	Which project to act on — the id returned by create_project / set_project / create_promo / load_project. Omit when working on a single local project.

element	object	required	A Clipkit element object. Must include `type`.
parent_id	string	optional	Optional id of a group to add this element INTO (nested). Omit to add at the top level.
project_id	string	optional	Which project to act on — the id returned by create_project / set_project / create_promo / load_project. Omit when working on a single local project.

id	string	required	The id of the element to edit.
patch	object	required	Partial element: the fields to change. Omitted keys are left as-is; a key set to null is removed.
project_id	string	optional	Which project to act on — the id returned by create_project / set_project / create_promo / load_project. Omit when working on a single local project.

id	string	required	The id of the element to delete.
project_id	string	optional	Which project to act on — the id returned by create_project / set_project / create_promo / load_project. Omit when working on a single local project.

Clipkit

dev.clipkit/clipkit — MCP Server for Clipkit

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

read_docs

get_schema

create_project

get_project

describe_project

set_project

add_element

edit_element

delete_element

validate_project

preview_still

create_promo

open_in_editor

ingest_asset

load_project