@mentagen/mcp 0.3.0 → 0.4.1

package/dist/client/helene.js

@@ -142,6 +142,12 @@ export class MentagenClient {
     async updateBoard(params) {
         return this.call('boards.update', params);
     }
+    /**
+     * Soft-delete a board.
+     */
+    async deleteBoard(params) {
+        await this.call('boards.deleteBoard', params);
+    }
     /**
      * Add an edge between two nodes.
      */

package/dist/tools/create.js

@@ -48,10 +48,11 @@ export const createSchema = z.object({
         .string()
         .optional()
         .describe('File extension to append to name (e.g., ".ts", ".py"). Only applies to code nodes. Defaults to .js.'),
-    content: z
+    content: z.string().optional().describe('Content for text/markdown nodes.'),
+    code: z
         .string()
         .optional()
-        .describe('Content for text/markdown nodes. Use "url" field for url-type nodes.'),
+        .describe('Code content for code-type nodes. Takes precedence over content.'),
     url: z
         .string()
         .optional()
@@ -105,7 +106,7 @@ function buildNodeFields(params, color, position) {
         ...position,
     };
     if (params.type === 'code') {
-        nodeFields.code = params.content || '';
+        nodeFields.code = params.code ?? params.content ?? '';
     }
     else if (params.type === 'url') {
         if (!params.url) {

package/dist/tools/delete.js

@@ -4,6 +4,9 @@ export const deleteSchema = z.object({
     boardId: z.string().describe('The board ID containing the node'),
     nodeId: z.string().describe('The node ID to delete'),
 });
+export const deleteBoardSchema = z.object({
+    boardId: z.string().describe('The board ID to delete'),
+});
 export async function handleDelete(client, params) {
     try {
         await client.deleteNode({
@@ -34,3 +37,32 @@ export async function handleDelete(client, params) {
         };
     }
 }
+export async function handleDeleteBoard(client, params) {
+    try {
+        await client.deleteBoard({
+            boardId: params.boardId,
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        message: 'Board deleted successfully. This is a soft delete and can be undone in Mentagen.',
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Failed to delete board: ${formatError(error)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}

package/dist/tools/index.js

@@ -10,7 +10,7 @@ import { createSchema, handleCreate } from './create.js';
 import { createBoardSchema, handleCreateBoard } from './create-board.js';
 import { createEdgeSchema, handleCreateEdge } from './create-edge.js';
 import { createGraphSchema, handleCreateGraph } from './create-graph.js';
-import { deleteSchema, handleDelete } from './delete.js';
+import { deleteBoardSchema, deleteSchema, handleDelete, handleDeleteBoard, } from './delete.js';
 import { deleteEdgeSchema, handleDeleteEdge } from './delete-edge.js';
 import { extractBoardContentSchema, handleExtractBoardContent, } from './extract-board-content.js';
 import { findOverlapsSchema, handleFindOverlaps } from './find-overlaps.js';
@@ -89,6 +89,20 @@ export function registerTools(server, client, config) {
                     required: ['boardId', 'name'],
                 },
             },
+            {
+                name: 'mentagen_delete_board',
+                description: 'Delete a board from Mentagen. CAUTION: Be extra careful when using this tool - verify the board ID and confirm with the user before deleting. This is a soft delete and can be undone in the app, but all nodes and edges in the board will be affected.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        boardId: {
+                            type: 'string',
+                            description: 'The board ID to delete',
+                        },
+                    },
+                    required: ['boardId'],
+                },
+            },
             // Node tools
             {
                 name: 'mentagen_list_nodes',
@@ -272,7 +286,7 @@ export function registerTools(server, client, config) {
             },
             {
                 name: 'mentagen_update_node',
-                description: 'Update an existing node in Mentagen. When name changes, size auto-adjusts unless explicit width/height provided. Returns the final position and size.',
+                description: 'Update an existing node in Mentagen. When name changes, size auto-adjusts unless explicit width/height provided. Can also move nodes between boards using targetBoardId. Returns the final position and size.',
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -284,6 +298,10 @@ export function registerTools(server, client, config) {
                             type: 'string',
                             description: 'The node ID to update',
                         },
+                        targetBoardId: {
+                            type: 'string',
+                            description: 'Move node to a different board. Preserves type and all properties.',
+                        },
                         name: {
                             type: 'string',
                             description: 'New name for the node',
@@ -871,6 +889,10 @@ export function registerTools(server, client, config) {
             const params = updateBoardSchema.parse(args);
             return handleUpdateBoard(client, params, config.mentagenUrl);
         },
+        mentagen_delete_board: async (args) => {
+            const params = deleteBoardSchema.parse(args);
+            return handleDeleteBoard(client, params);
+        },
         // Node handlers
         mentagen_list_nodes: async (args) => {
             const params = listNodesSchema.parse(args);

package/dist/tools/update.js

@@ -6,11 +6,16 @@ import { calculateNodeSize } from './size-calc.js';
 export const updateSchema = z.object({
     boardId: z.string().describe('The board ID containing the node'),
     nodeId: z.string().describe('The node ID to update'),
+    targetBoardId: z
+        .string()
+        .optional()
+        .describe('Move node to a different board. Provide the target board ID to move the node while preserving its type and properties.'),
     name: z.string().optional().describe('New name for the node'),
-    content: z
+    content: z.string().optional().describe('Content for text/markdown nodes.'),
+    code: z
         .string()
         .optional()
-        .describe('Content for text/markdown nodes. Use "url" field for url-type nodes.'),
+        .describe('Code content for code-type nodes. Takes precedence over content.'),
     url: z
         .string()
         .optional()
@@ -46,8 +51,11 @@ const POSITION_FIELDS = ['x', 'y', 'width', 'height'];
  * Add content fields to update data based on node type.
  */
 function addContentFields(data, params, nodeType) {
-    if (nodeType === NodeType.Code && params.content !== undefined) {
-        data.code = params.content;
+    if (nodeType === NodeType.Code) {
+        const codeContent = params.code ?? params.content;
+        if (codeContent !== undefined) {
+            data.code = codeContent;
+        }
     }
     else if (nodeType === NodeType.URL) {
         if (params.url !== undefined) {
@@ -71,6 +79,8 @@ function buildUpdateData(params, nodeType) {
         data.name = params.name;
     if (params.color !== undefined)
         data.color = params.color;
+    if (params.targetBoardId !== undefined)
+        data.board = params.targetBoardId;
     addContentFields(data, params, nodeType);
     for (const field of POSITION_FIELDS) {
         const value = params[field];
@@ -130,7 +140,7 @@ export async function handleUpdate(client, params) {
                 content: [
                     {
                         type: 'text',
-                        text: `At least one field to update must be provided (name, content, url, color, x, y, width, height).`,
+                        text: `At least one field to update must be provided (name, content, url, color, x, y, width, height, targetBoardId).`,
                     },
                 ],
                 isError: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentagen/mcp",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "MCP server for Mentagen knowledge base integration with Cursor",
   "type": "module",
   "bin": "dist/index.js",