Deckrun Free — MCP Server

Generate PDF slide decks from Markdown using any MCP-compatible AI client. Free. No authentication required.

• API: https://free.agenticdecks.com/free/generate
• Max: 10 slides, 50 KB Markdown
• Output: Public PDF URL, valid 90 days

Install

Via Smithery (easiest — auto-configures your client)

# Claude Desktop
npx @smithery/cli install @agenticdecks/deckrun-free --client claude

# Cursor
npx @smithery/cli install @agenticdecks/deckrun-free --client cursor

# VS Code (GitHub Copilot)
npx @smithery/cli install @agenticdecks/deckrun-free --client vscode

# OpenAI Codex CLI
npx @smithery/cli install @agenticdecks/deckrun-free --client codex

Server page: https://smithery.ai/servers/agenticdecks/deckrun-free

Google Antigravity

Add to ~/.gemini/antigravity/mcp_config.json (no local Python install needed):

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

Manual install

pip install mcp requests

Manual Setup

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "deckrun-free": {
      "command": "python",
      "args": ["/path/to/deckrun_mcp_server.py"]
    }
  }
}

Restart Claude Desktop. Then ask: "Create a 6-slide deck on quantum computing."

Cursor

Edit .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "deckrun-free": {
      "command": "python",
      "args": ["/path/to/deckrun_mcp_server.py"]
    }
  }
}

VS Code (GitHub Copilot)

In .vscode/settings.json:

{
  "github.copilot.chat.mcp.servers": {
    "deckrun-free": {
      "command": "python",
      "args": ["/path/to/deckrun_mcp_server.py"]
    }
  }
}

Tools

Tool	Description
get_slide_format	Fetches live Deckrun slide format spec. Call this first.
generate_slide_deck	Converts Deckrun Markdown to PDF. Returns url, slides, warnings.

Resources

URI	Content
deckrun-free://skill	OpenClaw/ClawHub skill YAML for agent registries
deckrun-free://openapi	Live OpenAPI spec for /free/generate

How it works

Claude (in your IDE)
  → calls get_slide_format  → fetches live schema from agenticdecks.com
  → writes Deckrun Markdown in context window
  → calls generate_slide_deck(markdown)
      → POST https://free.agenticdecks.com/free/generate
      ← {"url": "...", "slides": 6, "warnings": [], "schema_version": "deckrun.v1"}
  ← "Your PDF is ready: https://..."

Links

• agenticdecks.com — product overview
• free.agenticdecks.com — web UI
• API spec
• Community / paid plans