

Use Any AI Agent with the 2Slides MCP Server: The Complete 2026 Guide
Quick answer (โค60 words): The 2Slides MCP server lets any MCP-capable AI agent generate real PowerPoint files. It runs two ways: stdio (
with annpx 2slides-mcpenv var) and Streamable HTTP (API_KEY). Get a key at 2slides.com/api, add the server to your agent โ Claude Code, Codex, OpenClaw, Gemini CLI, Qwen Code, and more โ and ask for a deck.https://2slides.com/api/mcp?apikey=KEY
Every modern AI agent can write a slide outline. None of them, on their own, can hand you a real, editable
.pptxWrite the server config once and the same tools light up in whichever agent you use. This guide explains the two transports, shows which clients are supported, and links to a step-by-step setup for each.
What is the 2Slides MCP server?
It's a small connector that exposes 2Slides' slide-generation APIs as MCP tools. Once an agent is connected, it can call:
| Tool | What it does | Credits |
|---|---|---|
themes_search | Find a themeId | Free |
slides_generate | Theme-based PowerPoint (Fast PPT), sync/async | 10 / page |
slides_create_pdf_slides | Custom image-designed slides from text (Nano Banana) | 100 / page (1K/2K), 200 (4K) |
slides_create_like_this | Slides matching a reference image's style | 100 / page (1K/2K), 200 (4K) |
slides_generate_narration | Add AI voice narration to a Nano Banana job | 210 / page |
slides_download_pages_voices | Export pages + audio as a ZIP | Free |
jobs_get | Poll an async job to completion | Free |
The agent does the thinking โ reading your files, structuring the argument, writing the copy. The server does the file. You ask in plain language; a download URL comes back in ~30โ60 seconds.
The two transports: stdio vs Streamable HTTP
The 2Slides MCP server supports both protocols. They expose identical tools and differ only in where the connector runs.
| Stdio Protocol | Streamable HTTP Protocol | |
|---|---|---|
| Where it runs | Locally, via npx 2slides-mcp | Remotely, hosted by 2Slides |
| Needs Node.js locally | Yes | No |
| Auth | API_KEY | ?apikey=Authorization |
| Endpoint / command | npx 2slides-mcp | https://2slides.com/api/mcp?apikey=KEY |
| Best for | Local dev, full control, offline-friendly | CI, containers, remote boxes, thin clients |
Generic stdio config (the shape most clients accept):
{ "mcpServers": { "2slides": { "command": "npx", "args": ["2slides-mcp"], "env": { "API_KEY": "YOUR_2SLIDES_API_KEY" } } } }
Generic Streamable HTTP: point your client at
https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEYhttpUrlurltransport: "streamable-http"--transport httpurlGrab your key, a ready-to-paste config, and the endpoint at 2slides.com/api?tab=mcp.
Supported agents at a glance
| Agent / client | Config location | Stdio | Streamable HTTP | Setup guide |
|---|---|---|---|---|
| Claude Code | .mcp.jsonclaude mcp add | โ | โ
(--transport http | Guide โ |
| OpenAI Codex | ~/.codex/config.toml | โ | โ
(url | Guide โ |
| OpenClaw | ~/.openclaw/openclaw.jsonmcp.servers | โ | โ
(transport: streamable-http | Guide โ |
| Gemini CLI | ~/.gemini/settings.json | โ | โ
(httpUrl | Guide โ |
| Qwen Code | ~/.qwen/settings.json | โ | โ
(httpUrl | Guide โ |
| Claude Desktop | claude_desktop_config.json | โ | โ | Guide โ |
| Kimi (Moonshot) | via Kimi CLI or Claude Code | โ | โ | See "Kimi & MiniMax" below |
| MiniMax | via Mini-Agent or Claude Code | โ | โ | See "Kimi & MiniMax" below |
Each linked guide has the exact config blocks, the one-line
... mcp addPick your agent
- Claude Code โ Anthropic's CLI. , or
claude mcp add --env API_KEY=xxx --transport stdio 2slides -- npx 2slides-mcpfor remote. Scopes for personal vs team use.--transport http - OpenAI Codex โ a block in
[mcp_servers.2slides], orconfig.toml. Remote via acodex mcp add 2slides --env API_KEY=xxx -- npx 2slides-mcpblock.url - OpenClaw โ one entry under in
mcp.servers; verify withopenclaw.json. Tools surface in theopenclaw mcp probe 2slides --json/codingprofiles.messaging - Gemini CLI โ in
mcpServers(settings.jsonfor remote), orhttpUrl.gemini mcp add - Qwen Code โ same shape in ; strong for Chinese-language decks.
~/.qwen/settings.json
Kimi and MiniMax: two extra paths
Neither Kimi (Moonshot) nor MiniMax is itself a polished MCP-native CLI in the same way as the agents above, but both reach the 2Slides MCP server through two reliable routes:
-
Drive a coding agent with their model. Both expose an Anthropic-compatible endpoint, so you can run Claude Code against them and attach 2Slides through Claude Code's own MCP config:
# Kimi K2 via Moonshot export ANTHROPIC_BASE_URL="https://api.moonshot.ai/anthropic" export ANTHROPIC_AUTH_TOKEN="YOUR_MOONSHOT_KEY" claude # then: claude mcp add ... 2slides -- npx 2slides-mcp # MiniMax export ANTHROPIC_BASE_URL="https://api.minimax.io/anthropic" export ANTHROPIC_AUTH_TOKEN="YOUR_MINIMAX_KEY" claude -
Use their own agent runtime. Moonshot ships the Kimi CLI (a native MCP client with a standard
/mcpServersconfig), and MiniMax publishes the open-source Mini-Agent, which reads a standard~/.kimi/mcp.json. In both, add 2Slides exactly like the generic stdio or Streamable HTTP block above.mcp.json
Either way, the 2Slides tools are identical โ only the host agent changes.
A worked example (any agent)
The interaction is the same regardless of client. You ask:
Read ./Q3-report.md and build a 12-slide executive summary. Find a clean business theme from 2slides, generate the PowerPoint, then return the download link.
The agent runs
themes_searchslides_generatedownloadUrlslides_create_pdf_slidesjobs_getslides_generate_narrationjobs_getslides_download_pages_voicesFrequently asked questions
What is the 2Slides MCP server?
A Model Context Protocol connector that exposes 2Slides' slide-generation, theming, narration, and export APIs as tools. Any MCP-capable agent that connects to it can generate real, editable PowerPoint files (and image-designed decks with AI narration).
Stdio or Streamable HTTP โ which transport should I use?
Use stdio on a machine where you can run Node.js (
npx 2slides-mcphttps://2slides.com/api/mcp?apikey=KEYWhich AI agents work with it?
Any MCP client. This guide covers Claude Code, OpenAI Codex, OpenClaw, Gemini CLI, Qwen Code, and Claude Desktop directly, plus Kimi and MiniMax via Claude Code or their own agent runtimes. Cursor, Windsurf, and other MCP clients use the same generic config.
Do I need a different API key per agent?
No. One 2Slides API key works across every client and both transports. Create it once at 2slides.com/api?tab=mcp.
Does it generate real PowerPoint files?
Yes.
slides_generate.pptxIs the MCP server free?
The connector is free to install, and
themes_searchjobs_getThe takeaway
Configure the 2Slides MCP server once โ stdio for local, Streamable HTTP for remote โ and every MCP agent you use gains a one-sentence path to a finished PowerPoint. The agent thinks; 2Slides builds the file.
The shift in 2026 is that "make me a deck" is no longer a chat trick โ it's a tool call your agent makes on your behalf, returning a real file. Pick your client below and you'll have your first deck before you finish reading its setup guide:
- Claude Code ยท OpenAI Codex ยท OpenClaw ยท Gemini CLI ยท Qwen Code
For more context, see the PowerPoint MCP server ecosystem map and how to build an AI presentation agent.
Get your API key, copy-paste config, and the Streamable HTTP endpoint at 2slides.com/api?tab=mcp โ one server, every agent.
Sources:
About 2Slides
Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.
Try For Free