dev.clipkit/clipkit

Official15 toolsLive

by clipkit-video · TypeScript

MCP server for Clipkit — gives AI agents a video toolbox via the Clipkit schema.

Model Context Protocol (MCP) Server: dev.clipkit/clipkit

An MCP server for Clipkit that exposes the Clipkit schema as tools so AI agents can compose video projects programmatically. Instead of using a custom DSL, agents construct schema-valid JSON to interact with the provided tools.

🛠️ Key Features

Provides tools based on the Clipkit schema (schema-valid JSON construction)
Exposes Clipkit schema to AI agents as an MCP interface
Includes an example host configuration for Claude Desktop
Tool availability count: 15

🚀 Use Cases

Programmatic video project composition by AI agents
Schema-driven interactions with Clipkit for project assembly

⚡ Developer Benefits

Developers can build agents that generate schema-valid JSON for Clipkit
Integrates via npx -y @clipkit/mcp-server
Configurable with CLIPKIT_API_URL and CLIPKIT_API_KEY

⚠️ Limitations

Documentation excerpt does not describe non-video capabilities or any additional schemas beyond Clipkit

Captured live from the server via tools/list.

read_docs

Return a canonical Clipkit doc as text. topic "agents" = the authoring guide (schema cheat sheet, pattern catalog, recipes, guidance — read this BEFORE composing); "protocol" = the formal field spec; "brand" = brand reference. (Same docs offered as MCP resources, exposed as a tool so you can read them directly — resources are not always model-readable.)

Parameters1

topic

string

optional

Which doc. Default "agents".

Raw schema

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "enum": [
        "agents",
        "protocol",
        "brand"
      ],
      "description": "Which doc. Default \"agents\"."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_schema

Return the authoritative JSON Schema for a Clipkit Source — exact field names, types, and enums, generated from the protocol. Call with no argument for the full Source schema, or with element_type (e.g. "text", "shape", "particles") for just that element's fields (much smaller). Use this when authoring with set_project / add_element so you never guess a field.

Parameters1

element_type

string

optional

Limit to one element type's fields (e.g. "text"). Omit for the full Source schema (large).

Raw schema

