@denisixnpm/planka-mcp 2.2.0

package/dist/tools/admin/tools.js

@@ -0,0 +1,211 @@
+import { buildGroupedSchema } from "../types.js";
+/**
+ * Config tool - manages application configuration (admin only)
+ */
+export const configTool = {
+    name: "config",
+    description: "Manage Planka application configuration. Requires admin privileges.",
+    operations: {
+        get: {
+            method: "GET",
+            path: "/config",
+            description: "Get application configuration including SMTP settings",
+        },
+        update: {
+            method: "PATCH",
+            path: "/config",
+            description: "Update application configuration",
+        },
+        testSmtp: {
+            method: "POST",
+            path: "/config/test-smtp",
+            description: "Send a test email to verify SMTP configuration",
+        },
+    },
+    inputSchema: buildGroupedSchema(["get", "update", "testSmtp"], {
+        get: "Get application configuration",
+        update: "Update application configuration",
+        testSmtp: "Test SMTP configuration by sending a test email",
+    }, {
+        data: {
+            description: "Config data: { smtpHost?: string, smtpPort?: number, smtpUser?: string, smtpPassword?: string, smtpFrom?: string, smtpSecure?: boolean }",
+            requiredFor: ["update"],
+            properties: {
+                smtpHost: { type: "string", description: "SMTP host" },
+                smtpPort: { type: "number", description: "SMTP port" },
+                smtpUser: { type: "string", description: "SMTP username" },
+                smtpPassword: { type: "string", description: "SMTP password" },
+                smtpFrom: { type: "string", description: "SMTP from address" },
+                smtpSecure: { type: "boolean", description: "Use secure SMTP (TLS)" },
+            },
+        },
+    }),
+};
+/**
+ * Users tool - manages user accounts (admin only)
+ */
+export const usersTool = {
+    name: "users",
+    description: "Manage Planka user accounts. Requires admin privileges for most operations.",
+    operations: {
+        list: {
+            method: "GET",
+            path: "/users",
+            description: "List all users",
+        },
+        create: {
+            method: "POST",
+            path: "/users",
+            description: "Create a new user account",
+        },
+        update: {
+            method: "PATCH",
+            path: "/users/{id}",
+            description: "Update user profile",
+        },
+        delete: {
+            method: "DELETE",
+            path: "/users/{id}",
+            description: "Delete a user account",
+        },
+        updateEmail: {
+            method: "PATCH",
+            path: "/users/{id}/email",
+            description: "Update user's email address",
+        },
+        updatePassword: {
+            method: "PATCH",
+            path: "/users/{id}/password",
+            description: "Update user's password",
+        },
+        updateUsername: {
+            method: "PATCH",
+            path: "/users/{id}/username",
+            description: "Update user's username",
+        },
+        updateAvatar: {
+            method: "POST",
+            path: "/users/{id}/avatar",
+            description: "Update user's avatar image",
+        },
+        createApiKey: {
+            method: "POST",
+            path: "/users/{id}/api-key",
+            description: "Generate an API key for a user",
+        },
+    },
+    inputSchema: buildGroupedSchema(["list", "create", "update", "delete", "updateEmail", "updatePassword", "updateUsername", "updateAvatar", "createApiKey"], {
+        list: "List all users",
+        create: "Create a new user",
+        update: "Update user profile",
+        delete: "Delete a user",
+        updateEmail: "Update user's email",
+        updatePassword: "Update user's password",
+        updateUsername: "Update user's username",
+        updateAvatar: "Update user's avatar",
+        createApiKey: "Generate API key for user",
+    }, {
+        id: {
+            description: "User ID",
+            requiredFor: ["update", "delete", "updateEmail", "updatePassword", "updateUsername", "updateAvatar", "createApiKey"],
+        },
+        data: {
+            description: "User data: { email, password, name (all required for create), role: 'admin'|'projectOwner'|'boardUser', username?: string, isDeactivated?: boolean }",
+            requiredFor: ["create", "update", "updateEmail", "updatePassword", "updateUsername"],
+            properties: {
+                email: { type: "string", description: "User email (required for create)", required: true },
+                password: { type: "string", description: "User password (create/updatePassword)", required: true },
+                name: { type: "string", description: "Display name (required for create)", required: true },
+                username: { type: "string", description: "Username" },
+                role: { type: "string", enum: ["admin", "projectOwner", "boardUser"], description: "User role", required: true },
+                isDeactivated: { type: "boolean", description: "Whether the user is deactivated" },
+            },
+        },
+    }),
+};
+/**
+ * Webhooks tool - manages webhooks (admin only)
+ */
+export const webhooksTool = {
+    name: "webhooks",
+    description: "Manage Planka webhooks for event notifications. Requires admin privileges.",
+    operations: {
+        list: {
+            method: "GET",
+            path: "/webhooks",
+            description: "List all configured webhooks",
+        },
+        create: {
+            method: "POST",
+            path: "/webhooks",
+            description: "Create a new webhook",
+        },
+        update: {
+            method: "PATCH",
+            path: "/webhooks/{id}",
+            description: "Update webhook configuration",
+        },
+        delete: {
+            method: "DELETE",
+            path: "/webhooks/{id}",
+            description: "Delete a webhook",
+        },
+    },
+    inputSchema: buildGroupedSchema(["list", "create", "update", "delete"], {
+        list: "List all webhooks",
+        create: "Create a new webhook",
+        update: "Update webhook configuration",
+        delete: "Delete a webhook",
+    }, {
+        id: {
+            description: "Webhook ID",
+            requiredFor: ["update", "delete"],
+        },
+        data: {
+            description: "Webhook data: { name: string (required), url: string (required), accessToken?: string, events?: string[], excludedEvents?: string[] }",
+            requiredFor: ["create", "update"],
+            properties: {
+                name: { type: "string", description: "Webhook name", required: true },
+                url: { type: "string", description: "Webhook URL", required: true },
+                accessToken: { type: "string", description: "Access token for authenticated webhooks" },
+                events: { type: "array", description: "Event types to subscribe to" },
+                excludedEvents: { type: "array", description: "Event types to exclude" },
+            },
+        },
+    }),
+};
+/**
+ * Project Managers tool - manages project manager assignments
+ */
+export const projectManagersTool = {
+    name: "projectManagers",
+    description: "Manage project manager assignments. Requires admin privileges for shared projects.",
+    operations: {
+        add: {
+            method: "POST",
+            path: "/projects/{projectId}/project-managers",
+            description: "Add a user as project manager",
+        },
+        remove: {
+            method: "DELETE",
+            path: "/project-managers/{id}",
+            description: "Remove a project manager",
+        },
+    },
+    inputSchema: buildGroupedSchema(["add", "remove"], {
+        add: "Add a project manager",
+        remove: "Remove a project manager",
+    }, {
+        id: {
+            description: "Project ID (for add) or Project Manager ID (for remove)",
+            requiredFor: ["add", "remove"],
+        },
+        data: {
+            description: "Manager data: { userId: string }. Note: project managers can only be added to 'shared' projects; private projects have only their owner.",
+            requiredFor: ["add"],
+            properties: {
+                userId: { type: "string", description: "User ID to add as project manager", required: true },
+            },
+        },
+    }),
+};

