The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Deckrun MCP listing page.
Note: The hosted Deckrun endpoints (
free.agenticdecks.com,deckrun-mcp-free.agenticdecks.com,api.agenticdecks.com) are provisioned per engagement — see Access & Availability. Thepip install deckrun-mcppackage and local-execution paths documented below work immediately against your own deployment. For hosted access, open an Access Request — we respond within one business day.
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.
Install: pip install deckrun-mcp
The HTTP transport is hosted and ready. Add one JSON snippet to your IDE.
.vscode/mcp.json in your project (this file is included in the repo):
.cursor/mcp.json in your project:
~/.gemini/antigravity/mcp_config.json:
~/.claude/settings.json:
Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json:
Paid tier — add the API key:
Get your API key at agenticdecks.com after subscribing.
| 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) |
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 |
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.
| 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.
pip install deckrun-mcp