2slides

## 2slides MCP Server

![2slides](https://2slides.com/images/og_2slides.webp)

Expose [2slides.com](https://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](https://2slides.com/api).

### Configure in Claude Desktop
Edit `~/Library/Application Support/Claude/claude_desktop_config.json` and add:
```json
{
  "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:
    ```json
    {
      "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:
    ```json
    { "jobId": "D8h9VYDGdTlZ6wWSEoctF" }
    ```

- `themes_search` (GET /api/v1/themes/search)
  - Args: `query` (string), `limit` (number, optional, max 100)
  - Example:
    ```json
    { "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:
    ```json
    {
      "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:
```bash
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