{
  "type": "object",
  "properties": {
    "element_type": {
      "type": "string",
      "enum": [
        "video",
        "image",
        "text",
        "shape",
        "audio",
        "group",
        "caption",
        "particles"
      ],
      "description": "Limit to one element type's fields (e.g. \"text\"). Omit for the full Source schema (large)."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

create_project

Create a new, blank Clipkit project with the given dimensions and duration, and return its project_id. Defaults: 1920×1080, 10 seconds, 30 fps, output_format "mp4". Call this first when starting a new video. Pass an existing project_id to reset that project to blank; omit it to start a fresh project (note the returned id for subsequent tools).

Parameters8

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.

Raw schema

{
  "type": "object",
  "properties": {
    "width": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "Composition width in pixels. Default 1920."
    },
    "height": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "Composition height in pixels. Default 1080."
    },
    "duration": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Composition duration in seconds. Default 10."
    },
    "frame_rate": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Frame rate. Default 30."
    },
    "output_format": {
      "type": "string",
      "enum": [
        "mp4",
        "gif"
      ],
      "description": "Output container/codec. Default \"mp4\"."
    },
    "background_color": {
      "type": "string",
      "description": "Hex color, e.g. \"#000000\"."
    },
    "output_dither": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "object",
          "properties": {
            "enabled": {
              "type": "boolean"
            },
            "amplitude": {
              "type": "number",
              "minimum": 0,
              "maximum": 8
            },
            "pattern": {
              "type": "string",
              "enum": [
                "bayer",
                "noise"
              ]
            }
          },
          "additionalProperties": true
        }
      ],
      "description": "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": {
      "type": "string",
      "minLength": 1,
      "description": "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."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_project

Return the full current Clipkit source as JSON. Use this to inspect the project, pass it to a render pipeline, or compose follow-up edits.

Parameters1

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.

Raw schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "minLength": 1,
      "description": "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."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

describe_project

Return a compact, human-readable summary of the current project — dimensions, fps, duration, an element breakdown by type, a per-track timeline (paint order low→high), and render-time warnings. Much cheaper to read than get_project's full JSON; use it to orient yourself or sanity-check structure without dumping the whole source.

Parameters1

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.

Raw schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "minLength": 1,
      "description": "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."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

set_project

Replace the entire project with the given source JSON, returning its project_id. This is the PRIMARY way to build: use it to create a composition or to add/change many elements at once. (To tweak a single element in an existing project, use edit_element / add_element / delete_element instead.) Pass an existing project_id to replace that project; omit it to create a new one (note the returned id). The input is validated against the @clipkit/protocol before being accepted; invalid inputs return an error. Shape: { width, height, duration, frame_rate, output_format, background_color?, fonts?, camera?, lights?, elements:[…] }; every element has a `type` plus base fields (id, x, y, width, height, time, duration, track, opacity, rotation, animations, keyframe_animations) and type-specific fields. For exact field names + types call get_schema (optionally with an element_type) — the runtime ignores unrecognized keys, and this tool flags any it does not recognize.

Parameters2

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.

Raw schema

{
  "type": "object",
  "properties": {
    "source": {
      "type": "object",
      "additionalProperties": {},
      "description": "A full Clipkit source object."
    },
    "project_id": {
      "type": "string",
      "minLength": 1,
      "description": "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."
    }
  },
  "required": [
    "source"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

add_element

Append a single element to an existing project — a TWEAK, e.g. dropping in one more caption or shape. By default it is added at the top level; pass parent_id to add it INTO a group (nested). The element is any valid schema element: video, image, text, shape, audio, group, caption, or particles. To create a composition or add several elements at once, build the JSON and use set_project instead. The new element is validated as part of the project as a whole before being added. Call get_schema(element_type) for the exact per-type fields; unrecognized keys are flagged.

Parameters3

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.

Raw schema

{
  "type": "object",
  "properties": {
    "element": {
      "type": "object",
      "additionalProperties": {},
      "description": "A Clipkit element object. Must include `type`."
    },
    "parent_id": {
      "type": "string",
      "minLength": 1,
      "description": "Optional id of a group to add this element INTO (nested). Omit to add at the top level."
    },
    "project_id": {
      "type": "string",
      "minLength": 1,
      "description": "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."
    }
  },
  "required": [
    "element"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

edit_element

Change fields on the element with the given id by merging in a partial element — only the keys you include change. The id may be any element ANYWHERE in the tree, including one nested inside a group (or its mask). Pass a whole nested value (e.g. a new `keyframe_animations` array) to replace that key; set a key to null to remove it. This is for TWEAKING an existing composition. To create a composition or change many elements at once, edit the JSON and call set_project instead. The result is re-validated before being accepted.

Parameters3

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.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "The id of the element to edit."
    },
    "patch": {
      "type": "object",
      "additionalProperties": {},
      "description": "Partial element: the fields to change. Omitted keys are left as-is; a key set to null is removed."
    },
    "project_id": {
      "type": "string",
      "minLength": 1,
      "description": "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."
    }
  },
  "required": [
    "id",
    "patch"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

delete_element

Delete the element with the given id, anywhere in the tree (including one nested inside a group or its mask) — a tweak to an existing composition. (The project must keep at least one top-level element.)

Parameters2

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.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "The id of the element to delete."
    },
    "project_id": {
      "type": "string",
      "minLength": 1,
      "description": "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."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

validate_project

Run the @clipkit/protocol validator against the current project AND surface render-time warnings even when the JSON is valid — things that pass the schema but the runtime will silently drop or clip: emoji / non-ASCII text (the runtime font atlas is ASCII-only), elements that run past the composition end, a missing top-level duration. Run it before you share or render the project. For a fuller timeline read-back, use describe_project.

Parameters1

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.

Raw schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "minLength": 1,
      "description": "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."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

preview_still

Render a single frame of the current project to a PNG and return it as an image you can look at. This is how you check your work — in chat there is no other way to see what a composition actually looks like. Use it liberally: after composing, after edits, and at different times to inspect motion. Stills are FREE (credits are only spent by render_video). Pass `time` (seconds) to choose the frame; defaults to 0.

Parameters2

time	number	optional	Composition time in seconds to capture. Default 0 (first frame).
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.

Raw schema

{
  "type": "object",
  "properties": {
    "time": {
      "type": "number",
      "minimum": 0,
      "description": "Composition time in seconds to capture. Default 0 (first frame)."
    },
    "project_id": {
      "type": "string",
      "minLength": 1,
      "description": "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."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

create_promo

Assemble a designed-looking promo/intro/product/data video from the Clipkit pattern library: give an ordered list of SCENES and the words, and it bakes in the camera, glass, lighting, motion blur, timing, and layout, then returns an editor link. This is a FAST option when a conventional promo structure fits — it is NOT the only way to make a video and NOT a default; for anything specific or original, author the JSON yourself and call set_project (the full creative range). When you do use this, MIX scene types to fit the brief and vary the structure — a video can be a single kinetic headline, three title cards, a showcase montage, or a data explainer; you do NOT need a hero or a cta. Scene types: hero (glass-orb logo reveal: wordmark, tagline?), kinetic (letter-fly headline: text, subtitle?), showcase (a screenshot tilted in 3D: screenshot URL), title (full-frame title card: headline, kicker?, subtitle?), cta (closing card with a glass button: wordmark, tagline?, cta), stats (hero numbers: stats[{label,current,previous?}], title?), bars (bar chart: bars[{label,value,previous?}], title?), ranking (top-N list: items[{label,value}], title?), pie (pie cards: cards[{label,value,total,previous?}], title?). The data scenes (stats/bars/ranking/pie) look best with theme "mux".

Parameters6

scenes	array	required	Ordered scenes; mix types to fit the brief — you do NOT need hero/cta. e.g. a single [{type:"kinetic",text:"…"}], a sequence [{type:"title",headline:"…"},{type:"showcase",screenshot:"…"},{type:"title",headline:"…"}], or a data piece [{type:"ranking",title:"…",items:[…]}]
theme	string	optional	Visual theme. Default "cinematic" (dark, serif, premium).
motion_blur	integer	optional	Supersampled motion-blur samples (≥2 enables it — nicer but slower to render). Default off.
width	integer	optional	Default 1920.
height	integer	optional	Default 1080.
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.

Raw schema

{
  "type": "object",
  "properties": {
    "scenes": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "hero"
              },
              "wordmark": {
                "type": "string"
              },
              "tagline": {
                "type": "string"
              },
              "color": {
                "type": "string",
                "enum": [
                  "pink",
                  "green",
                  "blue",
                  "lavender",
                  "purple",
                  "yellow",
                  "gray"
                ],
                "description": "Accent color slot. Default \"green\"."
              },
              "duration": {
                "type": "number",
                "exclusiveMinimum": 0,
                "description": "Scene length in seconds. Sensible default per scene type."
              }
            },
            "required": [
              "type",
              "wordmark"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "kinetic"
              },
              "text": {
                "type": "string"
              },
              "subtitle": {
                "type": "string"
              },
              "color": {
                "$ref": "#/properties/scenes/items/anyOf/0/properties/color"
              },
              "duration": {
                "$ref": "#/properties/scenes/items/anyOf/0/properties/duration"
              }
            },
            "required": [
              "type",
              "text"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "showcase"
              },
              "screenshot": {
                "type": "string",
                "format": "uri"
              },
              "color": {
                "$ref": "#/properties/scenes/items/anyOf/0/properties/color"
              },
              "duration": {
                "$ref": "#/properties/scenes/items/anyOf/0/properties/duration"
              }
            },
            "required": [
              "type",
              "screenshot"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "title"
              },
              "headline": {
                "type": "string"
              },
              "kicker": {
                "type": "string"
              },
              "subtitle": {
                "type": "string"
              },
              "color": {
                "$ref": "#/properties/scenes/items/anyOf/0/properties/color"
              },
              "duration": {
                "$ref": "#/properties/scenes/items/anyOf/0/properties/duration"
              }
            },
            "required": [
              "type",
              "headline"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "cta"
              },
              "wordmark": {
                "type": "string"
              },
              "tagline": {
                "type": "string"
              },
              "cta": {
                "type": "string"
              },
              "color": {
                "$ref": "#/properties/scenes/items/anyOf/0/properties/color"
              },
              "duration": {
                "$ref": "#/properties/scenes/items/anyOf/0/properties/duration"
              }
            },
            "required": [
              "type",
              "wordmark",
              "cta"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "stats"
              },
              "title": {
                "type": "string"
              },
              "dateRange": {
                "type": "string"
              },
              "stats": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string"
                    },
                    "current": {
                      "type": "number"
                    },
                    "previous": {
                      "type": "number"
                    }
                  },
                  "required": [
                    "label",
                    "current"
                  ],
                  "additionalProperties": false
                },
                "minItems": 1,
                "maxItems": 4
              },
              "color": {
                "$ref": "#/properties/scenes/items/anyOf/0/properties/color"
              },
              "duration": {
                "$ref": "#/properties/scenes/items/anyOf/0/properties/duration"
              }
            },
            "required": [
              "type",
              "stats"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "bars"
              },
              "title": {
                "type": "string"
              },
              "dateRange": {
                "type": "string"
              },
              "bars": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string"
                    },
                    "value": {
                      "type": "number"
                    },
                    "previous": {
                      "type": "number"
                    }
                  },
                  "required": [
                    "label",
                    "value"
                  ],
                  "additionalProperties": false
                },
                "minItems": 1,
                "maxItems": 6
              },
              "color": {
                "$ref": "#/properties/scenes/items/anyOf/0/properties/color"
              },
              "duration": {
                "$ref": "#/properties/scenes/items/anyOf/0/properties/duration"
              }
            },
            "required": [
              "type",
              "bars"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "ranking"
              },
              "title": {
                "type": "string"
              },
              "dateRange": {
                "type": "string"
              },
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string"
                    },
                    "value": {
                      "type": "number"
                    }
                  },
                  "required": [
                    "label",
                    "value"
                  ],
                  "additionalProperties": false
                },
                "minItems": 1,
                "maxItems": 12
              },
              "color": {
                "$ref": "#/properties/scenes/items/anyOf/0/properties/color"
              },
              "duration": {
                "$ref": "#/properties/scenes/items/anyOf/0/properties/duration"
              }
            },
            "required": [
              "type",
              "items"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "pie"
              },
              "title": {
                "type": "string"
              },
              "dateRange": {
                "type": "string"
              },
              "cards": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string"
                    },
                    "value": {
                      "type": "number"
                    },
                    "total": {
                      "type": "number"
                    },
                    "previous": {
                      "type": "number"
                    }
                  },
                  "required": [
                    "label",
                    "value",
                    "total"
                  ],
                  "additionalProperties": false
                },
                "minItems": 1,
                "maxItems": 4
              },
              "color": {
                "$ref": "#/properties/scenes/items/anyOf/0/properties/color"
              },
              "duration": {
                "$ref": "#/properties/scenes/items/anyOf/0/properties/duration"
              }
            },
            "required": [
              "type",
              "cards"
            ],
            "additionalProperties": false
          }
        ]
      },
      "minItems": 1,
      "description": "Ordered scenes; mix types to fit the brief — you do NOT need hero/cta. e.g. a single [{type:\"kinetic\",text:\"…\"}], a sequence [{type:\"title\",headline:\"…\"},{type:\"showcase\",screenshot:\"…\"},{type:\"title\",headline:\"…\"}], or a data piece [{type:\"ranking\",title:\"…\",items:[…]}]"
    },
    "theme": {
      "type": "string",
      "enum": [
        "cinematic",
        "mux",
        "minimal"
      ],
      "description": "Visual theme. Default \"cinematic\" (dark, serif, premium)."
    },
    "motion_blur": {
      "type": "integer",
      "minimum": 0,
      "maximum": 32,
      "description": "Supersampled motion-blur samples (≥2 enables it — nicer but slower to render). Default off."
    },
    "width": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "Default 1920."
    },
    "height": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "Default 1080."
    },
    "project_id": {
      "type": "string",
      "minLength": 1,
      "description": "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."
    }
  },
  "required": [
    "scenes"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

open_in_editor

Validate the current project and create a link that opens it in the Clipkit web editor, where the user can preview and refine it. This shares the PROJECT (nothing is rendered — that's render_video). Use after composing or editing. Returns a URL.

Parameters1

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.

Raw schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "minLength": 1,
      "description": "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."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

ingest_asset

Fetch a remote media URL (image/video/audio) and HOST it on Clipkit, returning a stable asset_url to put in an element's `url`. Use this so the project's media survives — the original link may rot, be private, or block hotlinking. Anonymous projects allow up to 5 hosted assets / 100 MB total / 50 MB per file; when the limit is hit, tell the user to open the project (open_in_editor) and sign in to add more. Requires project_id.

Parameters3

url	string	required	A public http(s) URL to an image, video, or audio file.
filename	string	optional	Optional display name for the asset.
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.

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "A public http(s) URL to an image, video, or audio file."
    },
    "filename": {
      "type": "string",
      "description": "Optional display name for the asset."
    },
    "project_id": {
      "type": "string",
      "minLength": 1,
      "description": "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."
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

load_project

Import a previously shared project as the current project, by its share id or its editor URL (e.g. https://clipkit.dev/editor?id=…), returning its project_id. Use this to continue working on a project the user opened in the editor or shared earlier — the round-trip for open_in_editor. Pass an existing project_id to load into that project; omit it to load into a new one.

Parameters2

id_or_url	string	required	A share id, or a clipkit.dev/editor?id=… URL.
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.

Raw schema

{
  "type": "object",
  "properties": {
    "id_or_url": {
      "type": "string",
      "minLength": 1,
      "description": "A share id, or a clipkit.dev/editor?id=… URL."
    },
    "project_id": {
      "type": "string",
      "minLength": 1,
      "description": "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."
    }
  },
  "required": [
    "id_or_url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

packages/mcp-server/README.md4 KBView on GitHub

@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.

Install

Tools (15)

read_docsget_schemacreate_projectget_projectdescribe_projectset_projectadd_elementedit_element

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://www.clipkit.dev/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "clipkit": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.clipkit.dev/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Model Context Protocol (MCP) Server: dev.clipkit/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

@clipkit/mcp-server

Install + run

Environment

Tools

Workflow

State

Schema reference

Install

Remote endpoint

Related servers