Update with new search API

Author: 2slides

2slides-mcp-0.1.1.tgz

@@ -0,0 +1,23 @@
+MIT License
+
+Copyright (c) 2025
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+

LICENSE

@@ -1,34 +1,65 @@
-2slides MCP Server (Node.js)
+## 2slides MCP Server
 
-Setup
-- Copy .env.example to .env and set API_KEY
-- Install deps: npm install
-- Dev run (stdio): npm run dev
-- Build: npm run build
-- Start: npm start
+Expose 2slides.com tools for MCP clients (e.g., Claude Desktop).
 
-Claude Desktop config example
+### Configure in Claude Desktop
+Edit `~/Library/Application Support/Claude/claude_desktop_config.json` and add:
+```json
 {
  "mcpServers": {
  "2slides": {
- "command": "node",
- "args": [
- "/Users/julian/Workspace/you_are_funny/2slides-mcp/node_modules/.bin/tsx",
- "/Users/julian/Workspace/you_are_funny/2slides-mcp/src/server.ts"
- ],
+ "command": "npx",
+ "args": ["2slides-mcp"],
  "env": {
- "API_KEY": "YOUR_API_KEY"
+ "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.
 
-Tools
-- slides_generate: POST /api/v1/slides/generate
-- jobs_get: GET /api/v1/jobs/{jobId}
+### Available Tools
+- `slides_generate` (POST /api/v1/slides/generate)
+ - Args: `themeId` (string), `userInput` (string), `responseLanguage` (string)
+ - Example:
+ ```json
+ {
+ "themeId": "st-1756528793701-fcg5fblt2",
+ "userInput": "generate sample content",
+ "responseLanguage": "English"
+ }
+ ```
+
+- `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 }
+ ```
+
+- `templates_browse_url` (No API call)
+ - Returns the templates page URL: `https://www.2slides.com/templates`
+
+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.
 
-References
-- https://modelcontextprotocol.io/docs/develop/build-server
-- https://www.2slides.com
+### 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://www.2slides.com
+- 2slides Templates: https://www.2slides.com/templates
 

README.md

@@ -1,23 +1,41 @@
 {
- "name": "mcp-2slides-server",
- "version": "0.1.0",
+ "name": "2slides-mcp",
+ "version": "0.1.1",
  "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": "",
+ "repository": {
+ "type": "git",
+ "url": "git+https://github.com/2slides/2slides-mcp.git"
+ },
+ "bugs": {
+ "url": "https://github.com/2slides/2slides-mcp/issues"
+ },
+ "homepage": "https://github.com/2slides/2slides-mcp#readme",
  "scripts": {
  "test": "echo \"Error: no test specified\" && exit 1",
  "build": "tsc",
  "start": "node dist/server.js",
- "dev": "tsx src/server.ts"
+ "dev": "tsx src/server.ts",
+ "prepare": "tsc"
  },
- "keywords": [],
- "author": "",
- "license": "ISC",
- "description": "",
- "type": "module",
+ "bin": {
+ "2slides-mcp": "dist/cli.js"
+ },
+ "files": [
+ "dist",
+ "README.md",
+ "LICENSE"
+ ],
  "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"

package-lock.json

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import './server.js';
+
+

package.json

@@ -1,11 +1,12 @@
-import 'dotenv/config';
+import dotenv from 'dotenv';
 import { z } from 'zod';
 import fetch from 'node-fetch';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 
 // Constants
 const API_BASE_URL = 'https://www.2slides.com';
+dotenv.config();
 const API_KEY = process.env.API_KEY ?? '';
 
 if (!API_KEY) {
@@ -23,7 +24,7 @@ const GenerateArgs = {
  responseLanguage: z.string().min(1),
 };
 
-mcp.tool('slides_generate', 'Generate slides with 2slides. Returns job info including jobId and downloadUrl when ready.', GenerateArgs, async (args, _extra) => {
+mcp.tool('slides_generate', 'Generate slides with 2slides. Returns job info including jobId and downloadUrl when ready.', GenerateArgs, async (args: any, _extra: any) => {
  const { themeId, userInput, responseLanguage } = args as z.infer<z.ZodObject<typeof GenerateArgs>>;
  const url = `${API_BASE_URL}/api/v1/slides/generate`;
  const res = await fetch(url, {
@@ -48,7 +49,7 @@ mcp.tool('slides_generate', 'Generate slides with 2slides. Returns job info incl
 // Tool: jobs_get -> GET /api/v1/jobs/{job-id}
 const JobArgs = { jobId: z.string().min(1) };
 
-mcp.tool('jobs_get', 'Get job status/result by jobId from 2slides.', JobArgs, async (args, _extra) => {
+mcp.tool('jobs_get', 'Get job status/result by jobId from 2slides.', JobArgs, async (args: any, _extra: any) => {
  const { jobId } = args as z.infer<z.ZodObject<typeof JobArgs>>;
  const url = `${API_BASE_URL}/api/v1/jobs/${encodeURIComponent(jobId)}`;
  const res = await fetch(url, {
@@ -68,6 +69,34 @@ mcp.tool('jobs_get', 'Get job status/result by jobId from 2slides.', JobArgs, as
  return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
 });
 
+// Tool: themes_search -> GET /api/v1/themes/search
+const ThemesSearchArgs = {
+ query: z.string().min(1),
+ limit: z.number().int().positive().max(100).optional(),
+};
+
+mcp.tool('themes_search', 'Search 2slides themes by query. Optional limit (max 100).', ThemesSearchArgs, async (args: any, _extra: any) => {
+ const { query, limit } = args as z.infer<z.ZodObject<typeof ThemesSearchArgs>>;
+ const search = new URLSearchParams({ query });
+ if (typeof limit === 'number') search.set('limit', String(limit));
+ const url = `${API_BASE_URL}/api/v1/themes/search?${search.toString()}`;
+ const res = await fetch(url, {
+ method: 'GET',
+ headers: {
+ Authorization: `Bearer ${API_KEY}`,
+ 'Content-Type': 'application/json',
+ },
+ });
+ const data = await res.json();
+ if (!res.ok) {
+ return {
+ content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+ isError: true,
+ };
+ }
+ return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+});
+
 // Start server over stdio
 const transport = new StdioServerTransport();
 mcp.connect(transport).catch((err: unknown) => {

src/cli.ts

@@ -0,0 +1,11 @@
+declare module '@modelcontextprotocol/sdk/server/mcp' {
+ export const McpServer: any;
+}
+
+declare module '@modelcontextprotocol/sdk/server/stdio' {
+ export const StdioServerTransport: any;
+}
+
+
+
+

src/server.ts

@@ -9,7 +9,7 @@
  // See also https://aka.ms/tsconfig/module
  "module": "nodenext",
  "target": "es2022",
- "types": [],
+ "types": ["node"],
  // For nodejs:
  // "lib": ["esnext"],
  // "types": ["node"],