deckpipe-mcp 0.1.0

package/README.md

@@ -0,0 +1,93 @@
+# deckpipe-mcp
+
+MCP server for [deckpipe](https://deckpipe.com) — create and edit slide decks from any AI agent.
+
+## Install
+
+**Claude Code**
+```bash
+claude mcp add deckpipe -- npx deckpipe-mcp
+```
+
+**Manual MCP config** (Claude Desktop, Cursor, etc.)
+```json
+{
+  "mcpServers": {
+    "deckpipe": {
+      "command": "npx",
+      "args": ["-y", "deckpipe-mcp"]
+    }
+  }
+}
+```
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `create_deck` | Create a new deck and get a shareable viewer URL |
+| `get_deck` | Retrieve a deck by ID |
+| `update_deck` | Update title, fonts, accent color, or individual slides by index |
+| `delete_deck` | Delete a deck permanently |
+| `upload_image` | Upload a base64 image, get a hosted URL |
+| `list_layouts` | List available layouts, customization options, and style guide |
+
+## Layouts
+
+| Layout | Description | Required Fields |
+|--------|-------------|----------------|
+| `title` | Large centered title slide | `title`, optional `subtitle`, `image_url` |
+| `title_and_body` | Title + paragraph | `title`, `body`, optional `image_url` |
+| `title_and_bullets` | Title + bullet list | `title`, `bullets[]`, optional `image_url` |
+| `title_and_table` | Title + data table | `title`, `table: { headers[], rows[][] }` |
+| `two_columns` | Title + two columns | `title`, `left: { heading, body }`, `right: { heading, body }` |
+| `section_break` | Bold section divider | `title` |
+| `image_and_text` | Image-primary (~60%) + text | `title`, `body`, `image_url` |
+| `image_gallery` | Horizontal row of portrait images | `images[]` (2-5 URLs), optional `title`, `caption` |
+| `stats` | Big metrics/numbers with labels | `metrics[]: { value, label }` (2-4), optional `title` |
+| `quote` | Large pull-quote with attribution | `quote`, optional `attribution`, `image_url` |
+| `full_image` | Full-bleed background image with overlay text | `image_url`, optional `title`, `subtitle` |
+
+All layouts support an optional `key_takeaway` field — a highlighted sentence rendered below the title.
+
+## Customization
+
+Both `create_deck` and `update_deck` accept optional styling fields:
+
+| Field | Description | Default |
+|-------|-------------|---------|
+| `heading_font` | Google Font for headings (e.g. `"Playfair Display"`, `"Space Grotesk"`) | DM Sans |
+| `body_font` | Google Font for body text (e.g. `"Inter"`, `"Roboto"`) | DM Sans |
+| `accent_color` | Hex color (e.g. `"#ff6600"`) | `#7c3aed` (purple) |
+
+## Example prompts
+
+> Create a deck about the rise of electric vehicles. Search the web for relevant photos and use them. Use heading font "Space Grotesk", body font "Inter", and accent color "#0ea5e9".
+
+> Create a deck about the Apollo 11 moon landing. Search the web for historic NASA photos and use them as full-bleed images. Include a timeline of the mission, stats on the Saturn V rocket, and a famous quote from Neil Armstrong. Use heading font "Libre Baskerville" and accent color "#1e3a5f".
+
+> Build a lecture deck on how neural networks learn. Use a comparison table for activation functions, bullet points for key concepts, and add a key takeaway to each slide.
+
+> Create a travel guide deck for Tokyo. Search the web for photos and include an image gallery of must-visit spots, stats on tourism, and a full-bleed image cover slide.
+
+## Configuration
+
+By default the MCP server connects to `https://deckpipe.com`. To use a different API endpoint:
+
+```json
+{
+  "mcpServers": {
+    "deckpipe": {
+      "command": "npx",
+      "args": ["-y", "deckpipe-mcp"],
+      "env": {
+        "DECKPIPE_API_URL": "http://localhost:3010"
+      }
+    }
+  }
+}
+```
+
+## License
+
+MIT

package/dist/config.d.ts

@@ -0,0 +1,3 @@
+export declare const config: {
+    apiUrl: string;
+};

package/dist/config.js

@@ -0,0 +1,4 @@
+export const config = {
+    apiUrl: process.env.DECKPIPE_API_URL || 'https://deckpipe.com',
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,sBAAsB;CAC/D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,153 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { config } from './config.js';
+const server = new McpServer({
+    name: 'deckpipe',
+    version: '0.1.0',
+});
+// --- create_deck ---
+server.tool('create_deck', `Create a new slide deck and get a shareable viewer URL.
+
+Keep slide copy short and scannable — use shorthand phrases, not full sentences. Bullets: 5-8 words max.
+
+Layouts: "title", "title_and_body", "title_and_bullets", "title_and_table", "two_columns", "section_break", "image_and_text", "image_gallery", "stats", "quote", "full_image".
+
+Content fields per layout (all layouts support optional key_takeaway):
+- title: { title, subtitle?, image_url? }
+- title_and_body: { title, body, image_url? }
+- title_and_bullets: { title, bullets[], image_url? }
+- title_and_table: { title, table: { headers[], rows[][], highlight_column? } }
+- two_columns: { title, left: { heading, body }, right: { heading, body }, image_url? }
+- section_break: { title }
+- image_and_text: { title, body, image_url (required) }
+- image_gallery: { title?, caption?, images[] (2-5 URLs) }
+- stats: { title?, metrics[]: { value, label } (2-4 items) }
+- quote: { quote, attribution?, image_url? }
+- full_image: { image_url (required), title?, subtitle? }
+
+Optionally set heading_font and body_font (any Google Font name) and accent_color (hex like "#ff6600") to customize the look.
+Use upload_image first to get hosted URLs for any images.`, {
+    title: z.string().describe('Deck title'),
+    heading_font: z.string().optional().describe('Google Font for headings (e.g. "Playfair Display"). Default: DM Sans.'),
+    body_font: z.string().optional().describe('Google Font for body text (e.g. "Inter"). Default: DM Sans.'),
+    accent_color: z.string().optional().describe('Hex color (e.g. "#ff6600"). Overrides default purple accent.'),
+    slides: z.array(z.object({
+        layout: z.enum(['title', 'title_and_body', 'title_and_bullets', 'title_and_table', 'two_columns', 'section_break', 'image_and_text', 'image_gallery', 'stats', 'quote', 'full_image']),
+        content: z.record(z.unknown()).describe('Content fields (vary by layout). All layouts support optional key_takeaway.'),
+    })).describe('Array of slides'),
+}, async (args) => {
+    const res = await fetch(`${config.apiUrl}/v1/decks`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(args),
+    });
+    const data = await res.json();
+    if (!res.ok)
+        return { content: [{ type: 'text', text: `Error: ${JSON.stringify(data)}` }] };
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+});
+// --- get_deck ---
+server.tool('get_deck', 'Retrieve a deck by ID, including any user edits made in the viewer.', {
+    deck_id: z.string().describe('The deck ID (e.g. "dk_a1b2c3d4")'),
+}, async ({ deck_id }) => {
+    const res = await fetch(`${config.apiUrl}/v1/decks/${deck_id}`);
+    const data = await res.json();
+    if (!res.ok)
+        return { content: [{ type: 'text', text: `Error: ${JSON.stringify(data)}` }] };
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+});
+// --- update_deck ---
+server.tool('update_deck', `Update a deck's title, fonts, accent color, or individual slide content. Slides are updated by index with partial content merge.
+
+Example: { "deck_id": "dk_abc", "slides": [{ "index": 2, "content": { "title": "New Title" } }] }`, {
+    deck_id: z.string().describe('Deck ID to update'),
+    title: z.string().optional().describe('New deck title'),
+    heading_font: z.string().optional().describe('Google Font for headings (e.g. "Playfair Display")'),
+    body_font: z.string().optional().describe('Google Font for body text (e.g. "Inter")'),
+    accent_color: z.string().optional().describe('Hex color (e.g. "#ff6600")'),
+    slides: z.array(z.object({
+        index: z.number().describe('Zero-based slide index'),
+        content: z.record(z.unknown()).describe('Partial content to merge'),
+    })).optional().describe('Slide updates'),
+}, async ({ deck_id, ...body }) => {
+    const res = await fetch(`${config.apiUrl}/v1/decks/${deck_id}`, {
+        method: 'PATCH',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(body),
+    });
+    const data = await res.json();
+    if (!res.ok)
+        return { content: [{ type: 'text', text: `Error: ${JSON.stringify(data)}` }] };
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+});
+// --- delete_deck ---
+server.tool('delete_deck', 'Delete a deck permanently.', {
+    deck_id: z.string().describe('Deck ID to delete'),
+}, async ({ deck_id }) => {
+    const res = await fetch(`${config.apiUrl}/v1/decks/${deck_id}`, { method: 'DELETE' });
+    if (res.status === 204) {
+        return { content: [{ type: 'text', text: `Deck ${deck_id} deleted successfully.` }] };
+    }
+    const data = await res.json();
+    return { content: [{ type: 'text', text: `Error: ${JSON.stringify(data)}` }] };
+});
+// --- upload_image ---
+server.tool('upload_image', `Upload a base64-encoded image to get a hosted URL for use in slide image_url fields.
+
+Accepts PNG, JPG, WebP up to 10MB. Upload first, then use the returned URL when creating or updating a deck.`, {
+    image_data: z.string().describe('Base64-encoded image data'),
+    filename: z.string().describe('Filename with extension (e.g. "photo.jpg")'),
+    content_type: z.enum(['image/png', 'image/jpeg', 'image/webp']).describe('MIME type'),
+}, async ({ image_data, filename, content_type }) => {
+    const buffer = Buffer.from(image_data, 'base64');
+    const blob = new Blob([buffer], { type: content_type });
+    const form = new FormData();
+    form.append('file', blob, filename);
+    const res = await fetch(`${config.apiUrl}/v1/images`, {
+        method: 'POST',
+        body: form,
+    });
+    const data = await res.json();
+    if (!res.ok)
+        return { content: [{ type: 'text', text: `Error: ${JSON.stringify(data)}` }] };
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+});
+// --- list_layouts ---
+server.tool('list_layouts', 'List all available slide layouts, their content fields, and themes. Use this to discover what is supported before creating a deck.', {}, async () => {
+    const layouts = [
+        { name: 'title', description: 'Large centered title slide.', fields: 'title (required), subtitle?, image_url?, key_takeaway?' },
+        { name: 'title_and_body', description: 'Title + paragraph.', fields: 'title (required), body (required), image_url?, key_takeaway?' },
+        { name: 'title_and_bullets', description: 'Title + bullet list.', fields: 'title (required), bullets[] (required), image_url?, key_takeaway?' },
+        { name: 'title_and_table', description: 'Title + data table.', fields: 'title (required), table: { headers[], rows[][], highlight_column? }, key_takeaway?' },
+        { name: 'two_columns', description: 'Title + two columns.', fields: 'title (required), left: { heading, body }, right: { heading, body }, image_url?, key_takeaway?' },
+        { name: 'section_break', description: 'Bold section divider on accent bg.', fields: 'title (required), key_takeaway?' },
+        { name: 'image_and_text', description: 'Image-primary (~60%) + text.', fields: 'title (required), body (required), image_url (required), key_takeaway?' },
+        { name: 'image_gallery', description: 'Horizontal row of portrait images — ideal for screenshot galleries.', fields: 'images[] (2-5 URLs, required), title?, caption?, key_takeaway?' },
+        { name: 'stats', description: 'Big metrics/numbers with labels.', fields: 'metrics[]: { value, label } (2-4 items, required), title?, key_takeaway?' },
+        { name: 'quote', description: 'Large pull-quote with optional attribution.', fields: 'quote (required), attribution?, image_url?, key_takeaway?' },
+        { name: 'full_image', description: 'Full-bleed background image with optional overlay text.', fields: 'image_url (required), title?, subtitle?, key_takeaway?' },
+    ];
+    const customization = {
+        heading_font: 'Optional Google Font for headings (e.g. "Playfair Display"). Default: DM Sans.',
+        body_font: 'Optional Google Font for body text (e.g. "Inter"). Default: DM Sans.',
+        accent_color: 'Optional hex color (e.g. "#ff6600"). Default: #7c3aed (purple).',
+    };
+    const style_guide = {
+        copy: 'Keep text short and scannable. Use shorthand phrases, not full sentences. Bullets: 5-8 words max. Stats: abbreviate large numbers (e.g. "2.4M" not "2,400,000"). Quotes: under 30 words.',
+        images: 'Use upload_image to host images. image_gallery works best with 2-5 portrait images of consistent aspect ratio. full_image needs high-res landscape images.',
+    };
+    return { content: [{ type: 'text', text: JSON.stringify({ layouts, customization, style_guide }, null, 2) }] };
+});
+// Start with stdio transport
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('Deckpipe MCP server running on stdio');
+}
+main().catch((err) => {
+    console.error('MCP server error:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/create-deck.d.ts

@@ -0,0 +1,43 @@
+export declare const createDeckTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            title: {
+                type: string;
+                description: string;
+            };
+            theme: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            slides: {
+                type: string;
+                description: string;
+                items: {
+                    type: string;
+                    properties: {
+                        layout: {
+                            type: string;
+                            enum: string[];
+                        };
+                        content: {
+                            type: string;
+                            description: string;
+                        };
+                    };
+                    required: string[];
+                };
+            };
+        };
+        required: string[];
+    };
+    execute(args: Record<string, unknown>): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/dist/tools/create-deck.js

@@ -0,0 +1,67 @@
+import { config } from '../config.js';
+export const createDeckTool = {
+    name: 'create_deck',
+    description: `Create a new slide deck and get a shareable viewer URL.
+
+INPUT:
+- title (string, required): The deck title.
+- theme (string, optional): Visual theme. One of: "minimal" (clean, light, Inter font), "modern" (bold, vibrant, DM Sans), "classic" (warm, serif headings, earth tones). Default: "minimal".
+- slides (array, required, 1-50 items): Array of slide objects. Each slide has:
+  - layout (string, required): One of: "title", "title_and_body", "title_and_bullets", "title_and_table", "two_columns", "section_break", "image_and_text".
+  - content (object, required): Fields depend on layout:
+    - title: { title, subtitle? }
+    - title_and_body: { title, body }
+    - title_and_bullets: { title, bullets[] }
+    - title_and_table: { title, table: { headers[], rows[][], highlight_column? } }
+    - two_columns: { title, left: { heading, body }, right: { heading, body } }
+    - section_break: { title }
+    - image_and_text: { title, body, image_url (required) }
+  - All layouts except section_break accept an optional image_url field.
+
+EXAMPLE:
+{
+  "title": "Q1 Update",
+  "theme": "modern",
+  "slides": [
+    { "layout": "title", "content": { "title": "Q1 Update", "subtitle": "March 2026" } },
+    { "layout": "title_and_bullets", "content": { "title": "Highlights", "bullets": ["Revenue up 25%", "3 new features shipped"] } }
+  ]
+}
+
+RETURNS: { deck_id, viewer_url, created_at, slide_count }`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            title: { type: 'string', description: 'Deck title' },
+            theme: { type: 'string', enum: ['minimal', 'modern', 'classic'], description: 'Visual theme (default: minimal)' },
+            slides: {
+                type: 'array',
+                description: 'Array of slide objects with layout and content',
+                items: {
+                    type: 'object',
+                    properties: {
+                        layout: { type: 'string', enum: ['title', 'title_and_body', 'title_and_bullets', 'title_and_table', 'two_columns', 'section_break', 'image_and_text'] },
+                        content: { type: 'object', description: 'Content fields (vary by layout)' },
+                    },
+                    required: ['layout', 'content'],
+                },
+            },
+        },
+        required: ['title', 'slides'],
+    },
+    async execute(args) {
+        const res = await fetch(`${config.apiUrl}/v1/decks`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(args),
+        });
+        const data = await res.json();
+        if (!res.ok) {
+            return { content: [{ type: 'text', text: `Error: ${JSON.stringify(data)}` }] };
+        }
+        return {
+            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+        };
+    },
+};
+//# sourceMappingURL=create-deck.js.map

