sickn33/agentic-awesome-skills / plugins/agentic-awesome-skills-claude/skills/2slides-ppt-generator
2slides-ppt-generator
VerifiedAI-powered presentation generation via the 2slides API — create slides from text, match a reference image style, summarize documents into decks, add AI voice narration, and export pages/audio. Use for any "make slides", "create a deck", or "slides from this document" request.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.0 KB |
| references/api-reference.md | markdown | 13.0 KB |
| references/detailed-guide.md | markdown | 20.9 KB |
| references/mcp-integration.md | markdown | 8.7 KB |
| references/pricing.md | markdown | 6.5 KB |
| requirements.txt | manifest | 43 B |
| scripts/api_constants.py | script | 1.5 KB |
| scripts/create_pdf_slides.py | script | 5.7 KB |
| scripts/download_slides_pages_voices.py | script | 8.0 KB |
| scripts/generate_narration.py | script | 5.9 KB |
| scripts/generate_slides.py | script | 8.9 KB |
| scripts/get_job_status.py | script | 3.2 KB |
| scripts/search_themes.py | script | 3.4 KB |
references/mcp-integration.md
View on GitHub# MCP Integration Guide
Review update 2026-10-23: API/pricing examples below are a historical snapshot; verify the current [API](https://2slides.com/api.md) and [pricing](https://2slides.com/pricing) before billable calls. Subscription credits and purchased-package credits have different expiry rules. No live generation was tested.
2slides provides an MCP (Model Context Protocol) server for seamless integration with Claude Desktop and other MCP-compatible AI agents.
## What is the MCP Server?
The 2slides MCP server exposes the same API functionality as direct API calls, but through a standardized tool interface that Claude can use directly without requiring script execution.
**Available Tools:**
1. `slides_generate` - Generate slides from content
2. `slides_create_like_this` - Generate slides from reference image
3. `slides_create_pdf_slides` - Generate custom-designed slides (NEW)
4. `slides_generate_narration` - Add AI voice narration (NEW)
5. `slides_download_pages_voices` - Export slides and voices as ZIP (NEW)
6. `themes_search` - Search available themes
7. `jobs_get` - Check job status
**Note:** New tools (3-5) may require MCP server update to latest version.
## Installation & Configuration
2slides MCP server supports two integration modes:
### Mode 1: Streamable HTTP Protocol
Query-string API keys can leak through logs/history. Use the client-supported secret/header mechanism if the service supports it; if only query authentication is available, treat the entire URL as a credential and keep it out of shared configs, screenshots and logs. The native client configuration syntax varies; the JSON below is an upstream sketch, not verified for every Claude Desktop version.
Simplest setup using HTTP endpoint. No local installation required.
**Step 1:** Get your API key from https://2slides.com/api
**Step 2:** Configure Claude Desktop
Edit: `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
```json
{
"mcpServers": {
"2slides": {
"url": "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"
}
}
}
```
**Step 3:** Restart Claude Desktop completely
**Advantages:**
- ✅ No Node.js or npm required
- ✅ Always uses latest version
- ✅ Faster setup
- ✅ No local dependencies
---
### Mode 2: NPM Package (stdio)
Uses local npm package for MCP server.
**Step 1:** Get your API key from https://2slides.com/api
**Step 2:** Configure Claude Desktop
Edit: `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
```json
{
"mcpServers": {
"2slides": {
"command": "npx",
"args": ["2slides-mcp@<reviewed-exact-version>"],
"env": {
"API_KEY": "YOUR_2SLIDES_API_KEY"
}
}
}
}
```
**Step 3:** Restart Claude Desktop completely
**Requirements:**
- Node.js and npm installed
- Internet connection for first-time package download
---
### Verify Installation
After restart, the 2slides tools should be available. Test by asking:
"Search for business themes using 2slides"
## When to Use MCP vs Direct API
### Use MCP Server When:
- Working in Claude Desktop or other MCP-compatible environments
- Want seamless tool integration without script management
- Prefer Claude to handle API calls directly
- Need real-time interaction and feedback
### Use Direct API Scripts When:
- Working in Claude Code CLI
- MCP server is not configured or available
- Need more control over parameters and error handling
- Integrating into custom workflows or automation
- Need to batch process multiple requests
## MCP Tool Details
### slides_generate
Generate slides from user content.
**Parameters:**
- `userInput` (string, required): Content to convert
- `themeId` (string, required): Theme ID from themes_search
- `responseLanguage` (string, optional, default: "Auto"): Language name
- `mode` (string, optional, default: "sync"): "sync" or "async"
**Example:**
```
First search for a theme:
Use themes_search with:
- query: "business"
Then generate with the theme ID:
Use slides_generate with:
- userInput: "Introduction to Python: Variables, Functions, Classes"
- themeId: "theme_abc123"
- mode: "sync"
```
### slides_create_like_this
Generate slides matching a reference image.
**Parameters:**
- `userInput` (string, required): Content for slides
- `referenceImageUrl` (string, required): URL or base64 of reference image
- `responseLanguage` (string, optional, default: "Auto"): Language name
- `aspectRatio` (string, optional, default: "16:9"): width:height format
- `resolution` (string, optional, default: "2K"): "1K", "2K", or "4K"
- `page` (number, optional, default: 1): Number of slides (0 for auto-detection, max 100)
- `contentDetail` (string, optional, default: "concise"): "concise" or "standard"
**Example:**
```
Use slides_create_like_this with:
- userInput: "Sales Report Q4 2025"
- referenceImageUrl: "https://example.com/template.jpg"
- resolution: "2K"
- page: 0 # Auto-detect slide count
- contentDetail: "standard"
```
### themes_search
Search for available themes.
**Parameters:**
- `query` (string, required): Search keyword
- `limit` (number, optional, default: 20, max: 100): Max results
**Example:**
```
Use themes_search with:
- query: "business"
- limit: 10
```
**Note:** Query parameter is required. Search with keywords like "business", "professional", "creative", "education", "modern" to find appropriate themes.
### slides_create_pdf_slides
Generate custom-designed slides from text without a reference image.
**Parameters:**
- `userInput` (string, required): Content for slides
- `responseLanguage` (string, optional, default: "Auto"): Language name
- `aspectRatio` (string, optional, default: "16:9"): width:height format
- `resolution` (string, optional, default: "2K"): "1K", "2K", or "4K"
- `page` (number, optional, default: 1): Number of slides (0 for auto-detection, max 100)
- `contentDetail` (string, optional, default: "concise"): "concise" or "standard"
- `designStyle` (string, optional): Design specifications
**Example:**
```
Use slides_create_pdf_slides with:
- userInput: "Sales Report Q4 2025"
- designSpec: "modern minimalist, blue color scheme"
- resolution: "2K"
- page: 0 # Auto-detect slide count
```
### slides_generate_narration
Add AI voice narration to completed slides.
**Parameters:**
- `jobId` (string, required): Job ID from slide generation (UUID format)
- `language` (string, optional, default: "Auto"): Language for narration
- `voice` (string, optional, default: "Puck"): Voice name (30 options available)
- `multiSpeaker` (boolean, optional, default: false): Enable multi-speaker mode
**Available Voices:**
Puck, Aoede, Charon, Kore, Fenrir, Zephyr, Leda, Orus, Callirrhoe, Autonoe, Enceladus, Iapetus, Umbriel, Algieba, Despina, Erinome, Algenib, Rasalgethi, Laomedeia, Achernar, Alnilam, Schedar, Gacrux, Pulcherrima, Achird, Zubenelgenubi, Vindemiatrix, Sadachbia, Sadaltager, Sulafat
**Example:**
```
Use slides_generate_narration with:
- jobId: "abc-123-def-456"
- voice: "Aoede"
- multiSpeaker: true
- language: "English"
```
**Note:** Job must be completed before adding narration. Cost: 210 credits per page.
### slides_download_pages_voices
Download slides as PNG images and voice files as WAV in a ZIP archive.
**Parameters:**
- `jobId` (string, required): Job ID from slide generation
**Example:**
```
Use slides_download_pages_voices with:
- jobId: "abc-123-def-456"
```
**Note:** Completely FREE (no credits). Download URL valid for 1 hour.
### jobs_get
Check status of async job.
**Parameters:**
- `jobId` (string, required): Job ID from async generation
**Response includes:**
- Slide generation status
- Narration status (if applicable)
- Download URLs (when completed)
**Example:**
```
Use jobs_get with:
- jobId: "abc123..."
```
## Troubleshooting
### Tools Not Appearing
1. Verify configuration file syntax is valid JSON
2. For HTTP mode: Check API key is correctly in the URL
3. For npm mode: Ensure API key is correctly set in the `env` section
4. Restart Claude Desktop completely (quit fully, not just close window)
5. Check for error messages in Claude Desktop console
### API Key Issues
- Verify API key is active at https://2slides.com/api
- Check for typos in the configuration
- Ensure no extra quotes or spaces around the key
- For HTTP mode: API key must be in the URL query parameter
### HTTP Mode Issues
- Verify URL format: `https://2slides.com/api/mcp?apikey=YOUR_KEY`
- Check internet connectivity
- Ensure API key has no special characters that need URL encoding
### NPM Mode Issues
- Ensure `npx` is available (requires Node.js)
- Try running `npx 2slides-mcp` manually to check for errors
- Verify internet connection for package download
- Check Node.js version compatibility
## GitHub Repository
For more information, visit: https://github.com/2slides/mcp-2slides
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| canvas-designanthropics/skillsCreate beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| docxanthropics/skillsUse this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| pdfanthropics/skillsUse this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| pptxanthropics/skillsUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions "deck," "slides," "presentation," or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |