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 2slides-mcp
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_search
Find a
themeId
for theme-based decks
Free
slides_generate
Theme-based PowerPoint (Fast PPT), sync/async10 / 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 style100 / page (1K/2K), 200 (4K)
slides_generate_narration
Add AI voice narration to a Nano Banana job210 / page
slides_download_pages_voices
Export pages + audio as a ZIPFree
jobs_get
Poll 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 2slides-mcp
Remotely, hosted by 2Slides
Needs Node.js locallyYesNo
Auth
API_KEY
environment variable
?apikey=
in the URL (or
Authorization
header)
Endpoint / command
npx 2slides-mcp
https://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": ["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_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 Desktop
claude_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 --env API_KEY=xxx --transport stdio 2slides -- npx 2slides-mcp
    , 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 2slides-mcp
    . 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 2slides-mcp # 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_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 2slides-mcp
) โ€” 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