Kuchi

Pick a real launch video as a template, get its frame-by-frame breakdown and plan your own remake.

Should I use this

Quality & Safety

B
Description quality
96%
Schema completeness
96%
Naming quality
84%
Poisoning risk
60%
Permission match
90%
Protocol compliance
100%

Findings (6)

  • HIGHTool poisoning patterns detected
  • MEDIUMTool 'kuchi_plan_remake' description contains placeholder textin kuchi_plan_remake
  • MEDIUMTool 'kuchi_check_remake' description contains placeholder textin kuchi_check_remake
  • LOWTool 'fetch' suggests web access but openWorldHint=falsein fetch
  • INFOTool description contains placeholder or incomplete textin kuchi_plan_remake
  • INFOTool description contains placeholder or incomplete textin kuchi_check_remake

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~5,113Tokens (tool definitions)
~3.7 KBTypical response size
Significant attention impact (3.99% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "kuchi": {
      "url": "https://kuchi.kalarislabs.com/mcp"
    }
  }
}

Remote endpoints

https://kuchi.kalarislabs.com/mcpstreamable-http

What it can do

Tool inventory

Tools (11)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢kuchi_get_workflow(step)

Get Kuchi's workflow for turning a reference into the user's own launch video: how to pick a reference, how to analyse each shot from the storyboard sheets, what to ask the user for, how to match timing to the frame, and how to check the result against the reference. Returns Markdown. Pass step to get one step ("find", "study", "plan", "build" or "check") with the rules that hold for all of them, or leave it out for the whole workflow. Read it before a first remake; the other tools return the data each step works on.

Input Schema

