Lets an AI client draft, edit, and publish MDX-based presentations with live audience interaction features.
Also known as kadalcc/deck, deck, @kadal/deck
- Stars
- 1
- Tools
- —
- Downloads, 30 days
- 14,252
- Latest version
- 0.6.5
- Last commit
- Nov 13, 2026
- License
- AGPL-3.0
What is Kadal Deck MCP?
Kadal Deck lets an AI client draft, edit, and publish MDX-based presentations with live audience interaction features.
Summary generated from the project's README
About Kadal Deck MCP server
Creating and managing interactive presentations through an AI client is what Kadal Deck enables for speakers and developers. By using the MCP server, you can connect tools like Claude Code, Cursor, or VS Code to your presentation workflow. The server allows an AI agent to outline, write, lint, and render MDX-based slides directly within your development environment. This setup uses your own API keys from providers such as OpenAI, Anthropic, Google, or OpenRouter to drive the drafting process.
Beyond initial creation, the system supports a full presentation lifecycle. You can build decks using a single deck.mdx file, rehearse them with voice narration and timing tools, and present them using a phone as a remote. The platform includes live audience engagement features like polls, quizzes, and Q&A. While the engine is open source and can be run locally via npm, the hosted MCP server specifically brings your published decks into AI interfaces for easier management and editing.
What you can do with it
- 1Drafting presentation outlinesAsk an AI agent to generate a slide structure based on your raw notes.
- 2Automating slide revisionsInstruct the AI to add specific interactive elements like polls to your existing deck.
- 3Managing published content via AIUse an AI client to access and edit decks that you have already published online.
Written from the project's README. Every use case is checked against a quote from it.
How to install Kadal Deck MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Kadal Deck MCP in Claude Code
$ claude mcp add deck -- npx -y @kadal/deckInstall Kadal Deck MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"deck": {
"command": "npx",
"args": [
"-y",
"@kadal/deck"
]
}
}
}Install Kadal Deck MCP in VS Code
.vscode/mcp.json
{
"servers": {
"deck": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@kadal/deck"
]
}
}
}Install Kadal Deck MCP in VS Code CLI
$ code --add-mcp '{"name":"deck","type":"stdio","command":"npx","args":["-y","@kadal/deck"]}'Install Kadal Deck MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"deck": {
"command": "npx",
"args": [
"-y",
"@kadal/deck"
]
}
}
}Install Kadal Deck MCP in Codex
$ codex mcp add deck -- npx -y @kadal/deckInstall Kadal Deck MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.deck] command = "npx" args = ["-y", "@kadal/deck"]
Install Kadal Deck MCP in Gemini CLI
$ gemini mcp add -s user deck npx -- -y @kadal/deckInstall Kadal Deck MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"deck": {
"command": "npx",
"args": [
"-y",
"@kadal/deck"
]
}
}
}Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablekadalcc/deck is public and reachablegithub.com/kadalcc/deck ↗Pass
- Package names this repository as its source@kadal/deck names kadalcc/deck as sourcenpmjs.com/package/@kadal/deck ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for @kadal/decknpmjs.com/package/@kadal/deck/v/0.13.1#provenance ↗Pass
- Open source license (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-12github.com/kadalcc/deck ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @kadal/deckPass
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubA talk is more than its slides. You need an outline that holds, slides that look the part, a few
run-throughs out loud, the right notes in front of you on the day, and a room that stays with you
to the end. Kadal Deck is built for all of it. You write the deck in one deck.mdx file, with AI
beside you if you want it; you rehearse it with the deck reading your notes and keeping time; you
present it with your phone in your hand; and the audience joins from theirs to vote, ask and react.
The engine is open source, and hosting is free for public decks.
Try it in your browser with no sign-up at deck.kadal.cc/app/try, or
start locally with npm create @kadal/deck@latest my-talk.
Build it
Start from an idea, not a blank slide.
- ✦ An AI assistant that drafts with you. In the builder on deck.kadal.cc, tell it about the talk ("turn my notes into eight slides", "add a poll after the intro") and it writes and revises the deck slide by slide, checks its work against the compiler, and answers the comments on your draft. Every change is a revision you can undo. It runs on your own key from OpenAI, Anthropic, Google or OpenRouter.
- ✦ Your own agent, too. The Agent Skill and the MCP server teach Claude Code, Cursor, VS Code or any MCP client the format, then let it outline, write slides, lint them, render them to look at its own work, and fix what it sees. The hosted MCP server brings your published decks to Claude, ChatGPT and Cursor.
- Write where you like. Markdown and MDX in your editor, with the VS Code extension
and the
kadal-deckCLI, or in the browser builder: edit right on the slide, and drop in emoji, icons, stickers, shapes, free photos, GIFs and memes from the media panel. - Look the part. 17 themes in light and dark, 28 built-in backgrounds, and the Pro library of 95 backgrounds and layouts.
Rehearse it
Practise out loud until it's yours.
- The deck reads your notes aloud and turns its own pages as it goes, in the browser's voice or the Kokoro AI voice running in your browser. Narration shows every chapter and slide on a timeline, so you hear how long the talk really runs.
- A plan for every slide. Give each slide a time; the timer's bar marks where you should be, and a pacing badge says how far ahead or behind you are, so you find the long parts before the day.
- A teleprompter and the presenter view. Your notes, big, on the screen you read from, following each click; and beside the slide, the notes, the next slide and the timer.
- ✦ Copilot can quiz you on your notes while you rehearse a hosted deck.
- Glossary cards. The first mention of a term links to its definition, so you, and later the room, never lose the thread.
Present it
Walk on stage with everything at your fingertips.
- The presenter view: notes, timer, next slide, drawing, camera and recording, and a share window for video calls.
- Your phone is the remote. A live copy of the slide, your notes, the timer, a laser and a pen, and an air pointer you aim by moving the phone, paired by a QR code. It works from a static host too. Phone remote
- ✦ Copilot in the presenter view of a hosted deck. Ask it to go to the results slide, black out the screen, circle the total on this slide, or tell you what's in your notes here.
- Laser, spotlight, pen, zoom, blackout. A built deck presents offline, and exports to PDF, PNG and PPTX.
Own the room
Keep every seat with you.
- The audience joins from their phones, from a link or the QR code on your slide, with no app and no sign-in, and follows along. The room runs on deck.kadal.cc or on your own server. The live room
- Live polls, quizzes, word clouds, Q&A with upvotes, reactions, a pace check and a raised hand, all written as components in your deck.
- Afterwards, see how it went. Every hosted deck counts its views; paid plans add the time spent on each slide, and Pro and Team keep the sessions and their peak audience, the questions, reactions and poll results. Analytics
Open source, on your side. The engine is AGPL. One deck.mdx, in git, published with one command. AI on your own
key: nothing sold, no lock-in. Hosting is free for public decks,
with paid plans from $4 a month.
Start in 30 seconds
You need Node 20.19 or later.
npm create @kadal/deck@latest my-talk
cd my-talk && npm install
npm run dev # http://localhost:5173: edit deck.mdx and the slide you're on updates in place
A deck is one deck.mdx file: Markdown, split into slides at ---, with components when you need
them.
---
title: Hello, room
theme: ocean
---
# Hello, room
---
## One point at a time
<Clicks>
- Slides split at `---`; a slide below this one starts at `----`
- Code steps line by line, and the notes follow your clicks
</Clicks>
---
<Poll id="lunch" question="Lunch?" options={["Dosa", "Biryani", "Both"]} />
When it's ready:
npx kadal-deck build # dist/: a static site for any host, works offline
npx kadal-deck export # PDF in export/ (add --png or --pptx)
npx kadal-deck publish # a URL on deck.kadal.cc with a live room (free plan)
Rather not install anything? Write it in the builder on
deck.kadal.cc. Already have a Slidev or reveal.js deck? npx kadal-deck import slidev slides.md or
npx kadal-deck import reveal index.html converts it and writes a report of anything that didn't
carry over.
Everything in the engine
| Writing (docs) | MDX slides, 19 layouts with named slots, frontmatter per slide, src: includes, glossary terms the compiler links on first mention |
| Clicks and motion (docs) | <Click>, <Clicks>, at="+2", notes that follow your clicks, 7 transitions (a different one in and out if you like), auto-animate, <Motion> |
| Code (docs) | Shiki highlighting stepped line by line, magic move, Monaco editors, runnable JS/TS/Python, TwoSlash hovers, code groups, snippet imports |
| Maths, diagrams, sketches (docs) | KaTeX at build time, Mermaid in the deck's colours, Excalidraw drawings revealed region by region |
| Looks (docs) | 17 themes in light and dark, 28 built-in backgrounds (most of them animated), the Pro library of 95 backgrounds and layouts on deck.kadal.cc, 200,000 icons through Iconify, Tailwind |
| Media (docs) | Images, video and sound that know your clicks, stickers, GIFs and memes, Lottie animations, 3D models you can turn, colour grading with a .cube LUT, tiled patterns behind a slide, and Kadal Store's media credited for you |
| Any framework (docs) | React and web components built in; Vue, Svelte, Solid, Preact, Qwik, Angular, Fresh, Rust/WebAssembly and Python as islands, each loaded only when its slide appears |
| Rehearsing (docs) | Narration that reads the notes and turns the pages, per-slide timings with a pacing badge, a teleprompter window, glossary cards |
| Presenting (docs) | Presenter view with notes, timer and next slide; drawing, laser, spotlight, blackout, camera, recording; a share window for video calls; a phone remote; vim keys |
| The live room (docs) | The audience follows on their phones: reactions, questions with upvotes, polls, word clouds, timed quizzes, a pace dial and a raised hand |
| Export (docs) | PDF, PNG and PPTX, with or without each click step; a static build that works offline |
Backgrounds and layouts
The Pro library. 95 backgrounds and layouts in 15 genres — board-pack covers, KPI boards, magazine spreads, terminal covers, lecture outlines, synthwave grids, wedding invitations — each in light and dark, each wearing your deck's theme. One line of frontmatter picks one:
---
layout: pro/kpi-board
background: pro/neon-drift
---
The library renders on decks published to deck.kadal.cc from a
Pro or Team workspace. Anywhere else — a static build on your own host, or the free plan — a
pro/ name falls back to the theme's own background and the default layout, so the slide still
reads; only the dev server says why, in a small chip. Every item, moving, in light and dark:
deck.kadal.cc/library.
Built in, free everywhere. 28 backgrounds ship with the engine — background: aurora, or
<Background name="aurora" /> inside a slide — most of them animated, all paused off-slide and
still under reduced motion. A few of them:
Themes
Sixteen themes, each in light and dark where it makes sense. Three are built in; the rest are
packages you install and name in the headmatter (theme: ocean). Browse them all at
deck.kadal.cc/themes.
Classic, seriph, crisp, bricks and shibainu are ports of the official Slidev themes, MIT-licensed,
with credit to their authors in each package. npm create @kadal/deck@latest -- --theme <name>
starts a theme of your own; the contract is THEMES.md.
Kadal Deck MCP questions
How do I add Kadal Deck MCP to Claude Code?
Run claude mcp add deck -- npx -y @kadal/deck in your terminal. Add --scope user to make it available in every project.
How do I add Kadal Deck MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Does the presentation work offline?
Yes, you can build a deck that presents offline and export it to various formats like PDF, PNG, and PPTX.