@imboard.ai/mcp-server 0.1.0

package/src/tools/supporting.tools.ts

@@ -0,0 +1,92 @@
+import { z } from 'zod';
+import { boardIdParam, resourceIdParam, formatResult, handleToolError, RegisterToolsFn } from './shared.js';
+
+export const registerSupportingTools: RegisterToolsFn = (server, client) => {
+  server.tool(
+    'get_board_audit_log',
+    'Gets the audit trail for a board. Returns a chronological list of actions taken on the board.',
+    {
+      boardId: boardIdParam,
+    },
+    async ({ boardId }) => {
+      try {
+        const response = await client.get(`/api/auditlog/${boardId}`);
+        return formatResult({ data: response.data });
+      } catch (error) {
+        return handleToolError(error);
+      }
+    },
+  );
+
+  server.tool(
+    'get_portfolio_data',
+    'Gets portfolio data aggregated across all boards. Useful for cross-board analytics.',
+    {
+      getOnlyMyPortfolio: z.enum(['true', 'false']).optional().describe('Only include boards where user is a member (default: false)'),
+      includeArchived: z.enum(['true', 'false']).optional().describe('Include archived boards (default: false)'),
+    },
+    async ({ getOnlyMyPortfolio, includeArchived }) => {
+      try {
+        const params: Record<string, string> = {};
+        if (getOnlyMyPortfolio !== undefined) params.getOnlyMyPortfolio = getOnlyMyPortfolio;
+        if (includeArchived !== undefined) params.includeArchived = includeArchived;
+        const response = await client.get('/api/portfolio/data', params);
+        return formatResult({ data: response.data });
+      } catch (error) {
+        return handleToolError(error);
+      }
+    },
+  );
+
+  server.tool(
+    'get_fx_rates',
+    'Gets current foreign exchange rates. Optionally specify base currency, targets, and date.',
+    {
+      base: z.string().length(3).optional().describe('Base currency (3-letter ISO 4217 code, e.g. USD)'),
+      targets: z.array(z.string().length(3)).optional().describe('Target currencies to convert to'),
+      date: z.string().optional().describe('Historical date in YYYY-MM-DD format'),
+    },
+    async ({ base, targets, date }) => {
+      try {
+        const params: Record<string, string> = {};
+        if (base !== undefined) params.base = base;
+        if (targets !== undefined) params['targets[]'] = targets.join(',');
+        if (date !== undefined) params.date = date;
+        const response = await client.get('/api/fx/rates', params);
+        return formatResult({ data: response.data });
+      } catch (error) {
+        return handleToolError(error);
+      }
+    },
+  );
+
+  server.tool(
+    'list_unassigned_attachments',
+    'Lists email attachments awaiting assignment to documents.',
+    {},
+    async () => {
+      try {
+        const response = await client.get('/api/unassigned-emails/');
+        return formatResult({ data: response.data });
+      } catch (error) {
+        return handleToolError(error);
+      }
+    },
+  );
+
+  server.tool(
+    'reject_attachment',
+    'Rejects an unassigned email attachment.',
+    {
+      attachmentId: resourceIdParam.describe('The attachment ID'),
+    },
+    async ({ attachmentId }) => {
+      try {
+        const response = await client.put(`/api/unassigned-emails/attachment/${attachmentId}`);
+        return formatResult({ data: response.data });
+      } catch (error) {
+        return handleToolError(error);
+      }
+    },
+  );
+};

package/src/tools/user.tools.ts

@@ -0,0 +1,31 @@
+import { formatResult, handleToolError, RegisterToolsFn } from './shared.js';
+
+export const registerUserTools: RegisterToolsFn = (server, client) => {
+  server.tool(
+    'list_my_boards',
+    'Lists all board memberships and pending invites for the authenticated user.',
+    {},
+    async () => {
+      try {
+        const response = await client.get('/api/user/allboards');
+        return formatResult({ data: response.data });
+      } catch (error) {
+        return handleToolError(error);
+      }
+    },
+  );
+
+  server.tool(
+    'get_storage_usage',
+    'Returns storage usage for unassigned email attachments.',
+    {},
+    async () => {
+      try {
+        const response = await client.get('/api/user/storage');
+        return formatResult({ data: response.data });
+      } catch (error) {
+        return handleToolError(error);
+      }
+    },
+  );
+};

package/src/utils/logging.ts

@@ -0,0 +1,59 @@
+import { redact } from './redact.js';
+
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+
+const LOG_LEVELS: Record<LogLevel, number> = {
+  debug: 0,
+  info: 1,
+  warn: 2,
+  error: 3,
+};
+
+let minLevel: LogLevel = 'info';
+
+export function setLogLevel(level: LogLevel): void {
+  minLevel = level;
+}
+
+function shouldLog(level: LogLevel): boolean {
+  return LOG_LEVELS[level] >= LOG_LEVELS[minLevel];
+}
+
+function formatMessage(level: LogLevel, message: string, context?: Record<string, unknown>): string {
+  const timestamp = new Date().toISOString();
+  const redacted = redact(message);
+  const parts = [`[${timestamp}] [${level.toUpperCase()}] ${redacted}`];
+
+  if (context && Object.keys(context).length > 0) {
+    const safeContext = redact(JSON.stringify(context));
+    parts.push(safeContext);
+  }
+
+  return parts.join(' ');
+}
+
+export const logger = {
+  debug(message: string, context?: Record<string, unknown>): void {
+    if (shouldLog('debug')) {
+      process.stderr.write(formatMessage('debug', message, context) + '\n');
+    }
+  },
+
+  info(message: string, context?: Record<string, unknown>): void {
+    if (shouldLog('info')) {
+      process.stderr.write(formatMessage('info', message, context) + '\n');
+    }
+  },
+
+  warn(message: string, context?: Record<string, unknown>): void {
+    if (shouldLog('warn')) {
+      process.stderr.write(formatMessage('warn', message, context) + '\n');
+    }
+  },
+
+  error(message: string, context?: Record<string, unknown>): void {
+    if (shouldLog('error')) {
+      process.stderr.write(formatMessage('error', message, context) + '\n');
+    }
+  },
+};

package/src/utils/redact.ts

@@ -0,0 +1,8 @@
+const TOKEN_PATTERN = /\b([a-zA-Z0-9_-]{8})[a-zA-Z0-9_-]{24,}\b/g;
+const BEARER_PATTERN = /(Bearer\s+)[a-zA-Z0-9_.\-/+=]{8,}/gi;
+
+export function redact(value: string): string {
+  return value
+    .replace(BEARER_PATTERN, '$1[REDACTED]')
+    .replace(TOKEN_PATTERN, '$1***');
+}