Generate presentation PDFs, narrated videos, and audio from Markdown.
Deckrun MCP Server
MCP server for Deckrun by Agentic Decks — generate presentation PDFs, narrated videos, and audio from Markdown. Built for AI agents and IDEs.
Deckrun is a document execution engine: your AI writes the content, Deckrun renders it into pixel-perfect branded PDFs, narrated MP4 videos, and MP3 audio — from a single Markdown source. No slide editor, no video tool, no audio studio.
Free tier: no API key required — generate PDFs instantly at free.agenticdecks.com.
Paid tier: set DECKRUN_API_KEY to unlock video, audio, custom themes, and more. See pricing.
Install: pip install deckrun-mcp
Quickstart — no install needed
The HTTP transport is hosted and ready. Add one JSON snippet to your IDE.
VS Code (GitHub Copilot Chat — v1.99+)
.vscode/mcp.json in your project (this file is included in the repo):
{
"servers": {
"deckrun": {
"type": "http",
"url": "https://deckrun-mcp-free.agenticdecks.com/mcp/"
}
}
}
Cursor
.cursor/mcp.json in your project:
{
"mcpServers": {
"deckrun": {
"url": "https://deckrun-mcp-free.agenticdecks.com/mcp/"
}
}
}
Google Antigravity (Gemini CLI)
~/.gemini/antigravity/mcp_config.json:
{
"mcpServers": {
"deckrun": {
"serverUrl": "https://deckrun-mcp-free.agenticdecks.com/mcp/"
}
}
}
Claude Code (terminal)
~/.claude/settings.json:
{
"mcpServers": {
"deckrun": {
"type": "http",
"url": "https://deckrun-mcp-free.agenticdecks.com/mcp/"
}
}
}
Stdio install (Claude Desktop and other stdio-only clients)
pip install deckrun-mcp
Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"deckrun": {
"command": "python",
"args": ["/path/to/deckrun_mcp.py"]
}
}
}
Paid tier — add the API key:
{
"mcpServers": {
"deckrun": {
"command": "python",
"args": ["/path/to/deckrun_mcp.py"],
"env": { "DECKRUN_API_KEY": "dk_live_..." }
}
}
}
Get your API key at agenticdecks.com after subscribing.
Tools
Free tier (no key required)
| Tool | Description |
|---|---|
get_slide_format |
Fetch the live slide format spec — layout tags, syntax rules, example Markdown |
generate_slide_deck |
Convert Deckrun Markdown → PDF. Returns a public URL (90-day expiry) |
Paid tier (`DECKRUN_API_KEY` set)
All free tools plus:
| Tool | Description |
|---|---|
generate_video |
Markdown → narrated MP4 (async, returns job_id) |
generate_audio |
Slide notes → MP3 narration (async, returns job_id) |
check_job |
Poll async job status until complete or failed |
get_account |
Plan name, render units used/remaining, active add-ons |
validate_markdown |
Lint Deckrun Markdown and get a pre-flight RU estimate |
list_themes |
List available slide/document themes (system + custom) |
list_voices |
List available narration voices — id, name, tier, language |
Example prompt
Once configured, ask your AI:
"Create a 6-slide deck on the future of edge computing"
The AI will call get_slide_format to learn the syntax, write the Markdown,
call generate_slide_deck, and reply with a clickable PDF link.
HTTP endpoints
| Tier | MCP endpoint |
|---|---|
| Free | https://deckrun-mcp-free.agenticdecks.com/mcp/ |
| Paid | https://deckrun-mcp.agenticdecks.com/mcp/ |
Discovery: GET <endpoint> returns server metadata as JSON.
Links
- Agentic Decks — product homepage
- Free tier — generate PDFs instantly, no sign-up
- Slide Background Designer — free tool to design slide backgrounds
- Blog: Generate a Free PDF from Claude Code — step-by-step guide
- Slide format reference — layout tags, syntax rules, examples
- Pricing — plans from $25/month
- Documentation — API docs and how-to guides
- PyPI —
pip install deckrun-mcp
Tools (9)
get_slide_formatFetch the live slide format spec including layout tags, syntax rules, and example Markdown.generate_slide_deckConvert Deckrun Markdown into a PDF and return a public URL.generate_videoConvert Markdown into a narrated MP4 video.generate_audioConvert slide notes into MP3 narration.check_jobPoll async job status until complete or failed.get_accountRetrieve plan details, render units used, and active add-ons.validate_markdownLint Deckrun Markdown and get a pre-flight render unit estimate.list_themesList available slide and document themes.list_voicesList available narration voices including ID, name, tier, and language.Environment Variables
DECKRUN_API_KEYAPI key required to unlock video, audio, custom themes, and account tools.Configuration
{"mcpServers": {"deckrun": {"command": "python", "args": ["/path/to/deckrun_mcp.py"], "env": {"DECKRUN_API_KEY": "dk_live_..."}}}}