@mentagen/mcp 0.4.0 → 0.5.0

package/dist/client/helene.js

@@ -64,9 +64,10 @@ export class MentagenClient {
     /**
      * List boards the user has access to.
      */
-    async listBoards() {
-        const result = await this.call('boards.list', {});
-        return result.data || [];
+    async listBoards(params) {
+        return this.call('boards.listSimple', {
+            orgId: params?.orgId,
+        });
     }
     /**
      * Search boards by name.
@@ -84,6 +85,18 @@ export class MentagenClient {
     async searchNodes(params) {
         return this.call('boards.searchNodesText', params);
     }
+    /**
+     * List organizations the user has access to.
+     */
+    async listOrganizations() {
+        return this.call('org.list', {});
+    }
+    /**
+     * List teams within an organization.
+     */
+    async listTeams(params) {
+        return this.call('team.list', params);
+    }
     /**
      * Add a new node to a board.
      */
@@ -142,6 +155,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/boards.js

@@ -3,7 +3,12 @@ import { z } from 'zod';
 import { formatShortDate } from '../utils/ejson.js';
 import { formatError } from '../utils/errors.js';
 import { getBoardUrl } from '../utils/urls.js';
-export const boardsSchema = z.object({});
+export const boardsSchema = z.object({
+    orgId: z
+        .string()
+        .optional()
+        .describe('Optional organization ID to filter boards'),
+});
 /**
  * Format boards as TSV for compact output.
  * Uses papaparse for proper escaping of special characters.
@@ -13,18 +18,29 @@ function formatBoardsTsv(boards) {
         delimiter: '\t',
         header: true,
         newline: '\n',
-        columns: ['id', 'name', 'description', 'nodeCount', 'updatedAt', 'link'],
+        columns: [
+            'id',
+            'name',
+            'description',
+            'nodeCount',
+            'updatedAt',
+            'org',
+            'teams',
+            'link',
+        ],
     });
 }
-export async function handleBoards(client, _params, baseUrl) {
+export async function handleBoards(client, params, baseUrl) {
     try {
-        const boards = await client.listBoards();
+        const boards = await client.listBoards({ orgId: params.orgId });
         const formatted = boards.map(board => ({
             id: board._id,
             name: board.name,
             description: board.description || '',
             nodeCount: board.nodeCount ?? 0,
             updatedAt: formatShortDate(board.updatedAt),
+            org: board.org || '',
+            teams: board.teams?.join(',') || '',
             link: getBoardUrl(baseUrl, board._id),
         }));
         return {

package/dist/tools/create-board.js

@@ -4,6 +4,11 @@ import { formatError } from '../utils/errors.js';
 import { getBoardUrl } from '../utils/urls.js';
 export const createBoardSchema = z.object({
     name: z.string().min(1).describe('The name for the new board'),
+    orgId: z
+        .string()
+        .length(24)
+        .optional()
+        .describe('Optional organization ID to create the board in'),
 });
 function generateObjectId() {
     const timestamp = Math.floor(Date.now() / 1000)
@@ -18,6 +23,7 @@ export async function handleCreateBoard(client, params, baseUrl) {
         const board = await client.createBoard({
             _id: boardId,
             name: params.name,
+            org: params.orgId,
         });
         const result = {
             success: true,

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';
@@ -19,7 +19,9 @@ import { gridCalcSchema, handleGridCalc } from './grid-calc.js';
 import { handleLink, linkSchema } from './link.js';
 import { handleListEdges, listEdgesSchema } from './list-edges.js';
 import { handleListNodes, listNodesSchema } from './list-nodes.js';
+import { handleListOrganizations, listOrganizationsSchema, } from './list-organizations.js';
 import { handleListPositions, listPositionsSchema } from './list-positions.js';
+import { handleListTeams, listTeamsSchema } from './list-teams.js';
 import { handleNodeTypes, nodeTypesSchema } from './node-types.js';
 import { handlePatchContent, patchContentSchema } from './patch-content.js';
 import { handleRead, readSchema } from './read.js';
@@ -40,7 +42,12 @@ export function registerTools(server, client, config) {
                 description: 'List all boards you have access to in Mentagen. Returns board IDs, names, node counts, and direct links.',
                 inputSchema: {
                     type: 'object',
-                    properties: {},
+                    properties: {
+                        orgId: {
+                            type: 'string',
+                            description: 'Optional organization ID to filter boards',
+                        },
+                    },
                 },
             },
             {
@@ -67,13 +74,17 @@ export function registerTools(server, client, config) {
                             type: 'string',
                             description: 'The name for the new board',
                         },
+                        orgId: {
+                            type: 'string',
+                            description: 'Optional organization ID to create the board in. Board will belong to the user without team assignment.',
+                        },
                     },
                     required: ['name'],
                 },
             },
             {
                 name: 'mentagen_update_board',
-                description: 'Update a board name in Mentagen.',
+                description: 'Update a board in Mentagen. Can update name, org, and team assignments.',
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -85,8 +96,54 @@ export function registerTools(server, client, config) {
                             type: 'string',
                             description: 'New name for the board',
                         },
+                        org: {
+                            type: ['string', 'null'],
+                            description: 'Organization ID to assign the board to. Set to null to remove from organization.',
+                        },
+                        teams: {
+                            type: 'array',
+                            items: { type: 'string' },
+                            description: 'Array of team IDs to assign to this board. Use mentagen_list_teams to get team IDs for an org.',
+                        },
                     },
-                    required: ['boardId', 'name'],
+                    required: ['boardId'],
+                },
+            },
+            {
+                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'],
+                },
+            },
+            // Organization tools
+            {
+                name: 'mentagen_list_organizations',
+                description: 'List all organizations you are a member of. Returns organization IDs, names, your role, member counts, and direct links.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {},
+                },
+            },
+            {
+                name: 'mentagen_list_teams',
+                description: 'List all teams within an organization. Returns team IDs, names, member counts, and whether it is a system team.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        orgId: {
+                            type: 'string',
+                            description: 'The organization ID to list teams from',
+                        },
+                    },
+                    required: ['orgId'],
                 },
             },
             // Node tools
@@ -159,6 +216,10 @@ export function registerTools(server, client, config) {
                             type: 'string',
                             description: 'Optional board ID to limit search scope',
                         },
+                        org: {
+                            type: 'string',
+                            description: 'Optional organization ID to limit search to boards in that organization',
+                        },
                         limit: {
                             type: 'number',
                             description: 'Maximum number of results (default: 10)',
@@ -272,7 +333,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 +345,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 +936,19 @@ 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);
+        },
+        // Organization handlers
+        mentagen_list_organizations: async (args) => {
+            listOrganizationsSchema.parse(args);
+            return handleListOrganizations(client, config.mentagenUrl);
+        },
+        mentagen_list_teams: async (args) => {
+            const params = listTeamsSchema.parse(args);
+            return handleListTeams(client, params);
+        },
         // Node handlers
         mentagen_list_nodes: async (args) => {
             const params = listNodesSchema.parse(args);

package/dist/tools/list-organizations.js

@@ -0,0 +1,46 @@
+import Papa from 'papaparse';
+import { z } from 'zod';
+import { formatError } from '../utils/errors.js';
+export const listOrganizationsSchema = z.object({});
+export async function handleListOrganizations(client, baseUrl) {
+    try {
+        const organizations = await client.listOrganizations();
+        if (organizations.length === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'No organizations found. You are not a member of any organization.',
+                    },
+                ],
+            };
+        }
+        const rows = organizations.map(org => ({
+            id: org._id,
+            name: org.name,
+            role: org.role?.type ?? '',
+            memberCount: org.members ?? 0,
+            link: `${baseUrl}/org/${org._id}`,
+        }));
+        const tsv = Papa.unparse(rows, {
+            delimiter: '\t',
+            header: true,
+            newline: '\n',
+            columns: ['id', 'name', 'role', 'memberCount', 'link'],
+        });
+        return {
+            content: [{ type: 'text', text: tsv }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Failed to list organizations: ${formatError(error)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}

package/dist/tools/list-teams.js

@@ -0,0 +1,47 @@
+import Papa from 'papaparse';
+import { z } from 'zod';
+import { formatError } from '../utils/errors.js';
+export const listTeamsSchema = z.object({
+    orgId: z.string().describe('The organization ID to list teams from'),
+});
+export async function handleListTeams(client, params) {
+    try {
+        const teams = await client.listTeams({ orgId: params.orgId });
+        if (teams.length === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'No teams found in this organization.',
+                    },
+                ],
+            };
+        }
+        const rows = teams.map(team => ({
+            id: team._id,
+            name: team.name,
+            memberCount: team.members?.length ?? 0,
+            isSystemTeam: team.systemType === 'general',
+        }));
+        const tsv = Papa.unparse(rows, {
+            delimiter: '\t',
+            header: true,
+            newline: '\n',
+            columns: ['id', 'name', 'memberCount', 'isSystemTeam'],
+        });
+        return {
+            content: [{ type: 'text', text: tsv }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Failed to list teams: ${formatError(error)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}

package/dist/tools/search.js

@@ -11,6 +11,10 @@ export const searchSchema = z.object({
         .string()
         .optional()
         .describe('Optional board ID to limit search scope'),
+    org: z
+        .string()
+        .optional()
+        .describe('Optional organization ID to limit search to boards in that organization'),
     limit: z
         .number()
         .default(10)
@@ -59,6 +63,7 @@ export async function handleSearch(client, params, baseUrl) {
         const results = await client.searchNodes({
             query: params.query,
             board: params.board,
+            org: params.org,
             semanticRatio: params.semanticRatio,
         });
         const formatted = formatSearchResults(results.hits.slice(0, params.limit));

package/dist/tools/update-board.js

@@ -14,11 +14,23 @@ export const updateBoardSchema = z
         .url()
         .optional()
         .describe('Pull request URL for this board'),
+    org: z
+        .string()
+        .length(24)
+        .optional()
+        .nullable()
+        .describe('Organization ID. Set to null to remove from organization.'),
+    teams: z
+        .array(z.string().length(24))
+        .optional()
+        .describe('Array of team IDs to assign to this board'),
 })
     .refine(data => data.name !== undefined ||
     data.description !== undefined ||
-    data.pullRequestUrl !== undefined, {
-    message: 'At least one field (name, description, or pullRequestUrl) must be provided',
+    data.pullRequestUrl !== undefined ||
+    data.org !== undefined ||
+    data.teams !== undefined, {
+    message: 'At least one field (name, description, pullRequestUrl, org, or teams) must be provided',
 });
 export async function handleUpdateBoard(client, params, baseUrl) {
     try {
@@ -29,6 +41,10 @@ export async function handleUpdateBoard(client, params, baseUrl) {
             data.description = params.description;
         if (params.pullRequestUrl !== undefined)
             data.pullRequestUrl = params.pullRequestUrl;
+        if (params.org !== undefined)
+            data.org = params.org;
+        if (params.teams !== undefined)
+            data.teams = params.teams;
         const board = await client.updateBoard({
             boardId: params.boardId,
             data,

package/dist/tools/update.js

@@ -6,6 +6,10 @@ 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.string().optional().describe('Content for text/markdown nodes.'),
     code: z
@@ -75,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];
@@ -134,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.4.0",
+  "version": "0.5.0",
   "description": "MCP server for Mentagen knowledge base integration with Cursor",
   "type": "module",
   "bin": "dist/index.js",