Metadata-Version: 2.4
Name: deckrun-mcp
Version: 1.1.1
Summary: MCP server for Deckrun by Agentic Decks — generate presentation PDFs, narrated videos, and audio from Markdown. Works with Claude Code, Cursor, VS Code, and any MCP-compatible AI assistant. Free tier: no API key needed. Paid tier: video, audio, custom themes, and more.
Author-email: Agentic Decks <contact@agenticdecks.com>
License-Expression: MIT
Project-URL: Homepage, https://agenticdecks.com
Project-URL: Documentation, https://agenticdecks.com/docs
Project-URL: Free Tier, https://free.agenticdecks.com
Project-URL: Slide Background Designer, https://free.agenticdecks.com/tools/bg-designer.html
Project-URL: Pricing, https://agenticdecks.com/pricing
Project-URL: Blog: Free PDF from Claude Code, https://agenticdecks.com/blog/free-pdf-with-deckrun-mcp/
Project-URL: Repository, https://github.com/agenticdecks/deckrun-mcp
Project-URL: Issues, https://github.com/agenticdecks/deckrun-mcp/issues
Keywords: mcp,deckrun,pdf,slides,presentations,ai-agents,model-context-protocol
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Multimedia :: Graphics :: Presentation
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp[cli]>=1.1.0
Requires-Dist: uvicorn
Requires-Dist: starlette
Requires-Dist: requests
Dynamic: license-file

# Deckrun MCP Server

[![PyPI](https://img.shields.io/pypi/v/deckrun-mcp)](https://pypi.org/project/deckrun-mcp/)
[![awesome-mcp-servers](https://img.shields.io/badge/awesome--mcp--servers-listed-FC60A8)](https://github.com/punkpeye/awesome-mcp-servers)

MCP server for [Deckrun](https://agenticdecks.com) by [Agentic Decks](https://agenticdecks.com) — 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](https://free.agenticdecks.com).
**Paid tier:** set `DECKRUN_API_KEY` to unlock video, audio, custom themes, and more. [See pricing](https://agenticdecks.com/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):

```json
{
  "servers": {
    "deckrun": {
      "type": "http",
      "url": "https://deckrun-mcp-free.agenticdecks.com/mcp/"
    }
  }
}
```

### Cursor

`.cursor/mcp.json` in your project:

```json
{
  "mcpServers": {
    "deckrun": {
      "url": "https://deckrun-mcp-free.agenticdecks.com/mcp/"
    }
  }
}
```

### Google Antigravity (Gemini CLI)

`~/.gemini/antigravity/mcp_config.json`:

```json
{
  "mcpServers": {
    "deckrun": {
      "serverUrl": "https://deckrun-mcp-free.agenticdecks.com/mcp/"
    }
  }
}
```

### Claude Code (terminal)

`~/.claude/settings.json`:

```json
{
  "mcpServers": {
    "deckrun": {
      "type": "http",
      "url": "https://deckrun-mcp-free.agenticdecks.com/mcp/"
    }
  }
}
```

---

## Stdio install (Claude Desktop and other stdio-only clients)

```bash
pip install deckrun-mcp
```

**Claude Desktop** — `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "deckrun": {
      "command": "python",
      "args": ["/path/to/deckrun_mcp.py"]
    }
  }
}
```

**Paid tier** — add the API key:

```json
{
  "mcpServers": {
    "deckrun": {
      "command": "python",
      "args": ["/path/to/deckrun_mcp.py"],
      "env": { "DECKRUN_API_KEY": "dk_live_..." }
    }
  }
}
```

Get your API key at [agenticdecks.com](https://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](https://agenticdecks.com) — product homepage
- [Free tier](https://free.agenticdecks.com) — generate PDFs instantly, no sign-up
- [Slide Background Designer](https://free.agenticdecks.com/tools/bg-designer.html) — free tool to design slide backgrounds
- [Blog: Generate a Free PDF from Claude Code](https://agenticdecks.com/blog/free-pdf-with-deckrun-mcp/) — step-by-step guide
- [Slide format reference](https://agenticdecks.com/deckrun) — layout tags, syntax rules, examples
- [Pricing](https://agenticdecks.com/pricing) — plans from $25/month
- [Documentation](https://agenticdecks.com/docs) — API docs and how-to guides
- [PyPI](https://pypi.org/project/deckrun-mcp/) — `pip install deckrun-mcp`
