2slides

2slides MCP Server

Expose 2slides.com tools for MCP clients (e.g., Claude Desktop).

Get Your API Key

Before using this MCP server, you need to obtain an API key from 2slides.com/api.

Configure in Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json and add:

{
  "mcpServers": {
    "2slides": {
      "command": "npx",
      "args": ["2slides-mcp"],
      "env": {
        "API_KEY": "YOUR_2SLIDES_API_KEY"
      }
    }
  }
}

Then fully restart Claude Desktop. In a chat, open the tools panel and you should see the tools below.

Available Tools

• slides_generate (POST /api/v1/slides/generate)

  • Args: themeId (string), userInput (string), responseLanguage (string), mode (optional: sync | async, default sync)
  • Example:

    {
      "themeId": "st-1756528793701-fcg5fblt2",
      "userInput": "generate sample content",
      "responseLanguage": "English",
      "mode": "async"
    }
    

  • Notes:
    • mode: "sync" waits for generation to complete and returns the result directly (default).
    • mode: "async" submits the job and returns a jobId; poll with jobs_get.

• jobs_get (GET /api/v1/jobs/{jobId})

  • Args: jobId (string)
  • Example:

    { "jobId": "D8h9VYDGdTlZ6wWSEoctF" }
    

• themes_search (GET /api/v1/themes/search)

  • Args: query (string), limit (number, optional, max 100)
  • Example:

    { "query": "8 stages", "limit": 10 }
    

• slides_create_like_this (POST /api/v1/slides/create-like-this)

  • Args: userInput (string, required), referenceImageUrl (string, required), responseLanguage (string, optional, default: Auto), aspectRatio (string, optional, default: 16:9), resolution (string, optional, default: 2K), page (number, optional, default: 1, 0 for auto-detect, >=1 for specified count, max: 100), contentDetail (string, optional, default: concise, options: concise/standard)
  • Example:

    {
      "userInput": "Create a presentation about AI",
      "referenceImageUrl": "https://example.com/image.jpg",
      "responseLanguage": "English",
      "aspectRatio": "16:9",
      "resolution": "2K",
      "page": 4,
      "contentDetail": "concise"
    }
    

  • Notes:
    • Generates slides (Nano Banana Pro) from a reference image in synchronous mode.
    • Automatically generates PDF.
    • Returns: jobId, status, downloadUrl (PDF), jobUrl (workspace link), slidePageCount.

All tools return the 2slides API JSON as formatted text. Use jobs_get with the jobId from slides_generate to poll status or get the downloadUrl when available.

Troubleshooting (Claude Desktop)

• If tools don’t appear in Claude, verify the config path is absolute and restart the app.
• Check Claude MCP logs:

tail -n 50 -f ~/Library/Logs/Claude/mcp*.log

• For stdio MCP servers, avoid logging to stdout; this server only logs errors to stderr. See the official guidance below.

References

• Build an MCP server (official docs): https://modelcontextprotocol.io/docs/develop/build-server
• 2slides: https://2slides.com
• 2slides Templates: https://2slides.com/templates