Io.Github.Headdao/Slidemaster
FreeNot checkedMCP (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
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
Install Io.Github.Headdao/Slidemaster in Claude Desktop, Claude Code & Cursor
unyly install io-github-headdao-slidemaster-mcpInstalls 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-serverFAQ
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
GitHub
PRs, issues, code search, CI status
by GitHubFilesystem
Secure file operations with configurable access controls.
Memory
Knowledge graph-based persistent memory system.
Template MCP Server
A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure
by mcpdotdirectCompare 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