package/dist/tools/create-deck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-deck.js","sourceRoot":"","sources":["../../src/tools/create-deck.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;0DA2B2C;IACxD,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE;YACpD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,WAAW,EAAE,iCAAiC,EAAE;YACjH,MAAM,EAAE;gBACN,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,gDAAgD;gBAC7D,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,aAAa,EAAE,eAAe,EAAE,gBAAgB,CAAC,EAAE;wBACvJ,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iCAAiC,EAAE;qBAC5E;oBACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;iBAChC;aACF;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC;KAC9B;IACD,KAAK,CAAC,OAAO,CAAC,IAA6B;QACzC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,WAAW,EAAE;YACnD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QAC1F,CAAC;QAED,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SAC1E,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/tools/delete-deck.d.ts

@@ -0,0 +1,20 @@
+export declare const deleteDeckTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            deck_id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute(args: Record<string, unknown>): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/dist/tools/delete-deck.js

@@ -0,0 +1,26 @@
+import { config } from '../config.js';
+export const deleteDeckTool = {
+    name: 'delete_deck',
+    description: `Delete a deck permanently.
+
+INPUT:
+- deck_id (string, required): The deck ID to delete.
+
+RETURNS: Confirmation of deletion.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            deck_id: { type: 'string', description: 'Deck ID to delete' },
+        },
+        required: ['deck_id'],
+    },
+    async execute(args) {
+        const res = await fetch(`${config.apiUrl}/v1/decks/${args.deck_id}`, { method: 'DELETE' });
+        if (res.status === 204) {
+            return { content: [{ type: 'text', text: `Deck ${args.deck_id} deleted successfully.` }] };
+        }
+        const data = await res.json();
+        return { content: [{ type: 'text', text: `Error: ${JSON.stringify(data)}` }] };
+    },
+};
+//# sourceMappingURL=delete-deck.js.map

package/dist/tools/delete-deck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-deck.js","sourceRoot":"","sources":["../../src/tools/delete-deck.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE;;;;;mCAKoB;IACjC,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE;SAC9D;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IACD,KAAK,CAAC,OAAO,CAAC,IAA6B;QACzC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,aAAa,IAAI,CAAC,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC3F,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACvB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,QAAQ,IAAI,CAAC,OAAO,wBAAwB,EAAE,CAAC,EAAE,CAAC;QACtG,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IAC1F,CAAC;CACF,CAAC"}

package/dist/tools/get-deck.d.ts

@@ -0,0 +1,20 @@
+export declare const getDeckTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            deck_id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute(args: Record<string, unknown>): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/dist/tools/get-deck.js

@@ -0,0 +1,26 @@
+import { config } from '../config.js';
+export const getDeckTool = {
+    name: 'get_deck',
+    description: `Retrieve a deck's current state, including any user edits made in the viewer.
+
+INPUT:
+- deck_id (string, required): The deck ID (e.g. "dk_a1b2c3d4").
+
+RETURNS: Full deck object with deck_id, title, theme, slides array, created_at, updated_at.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            deck_id: { type: 'string', description: 'The deck ID to retrieve' },
+        },
+        required: ['deck_id'],
+    },
+    async execute(args) {
+        const res = await fetch(`${config.apiUrl}/v1/decks/${args.deck_id}`);
+        const data = await res.json();
+        if (!res.ok) {
+            return { content: [{ type: 'text', text: `Error: ${JSON.stringify(data)}` }] };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    },
+};
+//# sourceMappingURL=get-deck.js.map

