# Kition SDK > Kition SDK: an SDK (open source, Apache-2.0) that puts kits in your product. A kit is the engine, the editor and the agent tools for one kind of file; Kition has 16 (documents, sheets, slides, PDF, images, vectors, video, CAD and more). Embed the editors (in your page with @kition/embed, or by signed iframe link with @kition/embed-server), script the files, run them headless, give them to AI agents over MCP. Free, no key. Kition Server adds real-time collaboration. Published today: the Note kit's package, the Table kit's package; the other kits on this site are previews. Every link below is the Markdown copy of a page (the HTML page is the same address without `.md`; each copy names it in its front matter). The docs and the way-in pages in one file: [llms-full.txt](https://developer.kition.ai/llms-full.txt). Every kit command an agent can run, as JSON Lines: [commands.jsonl](https://developer.kition.ai/commands.jsonl). ## Docs - [Kition SDK developer docs](https://developer.kition.ai/docs.md): The Kition SDK puts real editors for docx, xlsx, pptx, PDF, PSD and more in your product: embed them, script them, run them headless, or hand them to an AI agent. - [Quick start: a real editor in your page](https://developer.kition.ai/docs/quick-start.md): Install @kition/embed, put the kit package (static files: the editor and its WebAssembly engine) on your own CDN, mount the editor on an element and save through your own storage: a working document editor in four steps. - [Embed in your page: kit editors with @kition/embed](https://developer.kition.ai/docs/embed.md): Mount a kit’s editor with KitionEmbed.mount over your storage and your users (the editor and its WebAssembly engine load from your CDN), check the document, and review an agent’s draft or let your agent work in the open editor. - [Embed by link: a kit editor in a signed iframe (@kition/embed-server)](https://developer.kition.ai/docs/url.md): Run @kition/embed-server, mint a signed iframe URL on your server for one person and one file, and answer the HMAC-signed callbacks that read and save the file in your storage. Single-user, free, no key. - [Script documents with the object model](https://developer.kition.ai/docs/script.md): Read and edit a document as typed objects with @kition/script: the same script runs in a page, in Node, against a headless kit, or in a co-edited room. - [Headless kits: no page, no window](https://developer.kition.ai/docs/headless.md): Run a kit’s native engine with no window to open, edit, render and save files on servers, in batch jobs and in tests, from code or from an agent. Free, no key. - [Agents: kit tools over MCP](https://developer.kition.ai/docs/agent.md): kition-kits-mcp gives Claude, Cursor or any MCP client each kit’s tools on a workspace: inspect, run, query, batch and check, with drafts a person reviews and merges. - [Co-editing with Kition Cloud or Kition Server](https://developer.kition.ai/docs/collab.md): Add real-time co-editing to embedded kit editors: the sync server URL, short-lived sync tokens from your server, and running Kition Server on your own machines. - [Distribution: the SDK bundle](https://developer.kition.ai/docs/distribution.md): What the versioned SDK bundle holds (npm packages, kit packages, executables, docs), how to make and verify it, and how to install from it or publish it to your private registry. ## Kit command reference - [Kit command reference](https://developer.kition.ai/docs/kits.md): the published kits' agent commands; each command has a page with its parameters, result and call shape - [Note kit commands](https://developer.kition.ai/docs/kits/note.md): The 49 commands an AI agent can run on Markdown (.md) files with the Note kit (0.3.0) through note_run: what each does, its parameters and its result. - [Table kit commands](https://developer.kition.ai/docs/kits/table.md): The 57 commands an AI agent can run on .ktable files with the Table kit (0.4.0) through table_run: what each does, its parameters and its result. - [commands.jsonl](https://developer.kition.ai/commands.jsonl): one JSON object per command (kit, id, title, description, mutates, params and result JSON Schema, page URL) - Not published yet, so no reference: Doc, Slide, Sheet, Board, Photo, Film, PDF, Vector, Layout, Motion, CAD, HTML, Design, Scene ## Pages - [Kition SDK — real editors in your app, the same files for your AI agents](https://developer.kition.ai/index.md): Embed a kit’s editor in your page with npm i @kition/embed or by a signed iframe link, script the same files in Node or headless, and let Claude, Cursor or any MCP client edit them with the same engine. Open source (Apache-2.0), free, no key. 16 kits: Note and Table are published, the rest are live previews. - [Playground — the Kition SDK live in your browser](https://developer.kition.ai/playground.md): Open a spreadsheet, slide deck, document, PSD or Markdown note in the real Kition editors, or open your own file: it stays in your browser. Edit, download, and copy the code that does the same in your product. - [Embed a Kition editor in your app — in your page with @kition/embed, or by link with @kition/embed-server](https://developer.kition.ai/embed.md): Two ways to put a real editor in your web app over your own storage and users: mount it in your page with KitionEmbed.mount, the editor and its WebAssembly engine loading from your own CDN, with co-editing and your agent in the open document; or frame one signed iframe link from the embed server you run. Free, no key. - [Embed by link — a Kition editor in one signed iframe, with @kition/embed-server](https://developer.kition.ai/url.md): The second way to embed a Kition editor: run the embed server (@kition/embed-server) and frame one signed link, with no module in your page. The file is read and saved through signed callbacks to your own storage. Single-user, free, no key. - [Headless Kition SDK — edit docx, xlsx, pptx, psd and more with no UI](https://developer.kition.ai/headless.md): Run Kition kits headless in Node or on a server: open, edit, check and export documents, spreadsheets, slides, PDF, PSD, SVG, DXF and more from a script. The same engines as the editors. Free, no key. - [Kition SDK for AI agents — MCP tools for Claude Code, Cursor, Codex and any MCP client](https://developer.kition.ai/agents.md): One stdio MCP server, kition-kits-mcp, lets Claude Code, Claude Desktop, Cursor, Codex or any MCP client inspect files, run real commands, check its own output and work in drafts a person merges. Free, no key. - [kiv — Git for kit files: diff, merge and branch slide files](https://developer.kition.ai/kiv.md): kiv is Git for kit files: object-level diffs of .pptx and .kslide slides, three-way merges through the kit, and a merge queue for AI agents in parallel worktrees. v0 supports slide files. - [Real-time co-editing for the Kition SDK — Kition Server and Kition Cloud](https://developer.kition.ai/collaboration.md): Add one option to KitionEmbed.mount and the people in your app co-edit spreadsheets, documents, slides and every other kit in real time, through Kition Cloud or Kition Server on your own machines. - [Kition SDK pricing — every way in free, Kition Server from $3,000 a year](https://developer.kition.ai/pricing.md): The Kition SDK is free in every form: embed, script, local MCP and headless, with no key. Kition Server for self-hosted co-editing is free up to 8 people, then $3,000 or $15,000 a year; Kition Cloud is billed by usage. - [Kition Server Enterprise — SLA, security review and procurement](https://developer.kition.ai/enterprise.md): Kition Server Enterprise for companies of 200+ people or with formal requirements: an SLA with priority response, your security questionnaire answered, contracts, purchase orders and invoices. $15,000 a year. ## Connect an agent From the [agent guide](https://developer.kition.ai/docs/agent.md). `kition-kits-mcp` is a stdio MCP server. It gives any MCP client (Claude Code, Claude Desktop, Cursor, Codex, DeepSeek Harness, your own agent) the kits' tools on one workspace folder. The agent creates, inspects, edits and checks files there through each kit's headless executable. No Kition app has to run, and the server is free on any machine with no licence key. The published kits are Note, for Markdown, and Table, for `.ktable` tables. Pick one way to get the server: - **npm**: `npx -y @kition/kits-mcp --workspace ` downloads and starts `kition-kits-mcp` for your platform (macOS arm64 and x64, Linux arm64 and x64 with glibc, Windows x64), with the published kits. Node.js 20 or later. `npm install -g @kition/kits-mcp` installs it as the command `kition-kits-mcp`. - **Installed binary**: take `bin//kition-kits-mcp` from the SDK release's bundle for your platform ([Distribution](https://developer.kition.ai/docs/distribution.md)), or build it from kition-sdk with `cargo build --release -p kition-kits --bin kition-kits-mcp`. It then needs the kits: give `--kits-dir ` (the bundle's `kits/`, whose executables are in `bin//`, or one folder per kit holding its `kit.json` and its `kition-` executable) or `--kit `; see [The server](https://developer.kition.ai/docs/agent.md#the-server). `--workspace` is the only folder the server reads or writes. A relative path is resolved against the folder the client starts the server in. Replace `` with an absolute path where the client does not start servers in your project (Claude Desktop, Codex). **Claude Code**: in the project folder, ```sh claude mcp add kition -- npx -y @kition/kits-mcp --workspace "$PWD" # installed binary: claude mcp add kition -- kition-kits-mcp --workspace "$PWD" --kits-dir ``` Add `--scope project` to share it through the project's `.mcp.json`. `/mcp` shows whether the server started. The Claude Code plugin in kition-sdk (`plugins/claude-code`, marketplace `kition`, plugin `kition-kits`) adds a skill per kit and draft review commands, and starts the same server. **Claude Desktop, and any client with an `mcpServers` file** (`claude_desktop_config.json`, `.mcp.json`, ...): ```json { "mcpServers": { "kition": { "command": "npx", "args": ["-y", "@kition/kits-mcp", "--workspace", "/absolute/path/to/folder"] } } } ``` **Cursor**: `.cursor/mcp.json` in the project: ```json { "mcpServers": { "kition": { "command": "npx", "args": ["-y", "@kition/kits-mcp", "--workspace", "${workspaceFolder}"] } } } ``` **Codex**: `~/.codex/config.toml`: ```toml [mcp_servers.kition] command = "npx" args = ["-y", "@kition/kits-mcp", "--workspace", "/absolute/path/to/folder"] ``` With the installed binary, the command is `kition-kits-mcp` (its path, if it is not on the `PATH`), and the arguments are `["--workspace", "", "--kits-dir", ""]`. Options for every form: - `--unified`: one set of ten tools for every kit (`kit_inspect`, `kit_run`, `kit_check`, ...), routed by the file's extension, instead of ten `_` tools per kit (`note_inspect`, `note_run`, ...). Use it when several kits are installed or the client limits tools or tool-definition tokens; with Note alone, both give ten tools. - `--drafts`: the agent's edits go to drafts the person reviews ([Drafts](https://developer.kition.ai/docs/agent.md#drafts)). - `--sandbox`: run every kit process in the operating system's sandbox. - `--list-kits` prints the kits the server found and exits. `--schemas` prints every tool's argument and result JSON Schema. `--help` lists every option. Other clients: - **Kition running**: its loopback endpoint `POST /v1/mcp/kits` also edits files open in kit editors live. - **Agent skill**: [skill/SKILL.md](https://github.com/KitionAI/kition-sdk/blob/main/docs/sdk/skill/SKILL.md) tells a coding agent how to use the tools. The tools each kit adds (prefix = the kit, such as `note`): | Tool | Does | | --- | --- | | `_inspect` | the document as JSON, with a rendered preview with `preview: true`; `target` is the part to list and, for a kit with a render command (`agent.render`), the view drawn (`{ time }`, `{ range, frames }`, `{ sequence }`, …), and `preview` in the answer says what the picture shows | | `_commands` | search the kit's commands by keywords | | `_run` | run command steps in order, then save (`{ path, target?, steps: [{ command, params?, on?, at? }] }`: `on` the ids a step acts on, `at` `{ part?, time? }` where; the kit's selection and current part are put back after the call; `preview: true` with `view` draws the after-picture at that view through the kit's render command) | | `_query`, `_batch` | read and edit objects through the object model | | `_draft_ready`, `_draft_reopen` | drafts a person reviews | | `_check` | what the kit finds wrong with the file: `{ diagnostics: [{ code, severity, target, message, fix? }] }` | | `_create` | a new file at `path` (`size` optional) | | `_export` | the file written in another format the kit exports, as a new file `to` (`format`, `options` for the kit's export command) | ## Agent skill and Claude Code plugin - [Agent skill `kition-kits`](https://developer.kition.ai/skill/SKILL.md): Create, edit and check files with Kition's kit tools over MCP (kition-kits-mcp). Markdown notes (md) with the published Note kit, and the file types of any other Kition kit the server has installed. Use when a task asks to create, change, or verify such a file in the workspace and the server's `kit_*` or `_*` tools are available. - [Claude Code plugin `kition-kits`](https://github.com/KitionAI/kition-sdk/tree/main/plugins/claude-code) (marketplace `kition`): Create, edit and check Markdown notes in your project with the Kition Note kit's KHP tools (MCP), with its editing skill and the person's draft review. Other Kition kits join as they are published. Install the plugin. From a kition-sdk checkout: ```sh claude plugin marketplace add ./plugins/claude-code claude plugin install kition-kits@kition ``` ## Optional - [Kition Tessera](https://tessera.kition.ai/llms.txt): the design system the editors use - [Kit Harness Protocol](https://kitharness.org): the open protocol for AI to use the kits - [Kition Universe](https://universe.kition.ai/llms.txt): every kit, as a star map - [Kition](https://kition.ai/llms.txt): the desktop app built on the kits