deckrun-mcp

Deckrun MCP Server

 

Note: The hosted Deckrun endpoints (free.agenticdecks.com, deckrun-mcp-free.agenticdecks.com, api.agenticdecks.com) are provisioned per engagement — see Access & Availability. The pip install deckrun-mcp package 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

---

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