2Slides Logo
Use Any AI Agent with the 2Slides MCP Server: The Complete 2026 Guide
2Slides Team
8 min read

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@latest with an API_KEY env 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:

ToolWhat it doesCredits
themes_searchFind a themeId for theme-based decksFree
slides_generateTheme-based PowerPoint (Fast PPT), sync/async10 / page
slides_create_pdf_slidesCustom image-designed slides from text (Nano Banana)100 / page (1K/2K), 200 (4K)
slides_create_like_thisSlides matching a reference image's style100 / page (1K/2K), 200 (4K)
slides_generate_narrationAdd AI voice narration to a Nano Banana job210 / page
slides_download_slides_pages_voicesExport pages + audio as a ZIPFree
jobs_getPoll an async job to completionFree

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 ProtocolStreamable HTTP Protocol
Where it runsLocally, via npx -y 2slides-mcp@latestRemotely, hosted by 2Slides
Needs Node.js locallyYesNo
AuthAPI_KEY environment variable?apikey= in the URL (or Authorization header)
Endpoint / commandnpx -y 2slides-mcp@latesthttps://2slides.com/api/mcp?apikey=KEY
Best forLocal dev, full control, offline-friendlyCI, 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 / clientConfig locationStdioStreamable HTTPSetup 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 Desktopclaude_desktop_config.jsonโœ…โ€”Guide โ†’
Kimi (Moonshot)via Kimi CLI or Claude Codeโœ…โœ…See "Kimi & MiniMax" below
MiniMaxvia 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 http for remote. Scopes for personal vs team use.
  • OpenAI Codex โ€” a [mcp_servers.2slides] block in config.toml, or codex mcp add 2slides --env API_KEY=xxx -- npx -y 2slides-mcp@latest. Remote via a url block.
  • OpenClaw โ€” one entry under mcp.servers in openclaw.json; verify with openclaw mcp probe 2slides --json. Tools surface in the coding/messaging profiles.
  • Gemini CLI โ€” mcpServers in settings.json (httpUrl for remote), or gemini 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:

  1. 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
  2. Use their own agent runtime. Moonshot ships the Kimi CLI (a native MCP client with a standard mcpServers/~/.kimi/mcp.json config), and MiniMax publishes the open-source Mini-Agent, which reads a standard mcp.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:

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