Command Palette

Search for a command to run...

UnylyUnyly
Browse all

Io.Github.Headdao/Slidemaster

FreeNot checked

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 pres

GitHubEmbed

About

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.

README

@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.

Quick Start

1. Get an API Key

Sign in to SlideMaster and generate a key at Settings > API Keys.

2. Configure Claude Desktop

Add the following to your 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": "your-api-key-here"
      }
    }
  }
}

3. Restart Claude Desktop

After saving the config, restart Claude Desktop. You should see the SlideMaster tools available in the tool picker.

Local Development

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run the server (stdio transport)
SLIDEMASTER_API_KEY=your-key npm start

Environment Variables

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

Tools (20 total)

Content Creation

Tool Method Endpoint Description
generate_outline POST /outlines/generate Generate a presentation outline from a topic
create_project POST /projects Create a new project
upload_init POST /upload/init Initialize a file upload session (PPTX/PDF)
upload_complete POST /upload/complete Mark an upload as complete
render_slides POST /slides/render Render AI-generated slide images

Content Processing

Tool Method Endpoint Description
generate_script POST /scripts/generate Generate a narration script for one slide
batch_generate_scripts POST /scripts/batch-generate Generate scripts for all slides in a project
generate_tts POST /tts/generate Generate text-to-speech audio
generate_video POST /video/generate Compile the final video

Management

Tool Method Endpoint Description
list_projects GET /projects List all projects (paginated)
get_project GET /projects/{id} Get project details
update_project PATCH /projects/{id} Update project properties
delete_project DELETE /projects/{id} Delete a project
list_slides GET /projects/{id}/slides List slides in a project
update_slide PATCH /slides/{id} Update a slide's title or script
delete_slide DELETE /slides/{id} Delete a slide

Query & Export

Tool Method Endpoint Description
check_status GET /projects/{id}/status Check project processing status
export_project GET /projects/{id}/export Export project with download URLs
list_voices GET /voices List available TTS voices

Automation

Tool Method Endpoint Description
topic_to_video POST /pipelines/topic-to-video End-to-end: topic to finished video

Example Conversation

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

Claude: I'll create that presentation for you using SlideMaster.

[Calls generate_outline with topic="renewable energy in Taiwan", slides_count=5]

Here's the outline I generated:
1. Taiwan's Energy Landscape
2. Solar Power Expansion
3. Offshore Wind Development
4. Government Policy & Targets
5. Future Outlook

Let me now create the project and render the slides.

[Calls create_project with title="Renewable Energy in Taiwan"]
[Calls render_slides with the outline data]
[Calls batch_generate_scripts]
[Calls generate_tts]
[Calls generate_video]

Your video is being generated! Let me check the status.

[Calls check_status]

The video is ready! Here are your download links:

[Calls export_project]

- Video: https://...
- Slides: https://...

Alternatively, use the one-shot pipeline:

User: Make me a video about machine learning basics

Claude: I'll use the topic-to-video pipeline to handle everything in one step.

[Calls topic_to_video with topic="machine learning basics"]
[Polls check_status until complete]
[Calls export_project for download links]

Your video is ready!

API Documentation

Full API documentation is available at https://slidemaster.tw/api-docs.

License

MIT

from github.com/Headdao/slidemaster-mcp

Install Io.Github.Headdao/Slidemaster in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE
unyly install io-github-headdao-slidemaster-mcp

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add io-github-headdao-slidemaster-mcp -- npx -y @slidemaster/mcp-server

FAQ

Is Io.Github.Headdao/Slidemaster MCP free?

Yes, Io.Github.Headdao/Slidemaster MCP is free — one-click install via Unyly at no cost.

Does Io.Github.Headdao/Slidemaster need an API key?

No, Io.Github.Headdao/Slidemaster runs without API keys or environment variables.

Is Io.Github.Headdao/Slidemaster hosted or self-hosted?

A hosted option is available: Unyly runs the server in the cloud, no local setup required.

How do I install Io.Github.Headdao/Slidemaster in Claude Desktop, Claude Code or Cursor?

Open Io.Github.Headdao/Slidemaster on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Compare Io.Github.Headdao/Slidemaster with

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All development MCPs