@slidemaster/mcp-server

@slidemaster/mcp-server

MCP (Model Context Protocol) Server for the SlideMaster Public API. This server exposes 20+ tools that let any MCP-compatible AI assistant create AI-powered presentation videos from a simple topic.

5-Minute Quick Start

Step 1: Get an API Key

• Go to slidemaster.tw and sign in with Google
• Click your avatar (top right) → Settings
• Navigate to API Keys
• Click Generate Key — copy the sm_live_... key

Step 2: Configure Your AI Client

Claude Desktop — add to claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "slidemaster": {
      "command": "npx",
      "args": ["-y", "@slidemaster/mcp-server"],
      "env": {
        "SLIDEMASTER_API_KEY": "sm_live_your_key_here"
      }
    }
  }
}

Step 3: Restart and Go

Restart your AI client. Then just say: "Make a 5-slide presentation about [your topic]"

Workflow

"Make slides about machine learning"
         │
         ▼
┌─────────────────┐
│ generate_outline │ ← Generates outline + auto-creates project
│                  │   Returns: project_id, slides array
└────────┬────────┘
         ▼
┌─────────────────┐
│  render_slides   │ ← Generates AI images for each slide
│                  │   Costs: 140 credits/slide (2K)
│                  │   Poll check_status until status="parsed"
└────────┬────────┘
         ▼
┌───────────────────────┐
│ batch_generate_scripts │ ← Generates narration scripts (optional)
└────────┬──────────────┘
         ▼
┌─────────────────┐
│  generate_tts    │ ← Text-to-speech audio (optional)
│                  │   Costs: 16 credits/slide
└────────┬────────┘
         ▼
┌─────────────────┐
│ generate_video   │ ← Compile final MP4 (optional)
│                  │   Costs: 80 credits/project
│                  │   Poll check_status until status="video_completed"
└────────┬────────┘
         ▼
┌─────────────────┐
│  export_pdf      │ ← Download as PDF (pdf_url field)
│  export_pptx     │ ← Download as PPTX (pptx_url field)
│  export_project  │ ← Get all download URLs
└─────────────────┘

Shortcut: Use topic_to_video to run the entire pipeline in one call.

Tip: generate_outline automatically creates a project — you do NOT need to call create_project separately.

Credits Reference

Operation	Cost per unit
Render slide (1K)	42 credits
Render slide (2K)	140 credits
Render slide (4K)	250 credits
TTS per slide	16 credits
Video per project	80 credits

Quick math: 2,000 credits ≈ 14 slides at 2K (slides only). A full 25-slide course with video ≈ 3,980 credits.

Call get_credit_balance before large projects to check remaining credits.

Status Values

When polling check_status, the status field means:

Status	Meaning	Next step
processing	Slides are being rendered	Poll again in 5-10 seconds
parsed	Slides ready, check scripts/audio	Call batch_generate_scripts or generate_tts
generating_video	Video being compiled	Poll again in 5-10 seconds
video_completed	Video ready	Call export_project for download URLs
video_failed	Video generation failed	Call generate_video to retry

Style Images

To apply a visual style, use analyze_style_image with a publicly accessible image URL (e.g. Imgur, Cloudinary). Base64 is not supported. The returned style_guide object can be passed to render_slides.

Tools (20+ total)

Content Creation

Tool	Description
generate_outline	Generate outline from topic. Auto-creates project — returns project_id
create_project	Create an empty project (usually not needed — use generate_outline)
render_slides	Generate AI slide images. Requires slides array with title + description
analyze_style_image	Analyze a style reference image (public URL required)
upload_init	Initialize PPTX/PDF file upload
upload_complete	Complete a file upload

Content Processing

Tool	Description
generate_script	Generate narration script for one slide
batch_generate_scripts	Generate scripts for all slides at once
generate_tts	Generate text-to-speech audio
generate_video	Compile slides + audio into MP4 video

Management

Tool	Description
list_projects	List all projects
get_project	Get project details
update_project	Update project settings (TTS voice, language, etc.)
delete_project	Permanently delete a project
list_slides	List slides in a project
update_slide	Edit slide title or script
delete_slide	Delete a slide

Export

Tool	Description
export_pdf	Export as PDF. Returns pdf_url (signed download link)
export_pptx	Export as PPTX. Returns pptx_url (signed download link)
export_project	Get all download URLs (slides, audio, video)
export_evercam	Export as offline HTML5 package
evercam_status	Poll EverCam export progress

Utilities

Tool	Description
check_status	Poll processing progress
get_credit_balance	Check remaining credits with cost breakdown
get_project_context	Full project snapshot in one call
list_voices	Browse available TTS voices
topic_to_video	One-click: topic → finished presentation/video

Example Conversation

User: Create a 5-slide presentation about renewable energy in Taiwan

Claude: I'll create that for you.

[Calls generate_outline with topic="renewable energy in Taiwan", slides_count=5]
→ Returns project_id and slides array

[Calls render_slides with the project_id and slides]
→ Rendering started, polling...

[Calls check_status — status: "parsed", all slides rendered]

[Calls export_pdf]
→ Returns pdf_url

Here's your presentation! Download the PDF: [link]

Local Development

npm install
npm run build
SLIDEMASTER_API_KEY=your-key npm start

Environment Variables

Variable	Required	Description
SLIDEMASTER_API_KEY	Yes	Your SlideMaster API key (sm_live_...)
SLIDEMASTER_API_BASE	No	Override API base URL (default: https://api.slidemaster.tw/api/v1/public)

API Documentation

Full API docs: slidemaster.tw/api-docs

License

MIT