

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 (
npx -y 2slides-mcp@latestwith anAPI_KEYenv var) and Streamable HTTP (https://2slides.com/api/mcp?apikey=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.
Every modern AI agent can write a slide outline. None of them, on their own, can hand you a real, editable .pptx with themes, charts, narration, and speaker notes. That is a file-generation job โ and the 2Slides MCP server is the universal connector that gives any Model Context Protocol client that capability.
Write 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 for theme-based decks | 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_slides_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 -y 2slides-mcp@latest | Remotely, hosted by 2Slides |
| Needs Node.js locally | Yes | No |
| Auth | API_KEY environment variable | ?apikey= in the URL (or Authorization header) |
| Endpoint / command | npx -y 2slides-mcp@latest | 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": ["-y", "2slides-mcp@latest"],
"env": { "API_KEY": "YOUR_2SLIDES_API_KEY" }
}
}
}Generic Streamable HTTP: point your client at https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY. (The exact key name varies โ Gemini CLI and Qwen Code use httpUrl; OpenClaw uses url + transport: "streamable-http"; Claude Code and Codex take a --transport http flag or a url field.)
Grab 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.json / claude mcp add | โ | โ
(--transport http) | Guide โ |
| OpenAI Codex | ~/.codex/config.toml | โ | โ
(url) | Guide โ |
| OpenClaw | ~/.openclaw/openclaw.json (mcp.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 add shortcut where it exists, and how to verify the connection.
Pick your agent
- Claude Code โ Anthropic's CLI.
claude mcp add 2slides -e API_KEY=xxx -- npx -y 2slides-mcp@latest, or--transport httpfor remote. Scopes for personal vs team use. - OpenAI Codex โ a
[mcp_servers.2slides]block inconfig.toml, orcodex mcp add 2slides --env API_KEY=xxx -- npx -y 2slides-mcp@latest. Remote via aurlblock. - OpenClaw โ one entry under
mcp.serversinopenclaw.json; verify withopenclaw mcp probe 2slides --json. Tools surface in thecoding/messagingprofiles. - Gemini CLI โ
mcpServersinsettings.json(httpUrlfor remote), orgemini mcp add. - Qwen Code โ same shape in
~/.qwen/settings.json; strong for Chinese-language decks.
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 -y 2slides-mcp@latest # 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
mcpServers/~/.kimi/mcp.jsonconfig), and MiniMax publishes the open-source Mini-Agent, which reads a standardmcp.json. In both, add 2Slides exactly like the generic stdio or Streamable HTTP block above.
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_search โ slides_generate (Fast PPT) โ returns a downloadUrl. Want custom, image-designed slides with AI voiceover? Ask for it, and the agent chains slides_create_pdf_slides โ jobs_get โ slides_generate_narration โ jobs_get โ slides_download_slides_pages_voices.
Frequently 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 -y 2slides-mcp@latest) โ it's the default for local work. Use Streamable HTTP (https://2slides.com/api/mcp?apikey=KEY) when your agent runs in CI, a container, or a remote box with nothing installed. Both expose identical tools.
Which 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 returns an editable .pptx with real shapes and themes. The Nano Banana tools return image-designed decks and can add AI voice narration plus an exportable asset bundle for video.
Is the MCP server free?
The connector is free to install, and themes_search / jobs_get / export calls are free. Slide generation consumes 2Slides credits โ 10 credits per page for Fast PPT, more for image-designed and narrated decks.
The 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