package/dist/tools/core/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Core tools - Essential for basic Kanban operations (always enabled)
+ */
+import { GroupedToolDefinition } from "../types.js";
+import { authTool, projectsTool, boardsTool, listsTool, cardsTool, commentsTool, tasksTool, labelsTool, cardMembersTool, bootstrapTool, contextTool } from "./tools.js";
+export { authTool, projectsTool, boardsTool, listsTool, cardsTool, commentsTool, tasksTool, labelsTool, cardMembersTool, bootstrapTool, contextTool, };
+/**
+ * All core tools combined
+ */
+export declare const coreTools: GroupedToolDefinition[];

package/dist/tools/core/index.js

@@ -0,0 +1,18 @@
+import { authTool, projectsTool, boardsTool, listsTool, cardsTool, commentsTool, tasksTool, labelsTool, cardMembersTool, bootstrapTool, contextTool, } from "./tools.js";
+export { authTool, projectsTool, boardsTool, listsTool, cardsTool, commentsTool, tasksTool, labelsTool, cardMembersTool, bootstrapTool, contextTool, };
+/**
+ * All core tools combined
+ */
+export const coreTools = [
+    authTool,
+    bootstrapTool,
+    contextTool,
+    projectsTool,
+    boardsTool,
+    listsTool,
+    cardsTool,
+    commentsTool,
+    tasksTool,
+    labelsTool,
+    cardMembersTool,
+];

package/dist/tools/core/tools.d.ts

@@ -0,0 +1,46 @@
+import { GroupedToolDefinition } from "../types.js";
+/**
+ * Auth tool - authentication operations
+ */
+export declare const authTool: GroupedToolDefinition;
+/**
+ * Projects tool - manages Planka projects
+ */
+export declare const projectsTool: GroupedToolDefinition;
+/**
+ * Boards tool - manages boards within projects
+ */
+export declare const boardsTool: GroupedToolDefinition;
+/**
+ * Lists tool - manages lists within boards
+ */
+export declare const listsTool: GroupedToolDefinition;
+/**
+ * Cards tool - manages cards within lists
+ */
+export declare const cardsTool: GroupedToolDefinition;
+/**
+ * Comments tool - manages comments on cards
+ */
+export declare const commentsTool: GroupedToolDefinition;
+/**
+ * Tasks tool - manages task lists and tasks on cards
+ */
+export declare const tasksTool: GroupedToolDefinition;
+/**
+ * Labels tool - manages labels on boards and cards
+ */
+export declare const labelsTool: GroupedToolDefinition;
+/**
+ * Card Members tool - manages card memberships
+ */
+export declare const cardMembersTool: GroupedToolDefinition;
+/**
+ * Bootstrap tool - retrieves application initialization data
+ */
+export declare const bootstrapTool: GroupedToolDefinition;
+/**
+ * Context tool - selects the working scope (project/board/list/card) so
+ * scoped tools default to it instead of repeating ids on every call.
+ */
+export declare const contextTool: GroupedToolDefinition;