2slides MCP Server

@2slides

About 2slides MCP Server

2Slides is a modern AI-driven presentation generation agent. It automatically generates professional slide presentations based on user input (raw text or content intention), supporting multiple template types and themes.

#2slides #ai-slides #ai-ppt #ai-presentation

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "2slides": {
      "command": "npx",
      "args": [
        "2slides-mcp"
      ],
      "env": {
        "API_KEY": "YOUR_2SLIDES_API_KEY"
      }
    }
  }
}

Tools

Generate a PowerPoint presentation using pre-built themes (Fast PPT). Use themes_search first to get a themeId. mode='sync' (default) returns downloadUrl immediately; mode='async' returns a jobId to poll with jobs_get. responseLanguage defaults to 'Auto' (auto-detect); supported values: Auto, English, Spanish, Arabic, Portuguese, Indonesian, Japanese, Russian, Hindi, French, German, Greek, Vietnamese, Turkish, Thai, Polish, Italian, Korean, Simplified Chinese, Traditional Chinese. Credits: 1 per page.

Get job status and result by jobId. Poll every 20 seconds until status is 'success' or 'failed'. Response fields: jobId, status (pending/processing/success/failed), message, downloadUrl (when success), slidePageCount, createdAt, updatedAt, duration (ms), jobUrl (Nano Banana jobs only). Free — no credits charged.

Search pre-built themes for slides_generate (Fast PPT). Returns theme objects with id, name, description, previewUrl, and tags. Use the returned id as themeId in slides_generate. limit defaults to 10, max 100. Free — no credits charged.

Generate slides (Nano Banana) that match the style of a reference image. mode defaults to 'async' — returns jobId to poll with jobs_get; 'sync' returns downloadUrl immediately. aspectRatio valid values: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 (default), 21:9. resolution: '1K', '2K' (default), '4K'. page: 0=auto-detect (default), 1-100=exact count. contentDetail: 'concise' or 'standard' (default). responseLanguage defaults to 'Auto'. Credits: 100 per page (1K/2K) or 200 per page (4K).

Generate custom-designed slides (Nano Banana) from text content without a reference image. mode defaults to 'async' — returns jobId to poll with jobs_get; 'sync' returns downloadUrl immediately. designStyle is optional free-text describing the visual style (leave empty for default styling). aspectRatio valid values: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 (default), 21:9. resolution: '1K', '2K' (default), '4K'. page: 0=auto-detect (default), 1-100=exact count. contentDetail: 'concise' or 'standard' (default). responseLanguage defaults to 'Auto'. Credits: 100 per page (1K/2K) or 200 per page (4K).

Add AI voice narration to a completed Nano Banana job (slides_create_like_this or slides_create_pdf_slides only; Fast PPT not supported). Async only — poll result with jobs_get. mode='single' (default): one narrator (speakerName, voice, contentMode, includeIntro). mode='multi': two narrators (speaker1Name and speaker2Name are required; speaker1Voice, speaker2Voice, contentMode optional). contentMode: 'concise' or 'standard' (default). includeIntro: true (default) or false. All 30 supported 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. Credits: 210 per page (10 text + 200 audio).

Export slide pages and audio narration as a ZIP file. The job must be completed and have narration generated (slides_generate_narration). ZIP contains: pages/ (page_01.png, page_02.png, …), voices/ (page_01.wav, page_02.wav, …), transcript.txt. Returns downloadUrl (expires in 1 hour), fileName, and expiresIn (3600 seconds). Free — no credits charged.

Overview

What is 2slides MCP Server?

It integrates 2slides.com’s slide generation and management tools with MCP clients such as Claude Desktop, allowing users to create presentations, check job status, and search themes programmatically.

How to use 2slides MCP Server?

Obtain an API key from 2slides.com/api, then add the configuration to Claude Desktop’s claude_desktop_config.json with the command npx, arguments ["2slides-mcp"], and environment variable API_KEY. Restart Claude Desktop and the tools appear in the tools panel.

Key features of 2slides MCP Server

slides_generate: create slides from theme, input, and language.
jobs_get: poll job status and retrieve download URL.
themes_search: search available themes by query with optional limit.
Returns 2slides API JSON as formatted text.
Configuration via standard MCP stdio transport.
Only logs errors to stderr, avoiding stdout interference.

Use cases of 2slides MCP Server

Automatically generate slide decks from plain text descriptions.
Monitor long-running slide generation jobs asynchronously.
Browse and select themes before initiating a slide creation.
Integrate presentation creation into AI-assisted workflows.

FAQ from 2slides MCP Server

How do I get an API key?

Visit 2slides.com/api to request an API key.

What tools does this server provide?

Three tools: slides_generate (create slides), jobs_get (check job status), and themes_search (search themes).

How do I retrieve generated slides?

Call slides_generate to start a job, then poll with jobs_get using the returned jobId. When the job completes, the response includes a downloadUrl.

What transport does the server use?

It uses stdio transport, launched by npx from the command line.

Where are my slide data processed?

The tools call the 2slides.com API, so slide data is sent to and processed on 2slides servers.

Frequently asked questions

How do I get an API key?

Visit 2slides.com/api to request an API key.

What tools does this server provide?

Three tools: `slides_generate` (create slides), `jobs_get` (check job status), and `themes_search` (search themes).

How do I retrieve generated slides?

Call `slides_generate` to start a job, then poll with `jobs_get` using the returned `jobId`. When the job completes, the response includes a `downloadUrl`.