How to use the Kuchi MCP server and agent skill in any AI agent
Kuchi gives your AI agent a library of real product-launch videos, each measured frame by frame, so it can remake one for your product. Your agent reaches it through MCP, the Model Context Protocol. This guide covers both MCP servers you can connect, what every tool does, and where the Kuchi agent skill file lives.
Nothing here needs an account. The Kuchi server takes no sign-in and no API key, so never paste credentials into your agent for it.
The two MCP servers
Most people only need the first one. Add the second if your agent writes Remotion code and you want it to browse and install components through shadcn as well.
| Server | Address | What it is for |
|---|---|---|
| Kuchi MCP | https://kuchi.kalarislabs.com/mcp | Finding a launch video to use as a template, reading its frame-by-frame breakdown, planning your remake, checking it, and reading video components. |
| shadcn MCP, pointed at Kuchi | npx shadcn@latest mcp with the @kuchi registry | Browsing, searching and installing Kuchi's 178 Remotion components into your project with the shadcn CLI. |
The component route is covered step by step in Remotion components your AI agent can install.
Connect the Kuchi MCP server
The server speaks Streamable HTTP at https://kuchi.kalarislabs.com/mcp. Pick your agent:
| Agent | How to add Kuchi |
|---|---|
| Claude Code | In Claude Code, install the Kuchi plugin. It adds the skill and the MCP server in one step. /plugin install kuchi --marketplace KalarisLabs/kuchi |
| Codex | In a terminal, add the server to Codex CLI. No sign-in or API key is needed. codex mcp add kuchi --url https://kuchi.kalarislabs.com/mcp |
| Cursor | Add the server with Cursor's one-click install. It opens Cursor and fills in the URL. |
| VS Code | Add the server with the VS Code install link. VS Code asks you to confirm. |
| Gemini CLI | Add this to ~/.gemini/settings.json, then restart Gemini CLI. No sign-in is needed. {
"mcpServers": {
"kuchi": {
"httpUrl": "https://kuchi.kalarislabs.com/mcp"
}
}
} |
| Claude | On claude.ai, add Kuchi as a custom connector. The link fills in the name and URL. |
| ChatGPT | In ChatGPT, open Plugins and select + → Add custom MCP server. |
| Grok | Sign in to Grok and open Connectors. Select New Connector → Custom. |
Any other client that supports remote MCP servers works too: add the URL above as an HTTP server with no authentication. Each agent has a full guide with prompts to try on the agent guides page.
Then paste the setup prompt, so the agent knows when and how to use Kuchi:
Connect the Kuchi MCP server at https://kuchi.kalarislabs.com/mcp (Streamable HTTP, no sign-in) and confirm it works by listing its tools.
Kuchi is a library of real product-launch videos to use as inspiration templates. When I want a launch video, read kuchi_get_workflow and follow it: get a short list with kuchi_suggest_templates and show me each one's poster and link so I can choose, in chat or by picking a video on kuchi.kalarislabs.com and pasting its link. Once I pick one, study it with kuchi_get_breakdown, look at its storyboard and note what each shot shows, then call kuchi_plan_remake with my product details and your shot analysis, and ask me for my logo, screenshots and anything else it lists as missing. Build to the blueprint's frames. Before you deliver, run kuchi_check_remake and compare your frames with the reference. Copy only the reference's motion and taste; everything on screen comes from my product.Check that it works
Ask your agent to list the Kuchi tools. It should see 13: eleven that start with kuchi_, plus search and fetch. If it sees none, the server was added without the right transport: it must be HTTP (Streamable HTTP), not stdio or SSE.
What each tool does
You never call these yourself. Your agent picks them as it works, in roughly this order. Every catalog tool is read-only.
| Tool | What it does |
|---|---|
kuchi_get_workflow | The full method for a remake, whole or one step at a time (find, study, plan, build, check). Agents read it before a first remake. |
kuchi_suggest_templates | A short numbered list of launch videos ranked for your product, with what fits, what differs, what you would need to supply, and one recommended choice. |
kuchi_search_videos | Searches the whole library by keyword, style, category, format, aspect ratio, length, pace or theme. |
kuchi_get_video | One video by id, slug, Kuchi link or X link: the file, poster, storyboard, length and measured rhythm. |
kuchi_list_filters | Every valid style, category, format, aspect ratio, pace and theme, with counts, plus the 14 shot kinds. |
kuchi_get_breakdown | The frame-by-frame measurement of one video: every shot with its exact start and end, how it enters, how much moves, its colours, and storyboard sheets of real frames. |
kuchi_plan_remake | Takes your product details and the agent's shot analysis and returns a blueprint: every reference shot re-timed to your length on whole frames, with your content in each, plus the questions still to ask you. |
kuchi_check_remake | Checks the agent's shot list before delivery: reused brand words, assets taken from the reference, invented logos or UI, placeholders, and timing against the reference shot by shot. |
kuchi_list_components | Lists the 178 Remotion video components: kinetic type, captions, UI screens, AI chats, cursors, logos and transitions. |
kuchi_get_component | One component's full source, dependencies, install command and usage notes. |
kuchi_send_feedback | Lets the agent report a failure or a missing capability to Kuchi's maintainers. The only tool that records what the agent writes. |
search, fetch | The two tools ChatGPT connectors and deep research look for, over the same catalog. |
Prompts and resources
Clients that show prompt menus get two prompts: remake_launch_video and find_launch_inspiration. Clients that browse resources can attach kuchi://workflow, any video as kuchi://videos/{id}, any breakdown as kuchi://breakdowns/{id} and any component as kuchi://components/{name}, with autocomplete.
Where the Kuchi agent skill (SKILL.md) is
The skill is one Markdown file that tells an agent when to reach for Kuchi (any launch video, product demo, teaser or feature announcement, even when you don't say "Kuchi") and the five steps to follow. The MCP server works without it, but with the skill installed your agent uses Kuchi without being asked. It is the same file everywhere:
| Where | How to get it |
|---|---|
| Claude Code plugin | /plugin install kuchi --marketplace KalarisLabs/kuchi installs the skill and the MCP server together. |
| Any agent with a skills folder | npx skills add kalarislabs/kuchi installs it into .agents/skills/kuchi, which Claude, Cursor, Codex, Antigravity and Gemini read. |
| On the web | https://kuchi.kalarislabs.com/agent/SKILL.md, to read or copy by hand, for example into .claude/skills/kuchi/SKILL.md. |
| Over MCP | The server publishes it as the resource skill://kuchi/SKILL.md, for clients that support MCP skills. |
Using Kuchi without MCP
An agent that can only fetch URLs can still follow the method: the workflow, the catalog and each breakdown at https://kuchi.kalarislabs.com/agent/breakdowns/<id>.json.
Privacy
- Kuchi records anonymous usage (which tool ran, how long it took, whether it failed, the client's name). It never records what you send to
kuchi_plan_remakeorkuchi_check_remake, and never your IP address. Details are on the privacy page. - Kuchi never receives or renders your video. Your agent builds it with your own tools.
Questions
Is the Kuchi MCP server free?
Yes. It needs no account, no sign-in and no API key. Add the URL and start.
Which transport does the Kuchi MCP server use?
Streamable HTTP at https://kuchi.kalarislabs.com/mcp. Add it as an HTTP (remote) server, not stdio.
Do I need the SKILL.md file if I have the MCP server?
No, the server works on its own and sends the same method through kuchi_get_workflow. The skill makes your agent reach for Kuchi automatically whenever you ask for a launch video.
Where does the skill file go?
The Claude Code plugin and npx skills add kalarislabs/kuchi put it in place for you. By hand, copy https://kuchi.kalarislabs.com/agent/SKILL.md into your agent's skills folder, for example .claude/skills/kuchi/SKILL.md.
Can ChatGPT use Kuchi?
Yes. Add Kuchi as a custom MCP server with no authentication. ChatGPT can find templates, read breakdowns and write the plan; a coding agent such as Codex or Claude Code then builds and renders the video.
Does Kuchi see my product details?
The plan and check tools receive what your agent sends them so they can work, but analytics never record those details, and Kuchi never sees or stores your video.

