figmanage 0.1.0

package/dist/tools/webhooks.js

@@ -0,0 +1,126 @@
+import { z } from 'zod';
+import { publicClient } from '../clients/public-api.js';
+import { defineTool, toolResult, toolError, figmaId } from './register.js';
+const eventTypeEnum = z.enum([
+    'FILE_UPDATE',
+    'FILE_DELETE',
+    'FILE_VERSION_UPDATE',
+    'LIBRARY_PUBLISH',
+    'FILE_COMMENT',
+    'PING',
+]);
+// -- list_webhooks --
+defineTool({
+    toolset: 'webhooks',
+    auth: 'pat',
+    register(server, config) {
+        server.registerTool('list_webhooks', {
+            description: 'List webhooks for a team.',
+            inputSchema: {
+                team_id: figmaId.describe('Team ID'),
+            },
+        }, async ({ team_id }) => {
+            try {
+                const res = await publicClient(config).get(`/v2/teams/${team_id}/webhooks`);
+                const webhooks = res.data?.webhooks || [];
+                return toolResult(JSON.stringify(webhooks, null, 2));
+            }
+            catch (e) {
+                return toolError(`Failed to list webhooks: ${e.response?.status || e.message}`);
+            }
+        });
+    },
+});
+// -- create_webhook --
+defineTool({
+    toolset: 'webhooks',
+    auth: 'pat',
+    mutates: true,
+    register(server, config) {
+        server.registerTool('create_webhook', {
+            description: 'Create a webhook subscription for a team.',
+            inputSchema: {
+                team_id: figmaId.describe('Team ID'),
+                event_type: eventTypeEnum.describe('Event type to subscribe to'),
+                endpoint: z.string().describe('URL to receive webhook payloads'),
+                passcode: z.string().describe('Secret for signature verification'),
+                description: z.string().optional().describe('Webhook description'),
+            },
+        }, async ({ team_id, event_type, endpoint, passcode, description }) => {
+            try {
+                const body = { team_id, event_type, endpoint, passcode };
+                if (description)
+                    body.description = description;
+                const res = await publicClient(config).post('/v2/webhooks', body);
+                const { passcode: _, ...safe } = res.data || {};
+                return toolResult(JSON.stringify(safe, null, 2));
+            }
+            catch (e) {
+                return toolError(`Failed to create webhook: ${e.response?.status || e.message}`);
+            }
+        });
+    },
+});
+// -- update_webhook --
+defineTool({
+    toolset: 'webhooks',
+    auth: 'pat',
+    mutates: true,
+    register(server, config) {
+        server.registerTool('update_webhook', {
+            description: 'Update a webhook.',
+            inputSchema: {
+                webhook_id: figmaId.describe('Webhook ID'),
+                event_type: eventTypeEnum.optional().describe('Event type to subscribe to'),
+                endpoint: z.string().optional().describe('URL to receive webhook payloads'),
+                passcode: z.string().optional().describe('Secret for signature verification'),
+                description: z.string().optional().describe('Webhook description'),
+                status: z.enum(['ACTIVE', 'PAUSED']).optional().describe('Webhook status'),
+            },
+        }, async ({ webhook_id, event_type, endpoint, passcode, description, status }) => {
+            try {
+                const body = {};
+                if (event_type)
+                    body.event_type = event_type;
+                if (endpoint)
+                    body.endpoint = endpoint;
+                if (passcode)
+                    body.passcode = passcode;
+                if (description)
+                    body.description = description;
+                if (status)
+                    body.status = status;
+                const res = await publicClient(config).put(`/v2/webhooks/${webhook_id}`, body);
+                const { passcode: _, ...safe } = res.data || {};
+                return toolResult(JSON.stringify(safe, null, 2));
+            }
+            catch (e) {
+                return toolError(`Failed to update webhook: ${e.response?.status || e.message}`);
+            }
+        });
+    },
+});
+// -- delete_webhook --
+defineTool({
+    toolset: 'webhooks',
+    auth: 'pat',
+    mutates: true,
+    destructive: true,
+    register(server, config) {
+        server.registerTool('delete_webhook', {
+            description: 'Delete a webhook.',
+            inputSchema: {
+                webhook_id: figmaId.describe('Webhook ID'),
+            },
+        }, async ({ webhook_id }) => {
+            try {
+                await publicClient(config).delete(`/v2/webhooks/${webhook_id}`);
+                return toolResult(`Deleted webhook ${webhook_id}`);
+            }
+            catch (e) {
+                return toolError(`Failed to delete webhook: ${e.response?.status || e.message}`);
+            }
+        });
+    },
+});
+//# sourceMappingURL=webhooks.js.map

package/dist/types/figma.d.ts

@@ -0,0 +1,58 @@
+export interface AuthStatus {
+    pat: {
+        valid: boolean;
+        user?: string;
+        error?: string;
+    };
+    cookie: {
+        valid: boolean;
+        user?: string;
+        error?: string;
+    };
+}
+export interface FigmaTeam {
+    id: string;
+    name: string;
+}
+export interface FigmaProject {
+    id: string;
+    name: string;
+    team_id?: string;
+}
+export interface FigmaFile {
+    key: string;
+    name: string;
+    last_modified?: string;
+    thumbnail_url?: string;
+    editor_type?: string;
+}
+export interface FigmaFileMeta {
+    key: string;
+    name: string;
+    last_modified: string;
+    thumbnail_url?: string;
+    editor_type?: string;
+    folder_id?: string;
+    team_id?: string;
+}
+export interface PaginatedResponse<T> {
+    items: T[];
+    total?: number;
+    has_more: boolean;
+    next_page_token?: string;
+}
+export interface FigmaUser {
+    id: string;
+    handle: string;
+    email: string;
+    img_url?: string;
+}
+export interface FigmaRole {
+    user_id: string;
+    role: string;
+    email?: string;
+    handle?: string;
+}
+export type EditorType = 'design' | 'whiteboard' | 'slides' | 'sites' | 'figmake';
+export type Toolset = 'navigate' | 'files' | 'projects' | 'permissions' | 'org' | 'versions' | 'branching' | 'comments' | 'export' | 'analytics' | 'reading' | 'components' | 'webhooks' | 'variables' | 'compound' | 'teams' | 'libraries';
+//# sourceMappingURL=figma.d.ts.map

package/dist/types/figma.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=figma.js.map

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "figmanage",
+  "version": "0.1.0",
+  "description": "MCP server for managing your Figma workspace from the terminal.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "figmanage": "dist/index.js"
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "setup": "node dist/setup.js",
+    "lint": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "figma",
+    "mcp",
+    "figmanage",
+    "workspace",
+    "admin",
+    "management",
+    "figma-manager"
+  ],
+  "author": "Danny Keane",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dannykeane/figmanage.git"
+  },
+  "homepage": "https://github.com/dannykeane/figmanage#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.0",
+    "axios": "^1.7.0",
+    "axios-retry": "^4.4.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0",
+    "vitest": "^4.1.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}