package/dist/tools/get-deck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-deck.js","sourceRoot":"","sources":["../../src/tools/get-deck.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE;;;;;4FAK6E;IAC1F,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;SACpE;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IACD,KAAK,CAAC,OAAO,CAAC,IAA6B;QACzC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,aAAa,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACrE,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QAC1F,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACvF,CAAC;CACF,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,6 @@
+export { createDeckTool } from './create-deck.js';
+export { getDeckTool } from './get-deck.js';
+export { updateDeckTool } from './update-deck.js';
+export { deleteDeckTool } from './delete-deck.js';
+export { uploadImageTool } from './upload-image.js';
+export { listLayoutsTool } from './list-layouts.js';

package/dist/tools/index.js

@@ -0,0 +1,7 @@
+export { createDeckTool } from './create-deck.js';
+export { getDeckTool } from './get-deck.js';
+export { updateDeckTool } from './update-deck.js';
+export { deleteDeckTool } from './delete-deck.js';
+export { uploadImageTool } from './upload-image.js';
+export { listLayoutsTool } from './list-layouts.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/tools/list-layouts.d.ts

@@ -0,0 +1,14 @@
+export declare const listLayoutsTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+    };
+    execute(): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/dist/tools/list-layouts.js

@@ -0,0 +1,88 @@
+export const listLayoutsTool = {
+    name: 'list_layouts',
+    description: `List all available slide layouts and themes. Use this to discover what layouts and content fields are supported before creating a deck. No input required.`,
+    inputSchema: {
+        type: 'object',
+        properties: {},
+    },
+    async execute() {
+        const layouts = [
+            {
+                name: 'title',
+                description: 'Opening or closing slide with a large centered title.',
+                fields: {
+                    title: { type: 'string', required: true },
+                    subtitle: { type: 'string', required: false },
+                    image_url: { type: 'url', required: false, behavior: 'Background or centered below title' },
+                },
+            },
+            {
+                name: 'title_and_body',
+                description: 'Title with a body paragraph. Good for explanatory slides.',
+                fields: {
+                    title: { type: 'string', required: true },
+                    body: { type: 'string', required: true },
+                    image_url: { type: 'url', required: false, behavior: 'Beside text (landscape) or below (portrait)' },
+                },
+            },
+            {
+                name: 'title_and_bullets',
+                description: 'Title with a bullet point list. Best for key points, features, or metrics.',
+                fields: {
+                    title: { type: 'string', required: true },
+                    bullets: { type: 'string[]', required: true },
+                    image_url: { type: 'url', required: false, behavior: 'Right column alongside bullets' },
+                },
+            },
+            {
+                name: 'title_and_table',
+                description: 'Title with a data table. Use for comparisons, pricing, feature matrices.',
+                fields: {
+                    title: { type: 'string', required: true },
+                    table: {
+                        type: 'object', required: true,
+                        properties: {
+                            headers: { type: 'string[]', required: true, max_items: 6 },
+                            rows: { type: 'string[][]', required: true, max_items: 8 },
+                            highlight_column: { type: 'integer', required: false, description: 'Zero-indexed column to emphasize' },
+                        },
+                    },
+                },
+            },
+            {
+                name: 'two_columns',
+                description: 'Title with two side-by-side columns. Each column has a heading and body text. Good for comparisons.',
+                fields: {
+                    title: { type: 'string', required: true },
+                    left: { type: 'object', required: true, properties: { heading: 'string', body: 'string' } },
+                    right: { type: 'object', required: true, properties: { heading: 'string', body: 'string' } },
+                    image_url: { type: 'url', required: false, behavior: 'Spans below both columns' },
+                },
+            },
+            {
+                name: 'section_break',
+                description: 'Bold section divider with a centered title on an accent background. No image support.',
+                fields: {
+                    title: { type: 'string', required: true },
+                },
+            },
+            {
+                name: 'image_and_text',
+                description: 'Image-primary slide (~60% image, ~40% text). Image is required.',
+                fields: {
+                    title: { type: 'string', required: true },
+                    body: { type: 'string', required: true },
+                    image_url: { type: 'url', required: true, behavior: 'Primary — takes ~60% of slide' },
+                },
+            },
+        ];
+        const themes = ['minimal', 'modern', 'classic'];
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ layouts, themes }, null, 2),
+                }],
+        };
+    },
+};
+//# sourceMappingURL=list-layouts.js.map

