Enables the conversion of Markdown documents into professional presentation PDFs, narrated videos, and audio files by utilizing a specific slide format specification for layouts and narration.
Deckrun MCP Server
MCP server for Deckrun — generate presentation PDFs, narrated videos, and audio from Markdown. Built for AI agents and IDEs.
Free tier: no API key required — generate PDFs instantly.
Paid tier: set DECKRUN_API_KEY to unlock video, audio, and account tools.
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 mcp requestsClaude 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 |
| Fetch the live slide format spec — layout tags, syntax rules, example Markdown |
| Convert Deckrun Markdown → PDF. Returns a public URL (90-day expiry) |
Paid tier (DECKRUN_API_KEY set)
All free tools plus:
Tool | Description |
| Markdown → narrated MP4 (async, returns |
| Slide notes → MP3 narration (async, returns |
| Poll async job status until |
| Plan name, render units used/remaining, active add-ons |
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 |
|
Paid |
|
Discovery: GET <endpoint> returns server metadata as JSON.