MCP SERVER · OFFICIAL PROJECTGenerate a deck two ways — a themed PowerPoint from a theme ID, or custom-designed slides from a reference image or a style description — then add one- or two-voice narration and export the pages and audio as a ZIP.
LABSCO SUMMARY
The themed path is quick and hands back a PowerPoint; the design path is slower, asynchronous by default, and is the only one narration will attach to, which slides_generate_narration says in as many words. That is a choice to make at the start, because reversing it means regenerating. The job model is stated clearly enough to build against — poll every 20 seconds — and both jobs_get and themes_search are free of credit charge, so orientation and polling do not cost anything. The export URL expiring after an hour is the detail that will catch an unattended pipeline.
A slide generation server with two engines — a themed PowerPoint path and a design path — plus narration and export, coordinated through an asynchronous job model.
An API key in API_KEY. Narration attaches only to the design-engine jobs — slides_generate_narration states that the themed path does not support it — and the ZIP export needs a completed job that already has narration.
One command plus a key — npx 2slides-mcp, then supply credentials
USE CASES
Search the themes for something that suits the audience, then generate the PowerPoint from your prompt on that theme and take the download URL straight back.
Point the generator at one page of the existing deck as a reference image, set the aspect ratio and resolution you have to deliver in, and poll the job until the pages come back.
Describe the visual style in free text instead of picking a theme, let the page count be detected from the content or set it exactly, and poll for the result.
Add narration to the finished job — one narrator, or two named speakers trading the script — then export the pages, the audio per page and the transcript as one ZIP.
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
jobs_getGet 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.
slides_create_like_thisGenerate 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).
slides_create_pdf_slidesGenerate 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).
slides_download_pages_voicesExport 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.
slides_generateGenerate 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.
slides_generate_narrationAdd 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).
themes_searchSearch 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.
BEFORE YOU INSTALL
7 tools when we connected. themes_search, jobs_get and slides_download_pages_voices are free; slides_generate costs 1 credit per page, Nano Banana generators 100 per page (200 at 4K), narration 210. slides_generate_narration accepts only a completed Nano Banana job.
The documented client runs the server on your machine.
CONTEXT COST
Rated by the size of the 7 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
npx 2slides-mcp{
"mcpServers": {
"2slides": {
"command": "npx",
"args": [
"2slides-mcp"
],
"env": {
"API_KEY": "<YOUR_API_KEY>"
}
}
}
}MCP servers