package/dist/tools/list-layouts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-layouts.js","sourceRoot":"","sources":["../../src/tools/list-layouts.ts"],"names":[],"mappings":"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"}

package/dist/tools/update-deck.d.ts

@@ -0,0 +1,45 @@
+export declare const updateDeckTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            deck_id: {
+                type: string;
+                description: string;
+            };
+            title: {
+                type: string;
+                description: string;
+            };
+            theme: {
+                type: string;
+                enum: string[];
+            };
+            slides: {
+                type: string;
+                items: {
+                    type: string;
+                    properties: {
+                        index: {
+                            type: string;
+                            description: string;
+                        };
+                        content: {
+                            type: string;
+                            description: string;
+                        };
+                    };
+                    required: string[];
+                };
+            };
+        };
+        required: string[];
+    };
+    execute(args: Record<string, unknown>): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/dist/tools/update-deck.js

@@ -0,0 +1,52 @@
+import { config } from '../config.js';
+export const updateDeckTool = {
+    name: 'update_deck',
+    description: `Update an existing deck's title, theme, or individual slide content.
+
+INPUT:
+- deck_id (string, required): The deck ID to update.
+- title (string, optional): New deck title.
+- theme (string, optional): New theme ("minimal", "modern", "classic").
+- slides (array, optional): Array of slide updates. Each has:
+  - index (number): Zero-based slide index to update.
+  - content (object): Partial content fields to merge into the existing slide content.
+
+EXAMPLE: Update slide 2's title:
+{ "deck_id": "dk_abc123", "slides": [{ "index": 2, "content": { "title": "New Title" } }] }
+
+RETURNS: Full updated deck object.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            deck_id: { type: 'string', description: 'Deck ID to update' },
+            title: { type: 'string', description: 'New deck title' },
+            theme: { type: 'string', enum: ['minimal', 'modern', 'classic'] },
+            slides: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    properties: {
+                        index: { type: 'number', description: 'Zero-based slide index' },
+                        content: { type: 'object', description: 'Partial content to merge' },
+                    },
+                    required: ['index', 'content'],
+                },
+            },
+        },
+        required: ['deck_id'],
+    },
+    async execute(args) {
+        const { deck_id, ...body } = args;
+        const res = await fetch(`${config.apiUrl}/v1/decks/${deck_id}`, {
+            method: 'PATCH',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+        });
+        const data = await res.json();
+        if (!res.ok) {
+            return { content: [{ type: 'text', text: `Error: ${JSON.stringify(data)}` }] };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    },
+};
+//# sourceMappingURL=update-deck.js.map

package/dist/tools/update-deck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-deck.js","sourceRoot":"","sources":["../../src/tools/update-deck.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE;;;;;;;;;;;;;mCAaoB;IACjC,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE;YAC7D,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE;YACxD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE;YACjE,MAAM,EAAE;gBACN,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;wBAChE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE;qBACrE;oBACD,QAAQ,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC;iBAC/B;aACF;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IACD,KAAK,CAAC,OAAO,CAAC,IAA6B;QACzC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAClC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,aAAa,OAAO,EAAE,EAAE;YAC9D,MAAM,EAAE,OAAO;YACf,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QAC1F,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACvF,CAAC;CACF,CAAC"}

package/dist/tools/upload-image.d.ts

@@ -0,0 +1,28 @@
+export declare const uploadImageTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            image_data: {
+                type: string;
+                description: string;
+            };
+            filename: {
+                type: string;
+                description: string;
+            };
+            content_type: {
+                type: string;
+                enum: string[];
+            };
+        };
+        required: string[];
+    };
+    execute(args: Record<string, unknown>): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/dist/tools/upload-image.js

@@ -0,0 +1,42 @@
+import { config } from '../config.js';
+export const uploadImageTool = {
+    name: 'upload_image',
+    description: `Upload a base64-encoded image to get a hosted URL for use in slide image_url fields.
+
+Use this to upload local files (screenshots, charts, logos) from the user's machine.
+
+INPUT:
+- image_data (string, required): Base64-encoded image data.
+- filename (string, required): Filename with extension (e.g. "screenshot.png").
+- content_type (string, required): MIME type — "image/png", "image/jpeg", or "image/webp".
+
+RETURNS: { image_id, url } — use the url in any slide's image_url field.
+
+WORKFLOW: Upload the image first, then use the returned URL when creating or updating a deck.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            image_data: { type: 'string', description: 'Base64-encoded image data' },
+            filename: { type: 'string', description: 'Filename (e.g. screenshot.png)' },
+            content_type: { type: 'string', enum: ['image/png', 'image/jpeg', 'image/webp'] },
+        },
+        required: ['image_data', 'filename', 'content_type'],
+    },
+    async execute(args) {
+        const { image_data, filename, content_type } = args;
+        const buffer = Buffer.from(image_data, 'base64');
+        const blob = new Blob([buffer], { type: content_type });
+        const form = new FormData();
+        form.append('file', blob, filename);
+        const res = await fetch(`${config.apiUrl}/v1/images`, {
+            method: 'POST',
+            body: form,
+        });
+        const data = await res.json();
+        if (!res.ok) {
+            return { content: [{ type: 'text', text: `Error: ${JSON.stringify(data)}` }] };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    },
+};
+//# sourceMappingURL=upload-image.js.map

package/dist/tools/upload-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-image.js","sourceRoot":"","sources":["../../src/tools/upload-image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE;;;;;;;;;;;8FAW+E;IAC5F,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;YACxE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE;YAC3E,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,YAAY,EAAE,YAAY,CAAC,EAAE;SAClF;QACD,QAAQ,EAAE,CAAC,YAAY,EAAE,UAAU,EAAE,cAAc,CAAC;KACrD;IACD,KAAK,CAAC,OAAO,CAAC,IAA6B;QACzC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,IAI9C,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;QAExD,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QAEpC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,YAAY,EAAE;YACpD,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI;SACX,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QAC1F,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACvF,CAAC;CACF,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "deckpipe-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for Deckpipe — create, edit, and export slide decks from any AI agent",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "deckpipe-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "slides",
+    "presentations",
+    "ai",
+    "agent"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.8.0",
+    "zod": "^3.24.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "tsx": "^4.19.3",
+    "typescript": "^5.7.3"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bjoern2000/deckpipe-mcp"
+  }
+}