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 }

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://www.2slides.com
• 2slides Templates: https://www.2slides.com/templates