@pptalker/mcp-server

MCP (Model Context Protocol) server for PPTalker — enables AI agents to convert presentations into narrated videos with AI voiceover and subtitles.

Features

• Upload PowerPoint (.pptx/.ppt), PDF, or HTML slides
• AI-generate speaker notes optimized for TTS
• 50+ voices across 20+ languages (AWS Polly, Tencent TTS, voice cloning)
• Render HD video with synced narration and subtitles
• Poll status with backoff until video is ready

Quick Setup

Add to your MCP client (Claude Desktop, Claude Code, Cursor, etc.):

{
  "mcpServers": {
    "pptalker": {
      "command": "npx",
      "args": ["-y", "@pptalker/mcp-server"],
      "env": {
        "PPTALKER_API_KEY": "pptk_live_your_key_here"
      }
    }
  }
}

Get your API key at https://www.pptalker.com/profile

Tools

| Tool | Description | |------|-------------| | pptalker_upload_ppt | Upload .pptx/.ppt/.pdf/.html/.htm file to PPTalker | | pptalker_parse_ppt | Parse uploaded file → per-slide images + native speaker notes | | pptalker_create_video | Start video generation task (requires confirmed per-slide notes) | | pptalker_get_video_status | Poll task status, get download URL | | pptalker_list_voices | Browse available TTS voices | | pptalker_get_account | Check credits and plan info |

Notes generation is intentionally not exposed as an MCP tool. The previous pptalker_generate_notes endpoint was unstable and frequently timed out. Calling agents are expected to generate per-slide narration locally — extract slide text from the source file (PDF/HTML/PPTX) and apply the prompt template documented in pptalker-skill/SKILL.md ("Note Generation Prompt"). This keeps the workflow under the agent's control and removes a flaky network dependency.

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | PPTALKER_API_KEY | Yes | API key starting with pptk_live_ | | PPTALKER_API_BASE | No | Override API URL (default: https://api.pptalker.com) |

Example Usage

Once configured, ask your AI agent:

"Convert my-deck.pptx to a video with English narration"

The agent will automatically: check credits → upload → generate notes → select voice → render video → return download link.

Skill (Optional)

For enhanced workflow guidance, install the PPTalker skill in Claude Code:

claude install-skill https://github.com/nicekate/PPTalker/tree/main/pptalker-skill

Links

• Website: https://www.pptalker.com
• Agent page: https://www.pptalker.com/agents
• Skill: https://github.com/nicekate/PPTalker/tree/main/pptalker-skill
• Issues: https://github.com/nicekate/PPTalker/issues

License

MIT