{
  "type": "object",
  "properties": {
    "step": {
      "default": "all",
      "description": "'all' (default) for the whole workflow, or one step: 'find', 'study', 'plan', 'build' or 'check'",
      "type": "string",
      "enum": [
        "all",
        "find",
        "study",
        "plan",
        "build",
        "check"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢kuchi_suggest_templates(looking_for, styles, theme, pace, aspect_ratio, ...)

Get a short list of Kuchi launch videos for the user to choose their template from, ranked against what they want and what they can supply. Pass what is known: a few words on the product and the feel wanted, preferred styles, theme, pace, aspect ratio, target length and the kinds of asset the user has. All are optional, and they rank rather than filter. Returns up to 6 numbered choices, each with what fits, what differs, what the user would need to supply, a poster and a watch link; a recommended choice; a question to put to the user; and the gallery link, where the user can pick any video and paste its link instead. Use it when the user wants a launch video and has not picked a reference. Use kuchi_search_videos to browse or filter the whole library.

Input Schema

{
  "type": "object",
  "properties": {
    "looking_for": {
      "description": "A few words on the product and the feel wanted, e.g. 'AI note-taking app, calm and premium'",
      "type": "string",
      "maxLength": 300
    },
    "styles": {
      "description": "Preferred motion styles, e.g. ['UI motion', 'Kinetic type']; kuchi_list_filters has the full list",
      "maxItems": 5,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 100
      }
    },
    "theme": {
      "description": "Preferred overall brightness",
      "type": "string",
      "enum": [
        "dark",
        "light",
        "mixed"
      ]
    },
    "pace": {
      "description": "Preferred cutting pace",
      "type": "string",
      "enum": [
        "slow",
        "medium",
        "fast",
        "rapid"
      ]
    },
    "aspect_ratio": {
      "description": "Output ratio wanted, e.g. '16:9', '1:1', '9:16'",
      "type": "string",
      "maxLength": 20
    },
    "target_seconds": {
      "description": "Length wanted, in seconds",
      "type": "integer",
      "minimum": 5,
      "maximum": 180
    },
    "available_assets": {
      "description": "The kinds of asset the user can supply. Templates that need something else rank lower and say so.",
      "maxItems": 9,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "logo",
          "screenshot",
          "screen_recording",
          "product_photo",
          "illustration",
          "music",
          "voiceover",
          "font",
          "other"
        ]
      }
    },
    "exclude": {
      "description": "Videos the user has already turned down",
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 500,
        "description": "A Kuchi video id ('34'), slug, Kuchi link (https://kuchi.kalarislabs.com/#video-34) or the original X post URL"
      }
    },
    "count": {
      "default": 3,
      "description": "Choices to return (1-6, default 3)",
      "type": "integer",
      "minimum": 1,
      "maximum": 6
    },
    "response_format": {
      "default": "markdown",
      "description": "'markdown' (default) for readable text, 'json' for structured data",
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢kuchi_search_videos(query, style, category, format, aspect_ratio, ...)

Search Kuchi's launch-video references by product type, brand, motion style, format, pace, theme, aspect ratio or length. Returns one page of videos with notes on their motion, measured rhythm (shots, pace, theme), a poster image, a storyboard sheet and a playable Kuchi link. Use kuchi_list_filters for valid filter values, kuchi_get_video for one video's details and kuchi_get_breakdown for its shot list. Examples: - "dark cinematic AI launch" -> query="AI", theme="dark" - "a short vertical teaser" -> aspect_ratio="9:16", max_seconds=20 - "launch videos built from app UI" -> style="UI motion" - "fast-cut launch with charts" -> pace="fast", style="Charts"

Input Schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Keywords matched against titles, brands, styles, formats, motion notes and shot descriptions",
      "type": "string",
      "maxLength": 300
    },
    "style": {
      "description": "Exact motion style, e.g. 'UI motion', 'Kinetic type', 'Device motion'",
      "type": "string",
      "maxLength": 100
    },
    "category": {
      "description": "Exact category, e.g. 'AI launch', 'Feature clip', 'Startup launch'",
      "type": "string",
      "maxLength": 100
    },
    "format": {
      "description": "Format id or name, e.g. 'pastel-ui-cursor-demos'",
      "type": "string",
      "maxLength": 100
    },
    "aspect_ratio": {
      "description": "Exact ratio, e.g. '16:9', '1:1', '9:16'",
      "type": "string",
      "maxLength": 20
    },
    "pace": {
      "description": "Measured cutting pace: slow is under 1.5 shot changes per 10 s, rapid is 7 or more",
      "type": "string",
      "enum": [
        "slow",
        "medium",
        "fast",
        "rapid"
      ]
    },
    "theme": {
      "description": "Measured overall brightness",
      "type": "string",
      "enum": [
        "dark",
        "light",
        "mixed"
      ]
    },
    "max_seconds": {
      "description": "Only videos at most this long",
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 600
    },
    "sort": {
      "default": "relevance",
      "description": "'relevance' (default) or 'newest'",
      "type": "string",
      "enum": [
        "relevance",
        "newest"
      ]
    },
    "limit": {
      "default": 6,
      "description": "Videos per page (1-20, default 6)",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    },
    "offset": {
      "default": 0,
      "description": "Videos to skip, for pagination",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "response_format": {
      "default": "markdown",
      "description": "'markdown' (default) for readable text, 'json' for structured data",
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢kuchi_get_video(reference, response_format)

Get one Kuchi reference by id, slug, Kuchi link or X post URL: playable video file, poster, storyboard sheet, length, size, aspect ratio, styles, measured rhythm and notes on its motion. Use kuchi_search_videos to find ids and kuchi_get_breakdown for the shot list.

Input Schema

{
  "type": "object",
  "properties": {
    "reference": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "A Kuchi video id ('34'), slug, Kuchi link (https://kuchi.kalarislabs.com/#video-34) or the original X post URL"
    },
    "response_format": {
      "default": "markdown",
      "description": "'markdown' (default) for readable text, 'json' for structured data",
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ]
    }
  },
  "required": [
    "reference"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢kuchi_list_filters(response_format)

List every motion style, category, format, aspect ratio, pace and theme in Kuchi, with how many videos each has, to use as filters in kuchi_search_videos. Also lists the shot kinds a shot is classified into when you analyse a storyboard.

Input Schema

{
  "type": "object",
  "properties": {
    "response_format": {
      "default": "markdown",
      "description": "'markdown' (default) for readable text, 'json' for structured data",
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢kuchi_get_breakdown(reference, storyboard, detail_sheet, shot_offset, shot_limit, ...)

Get the shot-by-shot breakdown of one Kuchi reference, measured from every frame of its video file. Returns exact facts (fps, frame count, length), every shot's start and end in seconds and frames, how it enters (cut, animated transition, hold or blank frame), how much of the frame moves, its tone and colors, motion and loudness per second, and storyboard sheets: grids of real frames stamped with their time and shot number. Each shot says where to see it: its frame on the overview sheet, when it has one, and the detail sheets that show it. Kuchi measures when things happen; what each shot shows is read from the frames. The result lists the shot kinds to classify against, and the analysis goes to kuchi_plan_remake as shot_analysis. Set storyboard="overview" (one frame per shot, or per longest shot when there are many) or "detail" (evenly spaced frames that cover every shot, page with detail_sheet) to receive that sheet as an image. Use it before kuchi_plan_remake to study a reference, and while building to match each shot.

Input Schema

{
  "type": "object",
  "properties": {
    "reference": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "A Kuchi video id ('34'), slug, Kuchi link (https://kuchi.kalarislabs.com/#video-34) or the original X post URL"
    },
    "storyboard": {
      "default": "links",
      "description": "'links' (default) returns sheet URLs only; 'overview' or 'detail' also returns one sheet as an image",
      "type": "string",
      "enum": [
        "links",
        "overview",
        "detail"
      ]
    },
    "detail_sheet": {
      "default": 1,
      "description": "Which detail sheet to return when storyboard=\"detail\" (1 is the start of the video)",
      "type": "integer",
      "minimum": 1,
      "maximum": 40
    },
    "shot_offset": {
      "default": 0,
      "description": "Shots to skip, for videos with many shots",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "shot_limit": {
      "default": 40,
      "description": "Shots per page (1-60, default 40)",
      "type": "integer",
      "minimum": 1,
      "maximum": 60
    },
    "response_format": {
      "default": "markdown",
      "description": "'markdown' (default) for readable text, 'json' for structured data",
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ]
    }
  },
  "required": [
    "reference"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢kuchi_plan_remake(reference, product_name, product_description, audience, key_features, ...)

Plan a launch video for the user's product, using a Kuchi reference as an inspiration template. Pass the user's own product details and assets, and your shot_analysis: the kind of each reference shot, read from the storyboard sheets of kuchi_get_breakdown. Returns what to borrow from the reference (rhythm, color roles, motion), a blueprint that re-times the reference's shots to the target length on whole frames and says what content of the user's goes in each shot, the rules for using a reference, and missing_inputs: questions to ask the user before building. ready=false means required inputs are missing. Shots without a kind keep their exact timing and get placeholder content. Call it again with the user's answers and your analysis until ready=true and every shot has a kind. Only list assets the user actually gave you. It does not render video; build it with your own tools, then call kuchi_check_remake.

Input Schema

{
  "type": "object",
  "properties": {
    "reference": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "A Kuchi video id ('34'), slug, Kuchi link (https://kuchi.kalarislabs.com/#video-34) or the original X post URL"
    },
    "product_name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "The user's product name"
    },
    "product_description": {
      "description": "What the product does and who it is for, in the user's words",
      "type": "string",
      "maxLength": 500
    },
    "audience": {
      "description": "Who the video is for",
      "type": "string",
      "maxLength": 200
    },
    "key_features": {
      "description": "1-3 features or moments to show, most important first",
      "maxItems": 6,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 120
      }
    },
    "call_to_action": {
      "description": "The closing line or URL, e.g. 'Try it at acme.com'",
      "type": "string",
      "maxLength": 120
    },
    "brand_colors": {
      "description": "Brand colors, e.g. ['#0B0B0F', '#7C5CFF']",
      "maxItems": 8,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 30
      }
    },
    "fonts": {
      "description": "Brand typefaces",
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 60
      }
    },
    "tone": {
      "description": "e.g. 'calm and premium', 'playful'",
      "type": "string",
      "maxLength": 100
    },
    "assets": {
      "description": "Assets the user has provided. Only list assets the user actually gave you.",
      "maxItems": 30,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "logo",
              "screenshot",
              "screen_recording",
              "product_photo",
              "illustration",
              "music",
              "voiceover",
              "font",
              "other"
            ],
            "description": "What the asset is"
          },
          "description": {
            "type": "string",
            "maxLength": 200,
            "description": "What it shows, e.g. 'Dashboard, dark mode'"
          },
          "location": {
            "description": "URL or file path, if the user gave one. Kuchi never opens it.",
            "type": "string",
            "maxLength": 500
          }
        },
        "required": [
          "kind",
          "description"
        ],
        "additionalProperties": false
      }
    },
    "shot_analysis": {
      "description": "Your reading of the reference's shots from its storyboard sheets. One entry per shot; send as many as you have analysed.",
      "maxItems": 150,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "shot": {
            "type": "integer",
            "minimum": 1,
            "maximum": 1000,
            "description": "The reference shot's number, from kuchi_get_breakdown"
          },
          "kind": {
            "type": "string",
            "enum": [
              "title_card",
              "kinetic_type",
              "logo",
              "ui_screen",
              "ui_closeup",
              "device",
              "chart",
              "character",
              "product_render",
              "live_action",
              "collage",
              "abstract",
              "end_card",
              "blank"
            ],
            "description": "What the shot is; kuchi_get_breakdown describes each kind"
          },
          "shows": {
            "description": "One line on what is on screen and where it sits, e.g. 'Dashboard centered, sidebar left, cursor moves to a button'",
            "type": "string",
            "maxLength": 200
          }
        },
        "required": [
          "shot",
          "kind"
        ],
        "additionalProperties": false
      }
    },
    "target_seconds": {
      "description": "Target length in seconds; defaults to the reference's length",
      "type": "integer",
      "minimum": 5,
      "maximum": 180
    },
    "fps": {
      "description": "Frame rate you will render at, e.g. 30 or 60; defaults to the reference's. The blueprint's frame numbers use it.",
      "type": "number",
      "minimum": 12,
      "maximum": 120
    },
    "aspect_ratio": {
      "description": "Output ratio; defaults to the reference's",
      "type": "string",
      "maxLength": 20
    },
    "shot_offset": {
      "default": 0,
      "description": "Blueprint shots to skip, for references with many shots",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "shot_limit": {
      "default": 40,
      "description": "Blueprint shots per page (1-40, default 40)",
      "type": "integer",
      "minimum": 1,
      "maximum": 40
    },
    "response_format": {
      "default": "markdown",
      "description": "'markdown' (default) for readable text, 'json' for structured data",
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ]
    }
  },
  "required": [
    "reference",
    "product_name"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢kuchi_check_remake(reference, product_name, target_seconds, music_source, shots, ...)

Check a drafted or finished remake against the rules for using a Kuchi reference. Pass your shot list: timing, the reference shot each one rebuilds, how it enters, the on-screen text, and where each asset came from. Flags text that carries over the reference's brand, assets taken from the reference, generated logos or product UI, placeholders, timing gaps, and shots whose length or entrance drifted from the reference shot they rebuild. Also returns compare_frames: the exact time in your video and in the reference that show the same moment, to set side by side. passed=false means there are errors to fix. It checks what you report, not the rendered file: Kuchi never receives your video. Be accurate about each asset's source.

Input Schema

{
  "type": "object",
  "properties": {
    "reference": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "A Kuchi video id ('34'), slug, Kuchi link (https://kuchi.kalarislabs.com/#video-34) or the original X post URL"
    },
    "product_name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "The user's product name"
    },
    "target_seconds": {
      "description": "The length you were aiming for",
      "type": "number",
      "minimum": 1,
      "maximum": 600
    },
    "music_source": {
      "description": "Where the soundtrack came from",
      "type": "string",
      "enum": [
        "none",
        "user",
        "licensed",
        "generated",
        "reference"
      ]
    },
    "shots": {
      "minItems": 1,
      "maxItems": 150,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "start_s": {
            "type": "number",
            "minimum": 0,
            "maximum": 600,
            "description": "When the shot starts in your video, in seconds"
          },
          "end_s": {
            "type": "number",
            "minimum": 0,
            "maximum": 600,
            "description": "When it ends, in seconds"
          },
          "reference_shot": {
            "description": "The reference shot this one rebuilds (the blueprint's reference_shot). Needed for the timing check and compare_frames.",
            "type": "integer",
            "minimum": 1,
            "maximum": 1000
          },
          "enters": {
            "description": "How this shot enters in your video",
            "type": "string",
            "enum": [
              "cut",
              "transition",
              "hold",
              "blank_black",
              "blank_white"
            ]
          },
          "on_screen_text": {
            "description": "Every line of text visible in this shot",
            "maxItems": 20,
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 300
            }
          },
          "assets": {
            "maxItems": 20,
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "kind": {
                  "type": "string",
                  "enum": [
                    "logo",
                    "screenshot",
                    "screen_recording",
                    "product_photo",
                    "illustration",
                    "music",
                    "voiceover",
                    "font",
                    "other"
                  ]
                },
                "source": {
                  "type": "string",
                  "enum": [
                    "user",
                    "generated",
                    "stock",
                    "placeholder",
                    "reference"
                  ],
                  "description": "'user' = the user supplied it; 'reference' = taken from the Kuchi reference video"
                }
              },
              "required": [
                "kind",
                "source"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "start_s",
          "end_s"
        ],
        "additionalProperties": false
      },
      "description": "Your shots in order"
    },
    "response_format": {
      "default": "markdown",
      "description": "'markdown' (default) for readable text, 'json' for structured data",
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ]
    }
  },
  "required": [
    "reference",
    "product_name",
    "shots"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢search(query)

Search Kuchi launch-video references. Returns ids to pass to fetch. Same catalog as kuchi_search_videos.

Input Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 300,
      "description": "Keywords, e.g. \"pastel UI cursor demo\""
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢fetch(id)

Fetch one Kuchi reference by the id from search, with its notes, links and metadata.

Input Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "Video id from search"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟡kuchi_send_feedback(feedback_type, summary, details, friction_points, suggested_improvement, ...)

Send feedback about this server to its developers: a capability you needed that no tool provides, a tool that failed or misled you, or something that worked well. Records the feedback; it does not add or change tools. Leave out personal or sensitive details.

Input Schema

{
  "type": "object",
  "properties": {
    "feedback_type": {
      "type": "string",
      "enum": [
        "missing_capability",
        "issue",
        "praise",
        "other"
      ],
      "description": "What kind of feedback this is. Use 'missing_capability' when the tool you needed does not exist in the tool list - nothing failed, the capability is absent. Use 'issue' when an existing tool behaved badly: it failed, returned a confusing error, or its description or schema misled you. Use 'praise' when something worked notably well. Use 'other' for anything else."
    },
    "summary": {
      "type": "string",
      "description": "One self-contained sentence. For 'missing_capability': the capability you needed, e.g. 'No tool to delete multiple cohorts in one call.' For 'issue': the tool and the problem, e.g. 'query-trends rejects relative date ranges with an unclear error.'"
    },
    "details": {
      "type": "string",
      "description": "Optional longer context: what you tried, exact parameter values, the error text you saw, and any workaround you used. Omit when the summary says it all."
    },
    "friction_points": {
      "type": "string",
      "description": "Optional: the specific moments that slowed you down, as short bullet-like sentences, quoting exact tool names, parameters, or error text."
    },
    "suggested_improvement": {
      "type": "string",
      "description": "Optional: the concrete change that would have helped, e.g. the tool to add, the description to reword, or the error message to improve."
    },
    "tool_name": {
      "type": "string",
      "description": "Optional: the existing tool this feedback is about (for 'issue' or 'praise'). Leave empty for 'missing_capability' - the point is that no tool fits."
    },
    "sentiment": {
      "type": "string",
      "enum": [
        "positive",
        "neutral",
        "negative",
        "mixed"
      ],
      "description": "Optional: how the experience felt overall."
    },
    "task_completed": {
      "type": "boolean",
      "description": "Optional: whether you still completed the user's task despite the problem."
    }
  },
  "required": [
    "feedback_type",
    "summary"
  ]
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded11 tools