Metadata-Version: 2.4
Name: deckrun-mcp
Version: 1.0.0
Summary: MCP server for Deckrun — generate presentation PDFs, narrated videos, and audio from Markdown
Author-email: Agentic Decks <contact@agenticdecks.com>
License: MIT
Project-URL: Homepage, https://agenticdecks.com
Project-URL: Documentation, https://agenticdecks.com/docs
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: License :: OSI Approved :: MIT License
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

[![Glama](https://glama.ai/mcp/servers/agenticdecks/deckrun-mcp/badge)](https://glama.ai/mcp/servers/agenticdecks/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) — 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):

```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 mcp requests
```

**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 |

---

## 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/` *(coming soon)* |

Discovery: `GET <endpoint>` returns server metadata as JSON.

---

## Links

- [Slide format reference](https://agenticdecks.com/deckrun)
- [Pricing](https://agenticdecks.com/pricing)
- [Agentic Decks](https://agenticdecks.com)
