{"_id":"2slides-mcp","_rev":"7-0778bc31495d0267dd867778d96fd307","name":"2slides-mcp","dist-tags":{"latest":"0.2.5"},"versions":{"0.1.1":{"name":"2slides-mcp","version":"0.1.1","keywords":["mcp","modelcontextprotocol","2slides","slides","claude"],"author":"","license":"MIT","_id":"2slides-mcp@0.1.1","maintainers":[{"name":"2slides","email":"2slideai@gmail.com"}],"homepage":"https://github.com/2slides/2slides-mcp#readme","bugs":{"url":"https://github.com/2slides/2slides-mcp/issues"},"bin":{"2slides-mcp":"dist/cli.js"},"dist":{"shasum":"52443ffa260ca2c44591756a8503f58c252397c6","tarball":"https://registry.npmjs.org/2slides-mcp/-/2slides-mcp-0.1.1.tgz","fileCount":11,"integrity":"sha512-T9/g58x8QmNbGGtxovpJNjXQJBw29YrzlCNni6xz9ACa0SkmD9eilKo7L1it7lkrgrDbehww6MZ15J189vBJvA==","signatures":[{"sig":"MEQCIAoP+eWaLQBoTbUwW8wa6Td6qHUy/0NNir7eBY3QhwUzAiADFK3dmob6fGRmVPfASUbJK2/NPVdkyxdBNs4+ys1MMw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":12370},"main":"index.js","type":"module","engines":{"node":">=18"},"gitHead":"c08f8a8ed7011a2f4a447063f35e25c60fb32ac6","scripts":{"dev":"tsx src/server.ts","test":"echo \"Error: no test specified\" && exit 1","build":"tsc","start":"node dist/server.js","prepare":"tsc"},"_npmUser":{"name":"2slides","email":"2slideai@gmail.com"},"repository":{"url":"git+https://github.com/2slides/2slides-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server exposing 2slides.com tools (slides generate, jobs get, themes search)","directories":{},"_nodeVersion":"20.19.4","dependencies":{"zod":"^3.25.76","dotenv":"^17.2.2","node-fetch":"^3.3.2","@types/dotenv":"^6.1.1","@modelcontextprotocol/sdk":"^1.18.1"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.5","typescript":"^5.9.2","@types/node":"^24.5.2"},"_npmOperationalInternal":{"tmp":"tmp/2slides-mcp_0.1.1_1758645420564_0.10245656283872329","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"2slides-mcp","version":"0.1.2","keywords":["mcp","modelcontextprotocol","2slides","slides","claude"],"author":"","license":"MIT","_id":"2slides-mcp@0.1.2","maintainers":[{"name":"2slides","email":"2slideai@gmail.com"}],"homepage":"https://github.com/2slides/2slides-mcp#readme","bugs":{"url":"https://github.com/2slides/2slides-mcp/issues"},"bin":{"2slides-mcp":"dist/cli.js"},"dist":{"shasum":"035ec1d7f9d331727f4b0ebe7a700c2961ef8511","tarball":"https://registry.npmjs.org/2slides-mcp/-/2slides-mcp-0.1.2.tgz","fileCount":11,"integrity":"sha512-05idD+wilI0Y/0u17DCzJaGjcnOGxJA7gNpqVGQg1HfWIt0cIWIM355VQx2aF5w1LvuzGmksQmrJI0YHAqvLNQ==","signatures":[{"sig":"MEUCIQCplKXzqiDjly4LwFP/El7xGxLR2T3IoZKQbGIehFMIawIgO17YXNeYdb+lvGEyt7O5ZEinSiYIX7EosyGShgfWhfs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":12563},"main":"index.js","type":"module","engines":{"node":">=18"},"gitHead":"5c5a7ac3443460d7a73dc6cca2056df60e9fd4ba","scripts":{"dev":"tsx src/server.ts","test":"echo \"Error: no test specified\" && exit 1","build":"tsc","start":"node dist/server.js","prepare":"tsc"},"_npmUser":{"name":"2slides","email":"2slideai@gmail.com"},"repository":{"url":"git+https://github.com/2slides/2slides-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server exposing 2slides.com tools (slides generate, jobs get, themes search)","directories":{},"_nodeVersion":"20.19.4","dependencies":{"zod":"^3.25.76","dotenv":"^17.2.2","node-fetch":"^3.3.2","@types/dotenv":"^6.1.1","@modelcontextprotocol/sdk":"^1.18.1"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.5","typescript":"^5.9.2","@types/node":"^24.5.2"},"_npmOperationalInternal":{"tmp":"tmp/2slides-mcp_0.1.2_1760320455945_0.4479596174428311","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"2slides-mcp","version":"0.2.0","keywords":["mcp","modelcontextprotocol","2slides","slides","claude"],"author":"","license":"MIT","_id":"2slides-mcp@0.2.0","maintainers":[{"name":"2slides","email":"2slideai@gmail.com"}],"homepage":"https://github.com/2slides/2slides-mcp#readme","bugs":{"url":"https://github.com/2slides/2slides-mcp/issues"},"bin":{"2slides-mcp":"dist/cli.js"},"dist":{"shasum":"d9fedf458a2858311c31e87f80773cf4ade5960e","tarball":"https://registry.npmjs.org/2slides-mcp/-/2slides-mcp-0.2.0.tgz","fileCount":11,"integrity":"sha512-4KAe1ljjuGR6HffybKZWrFWHbvuee9MWc6J4Oy1zvD2K1oYy/S13NmaAUv4jOMGeClu2fWiq0JW1FgZKHFLT9A==","signatures":[{"sig":"MEYCIQCNBWo8TYD+uT1Xg1smkieoxhetiQVsNfb7B3kVY3Y7IAIhAOf5u2S7ECUf2ie68g2R5TpEszjpaHNID+yusxdw7aYS","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":13126},"main":"index.js","type":"module","engines":{"node":">=18"},"gitHead":"f00e08c4ac15c7ed47b322ddead3fc0638965a5e","scripts":{"dev":"tsx src/server.ts","test":"echo \"Error: no test specified\" && exit 1","build":"tsc","start":"node dist/server.js","prepare":"tsc"},"_npmUser":{"name":"2slides","email":"2slideai@gmail.com"},"repository":{"url":"git+https://github.com/2slides/2slides-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server exposing 2slides.com tools (slides generate, jobs get, themes search)","directories":{},"_nodeVersion":"20.19.4","dependencies":{"zod":"^3.25.76","dotenv":"^17.2.2","node-fetch":"^3.3.2","@types/dotenv":"^6.1.1","@modelcontextprotocol/sdk":"^1.18.1"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.5","typescript":"^5.9.2","@types/node":"^24.5.2"},"_npmOperationalInternal":{"tmp":"tmp/2slides-mcp_0.2.0_1760347958809_0.14516643310320143","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"2slides-mcp","version":"0.2.1","keywords":["mcp","modelcontextprotocol","2slides","slides","claude"],"author":"","license":"MIT","_id":"2slides-mcp@0.2.1","maintainers":[{"name":"2slides","email":"2slideai@gmail.com"}],"homepage":"https://github.com/2slides/2slides-mcp#readme","bugs":{"url":"https://github.com/2slides/2slides-mcp/issues"},"bin":{"2slides-mcp":"dist/cli.js"},"dist":{"shasum":"1ba333f41842825a7c9ca74cffa1bdd6d1e98f77","tarball":"https://registry.npmjs.org/2slides-mcp/-/2slides-mcp-0.2.1.tgz","fileCount":11,"integrity":"sha512-T8nnegf25JrS5TEmqnx3NTXeRnLxMm3ovXnzXD8mjM1XDs8SESSJH+z/nIC9tPQVOUBvNGRdAy2h6nvb6d4NnA==","signatures":[{"sig":"MEUCIQDB3YO3ip1d0ZLF8i2bFL9yTeEwV41X6iIJjVil/XCMiAIgCqetvJhgez38W54ab6AOFXFrJ9RB2p/Rk6GQdYf44zk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":13122},"main":"index.js","type":"module","engines":{"node":">=18"},"gitHead":"871a5dc5a6da95398ac8ff216cd939ea63907f36","scripts":{"dev":"tsx src/server.ts","test":"echo \"Error: no test specified\" && exit 1","build":"tsc","start":"node dist/server.js","prepare":"tsc"},"_npmUser":{"name":"2slides","email":"2slideai@gmail.com"},"repository":{"url":"git+https://github.com/2slides/2slides-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server exposing 2slides.com tools (slides generate, jobs get, themes search)","directories":{},"_nodeVersion":"20.19.4","dependencies":{"zod":"^3.25.76","dotenv":"^17.2.2","node-fetch":"^3.3.2","@types/dotenv":"^6.1.1","@modelcontextprotocol/sdk":"^1.18.1"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.5","typescript":"^5.9.2","@types/node":"^24.5.2"},"_npmOperationalInternal":{"tmp":"tmp/2slides-mcp_0.2.1_1761035066213_0.7266057527625704","host":"s3://npm-registry-packages-npm-production"}},"0.2.3":{"name":"2slides-mcp","version":"0.2.3","keywords":["mcp","modelcontextprotocol","2slides","slides","claude"],"author":"","license":"MIT","_id":"2slides-mcp@0.2.3","maintainers":[{"name":"2slides","email":"2slideai@gmail.com"}],"homepage":"https://github.com/2slides/2slides-mcp#readme","bugs":{"url":"https://github.com/2slides/2slides-mcp/issues"},"bin":{"2slides-mcp":"dist/cli.js"},"dist":{"shasum":"e4c526cf7ad7c84c7acab35d829425fb92290e44","tarball":"https://registry.npmjs.org/2slides-mcp/-/2slides-mcp-0.2.3.tgz","fileCount":11,"integrity":"sha512-/xb5VOVp7+bU8gK9gdcW9ihpP0Y4TphZaZhrPpMoiFSdNFbYdM5zpaskBuXLA/4LgwvbXGqadryhD/VWqxU+qg==","signatures":[{"sig":"MEQCIBLl9OK4T8XhUdtSEDLNUjgU0jue77l7rfyrgHNQexNeAiB4CaqGPl3Xg66fh5Bmv+Fi1S6qAGVYVURfhQ92M3QQwg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":17482},"main":"index.js","type":"module","engines":{"node":">=18"},"gitHead":"df9cfafa2c56356b0d2d53f9e1d0c51ed192bf93","scripts":{"dev":"tsx src/server.ts","test":"echo \"No tests specified\"","build":"tsc","start":"node dist/server.js","prepare":"tsc"},"_npmUser":{"name":"2slides","email":"2slideai@gmail.com"},"repository":{"url":"git+https://github.com/2slides/2slides-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server exposing 2slides.com tools (slides generate, jobs get, themes search)","directories":{},"_nodeVersion":"20.19.4","dependencies":{"zod":"^3.25.76","dotenv":"^17.2.2","node-fetch":"^3.3.2","@types/dotenv":"^6.1.1","@modelcontextprotocol/sdk":"^1.18.1"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.5","typescript":"^5.9.2","@types/node":"^24.5.2"},"_npmOperationalInternal":{"tmp":"tmp/2slides-mcp_0.2.3_1767243095759_0.17055902829348835","host":"s3://npm-registry-packages-npm-production"}},"0.2.4":{"name":"2slides-mcp","version":"0.2.4","keywords":["mcp","modelcontextprotocol","2slides","slides","claude"],"author":{"name":"2slides","email":"2slideai@gmail.com"},"license":"MIT","_id":"2slides-mcp@0.2.4","maintainers":[{"name":"sarah_2slides","email":"2slideai@gmail.com"}],"homepage":"https://github.com/2slides/2slides-mcp#readme","bugs":{"url":"https://github.com/2slides/2slides-mcp/issues"},"bin":{"2slides-mcp":"dist/cli.js"},"dist":{"shasum":"6eb0eb409fdb7bf5ff4ab2c75604018a7571188e","tarball":"https://registry.npmjs.org/2slides-mcp/-/2slides-mcp-0.2.4.tgz","fileCount":11,"integrity":"sha512-ZW/3yyK99YvjlBEz+6SiN2vvgbL1+ZVaD6F+4peq1d95Eav4+harLe3tUvy+RypSyynmMHOh5+s6GojHbBJOXQ==","signatures":[{"sig":"MEYCIQD4NtkVKm+m6mcydBHZNJ32ABScp1FMNllgDKR9Yzht6gIhAKQO6apotIhl6MkCCX5P18C2iVW+1SLGEhAP64ANi8tI","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":37894},"main":"index.js","type":"module","engines":{"node":">=18"},"gitHead":"0f0d51834dcd50a639027827805c503114434f7d","scripts":{"dev":"tsx src/server.ts","test":"echo \"No tests specified\"","build":"tsc","start":"node dist/server.js","prepare":"echo skip"},"_npmUser":{"name":"sarah_2slides","email":"2slideai@gmail.com"},"repository":{"url":"git+https://github.com/2slides/2slides-mcp.git","type":"git"},"_npmVersion":"10.9.4","description":"MCP server exposing 2slides.com tools (slides generate, jobs get, themes search)","directories":{},"_nodeVersion":"22.22.0","dependencies":{"zod":"^3.25.76","dotenv":"^17.2.2","node-fetch":"^3.3.2","@types/dotenv":"^6.1.1","@modelcontextprotocol/sdk":"^1.18.1"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.5","typescript":"^5.9.2","@types/node":"^24.5.2"},"_npmOperationalInternal":{"tmp":"tmp/2slides-mcp_0.2.4_1771579158849_0.25535462128107","host":"s3://npm-registry-packages-npm-production"}},"0.2.5":{"name":"2slides-mcp","version":"0.2.5","main":"index.js","type":"module","description":"MCP server exposing 2slides.com tools (slides generate, jobs get, themes search)","keywords":["mcp","modelcontextprotocol","2slides","slides","claude"],"license":"MIT","author":{"name":"2slides","email":"2slideai@gmail.com"},"repository":{"type":"git","url":"git+https://github.com/2slides/mcp-2slides.git"},"bugs":{"url":"https://github.com/2slides/mcp-2slides/issues"},"homepage":"https://github.com/2slides/mcp-2slides#readme","scripts":{"test":"echo \"No tests specified\"","build":"tsc","start":"node dist/server.js","dev":"tsx src/server.ts","prepare":"tsc"},"bin":{"2slides-mcp":"dist/cli.js"},"engines":{"node":">=18"},"dependencies":{"@modelcontextprotocol/sdk":"^1.18.1","@types/dotenv":"^6.1.1","dotenv":"^17.2.2","node-fetch":"^3.3.2","zod":"^3.25.76"},"devDependencies":{"@types/node":"^24.5.2","tsx":"^4.20.5","typescript":"^5.9.2"},"_id":"2slides-mcp@0.2.5","gitHead":"437afa6caa8f561068a387f46e37280b527ab61b","_nodeVersion":"24.12.0","_npmVersion":"10.9.4","dist":{"integrity":"sha512-uV9KXda+dsI3SH73YRx5cYlQ4nlWanG0OgK8K5VMsgHOEQ6qgaX/s3I/fQVdFDkEV5IqPIhbjyNtPD7T4bcacw==","shasum":"0fb63060df760f2429fe21858ee06e913a76ba10","tarball":"https://registry.npmjs.org/2slides-mcp/-/2slides-mcp-0.2.5.tgz","fileCount":11,"unpackedSize":40222,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCICHoNNJFQ5xCfwiJt8eE1HFJEDXlBI4xhX3T2+JfI9RbAiEA5RHklTMv3rR3CYHD0pXd04013O0munXBVWWA8Tp6/6g="}]},"_npmUser":{"name":"sarah_2slides","email":"2slideai@gmail.com"},"directories":{},"maintainers":[{"name":"sarah_2slides","email":"2slideai@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/2slides-mcp_0.2.5_1788257573556_0.41824952569099905"},"_hasShrinkwrap":false}},"time":{"created":"2025-09-23T16:37:00.563Z","modified":"2026-09-01T10:12:53.898Z","0.1.1":"2025-09-23T16:37:00.750Z","0.1.2":"2025-10-13T01:54:16.157Z","0.2.0":"2025-10-13T09:32:38.993Z","0.2.1":"2025-10-21T08:24:26.408Z","0.2.3":"2026-01-01T04:51:35.962Z","0.2.4":"2026-02-20T09:19:18.978Z","0.2.5":"2026-09-01T10:12:53.700Z"},"bugs":{"url":"https://github.com/2slides/mcp-2slides/issues"},"author":{"name":"2slides","email":"2slideai@gmail.com"},"license":"MIT","homepage":"https://github.com/2slides/mcp-2slides#readme","keywords":["mcp","modelcontextprotocol","2slides","slides","claude"],"repository":{"type":"git","url":"git+https://github.com/2slides/mcp-2slides.git"},"description":"MCP server exposing 2slides.com tools (slides generate, jobs get, themes search)","maintainers":[{"name":"sarah_2slides","email":"2slideai@gmail.com"}],"readme":"## 2slides MCP Server\n\n![2slides](https://2slides.com/images/og_2slides.webp)\n\nExpose [2slides.com](https://2slides.com) tools to MCP clients: generate PowerPoint decks\nand custom-designed slides, add AI voice narration, and get the finished files back as\ndownload links.\n\n### Get Your API Key\nBefore connecting, get an API key from [2slides.com/api](https://2slides.com/api).\n\n### Connect\n\n2slides runs a hosted **Streamable HTTP** MCP endpoint, and also ships this **stdio**\npackage. Both expose the same 7 tools against the same account and the same credits.\n\n|                | Streamable HTTP                     | stdio (this package)                  |\n| -------------- | ----------------------------------- | ------------------------------------- |\n| Setup          | one command, nothing to install     | needs Node.js 18+, npx fetches the package |\n| Updates        | server-side, always current         | re-downloaded on your machine         |\n| Runs in        | any remote-capable MCP client       | any client that can spawn a local process |\n\n#### Option 1 — Streamable HTTP (recommended)\n\nAnthropic's MCP docs call HTTP \"the recommended option for connecting to remote MCP\nservers\", and 2slides is a hosted service with no local files or processes to reach, so\nstart here.\n\n**Claude Code**\n\n```bash\nclaude mcp add --transport http 2slides \"https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY\"\n```\n\nVerify with `claude mcp list` — the server should report `✔ Connected`.\n\n**Project config** (`.mcp.json`, shared with your team)\n\n```json\n{\n  \"mcpServers\": {\n    \"2slides\": {\n      \"type\": \"http\",\n      \"url\": \"https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY\"\n    }\n  }\n}\n```\n\n**Claude Desktop / claude.ai**: add it as a custom connector at\n[claude.ai/customize/connectors](https://claude.ai/customize/connectors) with the same\nURL.\n\n#### Option 2 — stdio (local process)\n\nUse this when the client can only spawn local processes, when the machine has no direct\nroute to 2slides.com, or when you want to pin and patch the server yourself.\n\n**Claude Code**\n\n```bash\nclaude mcp add 2slides -e API_KEY=YOUR_2SLIDES_API_KEY -- npx -y 2slides-mcp@latest\n```\n\n**Claude Desktop** — edit `~/Library/Application Support/Claude/claude_desktop_config.json`\n(`%APPDATA%\\Claude\\claude_desktop_config.json` on Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"2slides\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"2slides-mcp@latest\"],\n      \"env\": {\n        \"API_KEY\": \"YOUR_2SLIDES_API_KEY\"\n      }\n    }\n  }\n}\n```\n\nThe `-y` flag lets npx install the package without prompting. Fully restart Claude Desktop\nafterwards; in a chat, open the tools panel and you should see the tools below.\n\n### Available Tools\n\n---\n\n#### `slides_generate` (POST /api/v1/slides/generate)\nGenerate a PowerPoint presentation using a pre-built theme (Fast PPT). Use `themes_search` first to find a `themeId`.\n\n- **Args:**\n  - `userInput` (string, required) — presentation content\n  - `themeId` (string, required) — theme ID from `themes_search`\n  - `responseLanguage` (string, optional, default: `Auto`) — output language; supported values: `Auto`, `English`, `Spanish`, `Arabic`, `Portuguese`, `Indonesian`, `Japanese`, `Russian`, `Hindi`, `French`, `German`, `Greek`, `Vietnamese`, `Turkish`, `Thai`, `Polish`, `Italian`, `Korean`, `Simplified Chinese`, `Traditional Chinese`\n  - `mode` (optional, default: `sync`) — `sync` returns `downloadUrl` immediately; `async` returns a `jobId` to poll with `jobs_get`\n- **Credits:** 1 per page\n- **Example:**\n  ```json\n  {\n    \"themeId\": \"st-1756528793701-fcg5fblt2\",\n    \"userInput\": \"Generate a 5-slide intro to machine learning\",\n    \"responseLanguage\": \"English\",\n    \"mode\": \"sync\"\n  }\n  ```\n\n---\n\n#### `themes_search` (GET /api/v1/themes/search)\nSearch pre-built themes to use with `slides_generate`.\n\n- **Args:**\n  - `query` (string, required) — search keyword (e.g. `business`, `minimal`, `dark`)\n  - `limit` (number, optional, default: `10`, range: `1–100`)\n- **Returns:** array of themes with `id`, `name`, `description`, `previewUrl`, `tags`\n- **Credits:** free\n- **Example:**\n  ```json\n  { \"query\": \"business\", \"limit\": 5 }\n  ```\n\n---\n\n#### `jobs_get` (GET /api/v1/jobs/{jobId})\nPoll a job's status and retrieve the result when ready.\n\n- **Args:**\n  - `jobId` (string, required)\n- **Returns:** `jobId`, `status` (`pending` / `processing` / `success` / `failed`), `message`, `downloadUrl` (when success), `slidePageCount`, `createdAt`, `updatedAt`, `duration` (ms), `jobUrl` (Nano Banana jobs only)\n- **Credits:** free\n- **Note:** Poll every 20 seconds until `status` is `success` or `failed`.\n- **Example:**\n  ```json\n  { \"jobId\": \"D8h9VYDGdTlZ6wWSEoctF\" }\n  ```\n\n---\n\n#### `slides_create_like_this` (POST /api/v1/slides/create-like-this)\nGenerate slides (Nano Banana) that match the style of a reference image.\n\n- **Args:**\n  - `userInput` (string, required) — presentation content\n  - `referenceImageUrl` (string, required) — URL of the style reference image\n  - `responseLanguage` (string, optional, default: `Auto`)\n  - `aspectRatio` (string, optional, default: `16:9`) — valid values: `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9`\n  - `resolution` (string, optional, default: `2K`) — `1K`, `2K`, `4K`\n  - `page` (number, optional, default: `0`) — `0` = auto-detect, `1–100` = exact page count\n  - `contentDetail` (string, optional, default: `standard`) — `concise` or `standard`\n  - `mode` (string, optional, default: `async`) — `async` returns `jobId`; `sync` returns `downloadUrl` immediately\n- **Credits:** 100 per page (1K/2K) or 200 per page (4K)\n- **Example:**\n  ```json\n  {\n    \"userInput\": \"Create a presentation about AI trends\",\n    \"referenceImageUrl\": \"https://example.com/style-reference.jpg\",\n    \"aspectRatio\": \"16:9\",\n    \"resolution\": \"2K\",\n    \"page\": 5,\n    \"contentDetail\": \"standard\",\n    \"mode\": \"async\"\n  }\n  ```\n\n---\n\n#### `slides_create_pdf_slides` (POST /api/v1/slides/create-pdf-slides)\nGenerate custom-designed slides (Nano Banana) from text content without a reference image.\n\n- **Args:**\n  - `userInput` (string, required) — presentation content\n  - `designStyle` (string, optional) — free-text description of the visual style; leave empty for default styling\n  - `responseLanguage` (string, optional, default: `Auto`)\n  - `aspectRatio` (string, optional, default: `16:9`) — valid values: `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9`\n  - `resolution` (string, optional, default: `2K`) — `1K`, `2K`, `4K`\n  - `page` (number, optional, default: `0`) — `0` = auto-detect, `1–100` = exact page count\n  - `contentDetail` (string, optional, default: `standard`) — `concise` or `standard`\n  - `mode` (string, optional, default: `async`) — `async` returns `jobId`; `sync` returns `downloadUrl` immediately\n- **Credits:** 100 per page (1K/2K) or 200 per page (4K)\n- **Example:**\n  ```json\n  {\n    \"userInput\": \"Quarterly business review for Q3 2025\",\n    \"designStyle\": \"modern, dark background, bold typography\",\n    \"aspectRatio\": \"16:9\",\n    \"resolution\": \"2K\",\n    \"page\": 8,\n    \"mode\": \"async\"\n  }\n  ```\n\n---\n\n#### `slides_generate_narration` (POST /api/v1/slides/generate-narration)\nAdd AI voice narration to a completed Nano Banana job (`slides_create_like_this` or `slides_create_pdf_slides` only; Fast PPT not supported). Always async — poll result with `jobs_get`.\n\n- **Args (single speaker, `mode: \"single\"` default):**\n  - `jobId` (string, required) — UUID of a completed Nano Banana job\n  - `mode` (string, optional, default: `single`) — `single` or `multi`\n  - `speakerName` (string, optional) — narrator name\n  - `voice` (string, optional) — one of 30 voices (see list below)\n  - `contentMode` (string, optional, default: `standard`) — `concise` or `standard`\n  - `includeIntro` (boolean, optional, default: `true`)\n\n- **Args (two speakers, `mode: \"multi\"`):**\n  - `jobId` (string, required)\n  - `mode` (string, required) — `multi`\n  - `speaker1Name` (string, required)\n  - `speaker2Name` (string, required)\n  - `speaker1Voice` (string, optional) — voice for speaker 1\n  - `speaker2Voice` (string, optional) — voice for speaker 2\n  - `contentMode` (string, optional, default: `standard`) — `concise` or `standard`\n\n- **Supported voices (30):** `Puck`, `Aoede`, `Charon`, `Kore`, `Fenrir`, `Zephyr`, `Leda`, `Orus`, `Callirrhoe`, `Autonoe`, `Enceladus`, `Iapetus`, `Umbriel`, `Algieba`, `Despina`, `Erinome`, `Algenib`, `Rasalgethi`, `Laomedeia`, `Achernar`, `Alnilam`, `Schedar`, `Gacrux`, `Pulcherrima`, `Achird`, `Zubenelgenubi`, `Vindemiatrix`, `Sadachbia`, `Sadaltager`, `Sulafat`\n- **Credits:** 210 per page (10 text + 200 audio)\n- **Example:**\n  ```json\n  {\n    \"jobId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\",\n    \"mode\": \"multi\",\n    \"speaker1Name\": \"Alice\",\n    \"speaker2Name\": \"Bob\",\n    \"speaker1Voice\": \"Aoede\",\n    \"speaker2Voice\": \"Puck\",\n    \"contentMode\": \"standard\"\n  }\n  ```\n\n---\n\n#### `slides_download_slides_pages_voices` (POST /api/v1/slides/download-slides-pages-voices)\nExport slide pages and audio narration as a ZIP file. The job must be completed and have narration generated.\n\n- **Args:**\n  - `jobId` (string, required) — UUID of a job with completed narration\n- **Returns:** `downloadUrl` (expires in 1 hour), `fileName`, `expiresIn` (3600 seconds)\n- **ZIP contents:**\n  ```\n  pages/\n    page_01.png, page_02.png, …\n  voices/\n    page_01.wav, page_02.wav, …\n  transcript.txt\n  ```\n- **Credits:** free\n- **Example:**\n  ```json\n  { \"jobId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\" }\n  ```\n\n---\n\n### Typical Workflows\n\n**Fast PPT (theme-based PowerPoint):**\n1. `themes_search` → get a `themeId`\n2. `slides_generate` (sync) → get `downloadUrl` directly\n\n**Nano Banana (custom-designed slides):**\n1. `slides_create_like_this` or `slides_create_pdf_slides` (async) → get `jobId`\n2. `jobs_get` (poll every 20s) → get `downloadUrl` when `status: \"success\"`\n\n**Nano Banana with narration:**\n1. `slides_create_like_this` or `slides_create_pdf_slides` → get `jobId`\n2. `jobs_get` → wait for slides to complete\n3. `slides_generate_narration` → get narration `jobId`\n4. `jobs_get` → wait for narration to complete\n5. `slides_download_slides_pages_voices` → get ZIP download link\n\n---\n\n### Troubleshooting (Claude Desktop)\n- If tools don't appear in Claude, verify the config path is absolute and restart the app.\n- Check Claude MCP logs:\n```bash\ntail -n 50 -f ~/Library/Logs/Claude/mcp*.log\n```\n- For stdio MCP servers, avoid logging to stdout; this server only logs errors to stderr.\n\n### References\n- Build an MCP server (official docs): https://modelcontextprotocol.io/docs/develop/build-server\n- 2slides API docs: https://2slides.com/api\n- 2slides: https://2slides.com\n- 2slides Templates: https://2slides.com/templates\n","readmeFilename":"README.md"}