attio-mcp 0.1.1 → 1.0.0

package/dist/handlers/tools/formatters.d.ts

@@ -2,6 +2,20 @@
  * Result formatting module - handles transformation and formatting of tool results
  */
 import { AttioRecord, AttioListEntry } from '../../types/attio.js';
+interface BatchOperationResult {
+    summary: {
+        total: number;
+        succeeded: number;
+        failed: number;
+    };
+    results: Array<{
+        id: string;
+        success: boolean;
+        error?: {
+            message?: string;
+        };
+    }>;
+}
 /**
  * Format search results for display
  *
@@ -31,7 +45,7 @@ export declare function formatListEntries(entries: AttioListEntry[]): string;
  * @param operation - The type of batch operation
  * @returns Formatted string output
  */
-export declare function formatBatchResults(result: any, operation: string): string;
+export declare function formatBatchResults(result: BatchOperationResult, operation: string): string;
 /**
  * Format standard response content
  *
@@ -39,5 +53,6 @@ export declare function formatBatchResults(result: any, operation: string): stri
  * @param isError - Whether this is an error response
  * @returns Formatted response object
  */
-export declare function formatResponse(content: string | any, isError?: boolean): any;
+export declare function formatResponse(content: string | unknown, isError?: boolean): unknown;
+export {};
 //# sourceMappingURL=formatters.d.ts.map

package/dist/handlers/tools/formatters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../../src/handlers/tools/formatters.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAc,MAAM,sBAAsB,CAAC;AAwD/E;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,EAAE,EACtB,YAAY,EAAE,MAAM,GACnB,MAAM,CAYR;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAc/D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,CAiBnE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAezE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,GAAG,GAAG,EACrB,OAAO,GAAE,OAAe,OAoDzB"}
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../../src/handlers/tools/formatters.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AASnE,UAAU,oBAAoB;IAC5B,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,OAAO,EAAE,KAAK,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE;YAAE,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC9B,CAAC,CAAC;CACJ;AAyDD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,EAAE,EACtB,YAAY,EAAE,MAAM,GACnB,MAAM,CAYR;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAe/D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,CAiBnE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,oBAAoB,EAC5B,SAAS,EAAE,MAAM,GAChB,MAAM,CAeR;AAED;;;;;;GAMG;AAEH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,GAAG,OAAO,EACzB,OAAO,GAAE,OAAe,WAoDzB"}

package/dist/handlers/tools/formatters.js

@@ -1,5 +1,6 @@
 import { processListEntries } from '../../utils/record-utils.js';
 import { safeJsonStringify, sanitizeMcpResponse, } from '../../utils/json-serializer.js';
+import { createScopedLogger } from '../../utils/logger.js';
 /**
  * Safely extract value from record attributes
  *
@@ -67,7 +68,8 @@ export function formatRecordDetails(record) {
     const attributes = record.attributes || {};
     const formattedAttrs = Object.entries(attributes)
         .map(([key, attr]) => {
-        const value = attr.value || 'N/A';
+        const attrObj = attr;
+        const value = attrObj.value || 'N/A';
         return `${key}: ${value}`;
     })
         .join('\n');
@@ -144,7 +146,10 @@ export function formatResponse(content, isError = false) {
         }
         catch (error) {
             if (process.env.DEBUG || process.env.NODE_ENV === 'development') {
-                console.error('[formatResponse] Error converting content to string:', error);
+                const log = createScopedLogger('tools.formatters', 'formatResponse');
+                log.warn('Error converting content to string', {
+                    error: String(error),
+                });
             }
             formattedContent = 'Error: Content could not be serialized';
         }

package/dist/handlers/tools/formatters.js.map

@@ -1 +1 @@
-{"version":3,"file":"formatters.js","sourceRoot":"","sources":["../../../src/handlers/tools/formatters.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"formatters.js","sourceRoot":"","sources":["../../../src/handlers/tools/formatters.ts"],"names":[],"mappings":"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"}

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

@@ -2,12 +2,14 @@
  * Main entry point for tool handlers - maintains backward compatibility
  */
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { ServerContext } from '../../server/createServer.js';
 /**
  * Registers tool-related request handlers with the server
  *
  * @param server - The MCP server instance
+ * @param context - Server context with configuration
  */
-export declare function registerToolHandlers(server: Server): void;
+export declare function registerToolHandlers(server: Server, context?: ServerContext): void;
 export { TOOL_DEFINITIONS, TOOL_CONFIGS } from './registry.js';
 export { findToolConfig } from './registry.js';
 export { executeToolRequest } from './dispatcher.js';

package/dist/handlers/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/handlers/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAWnE;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAkBzD;AAGD,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,GACf,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/handlers/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAQnE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAkH7D;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,aAAa,GACtB,IAAI,CA+DN;AAGD,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,GACf,MAAM,iBAAiB,CAAC"}

package/dist/handlers/tools/index.js

@@ -1,29 +1,144 @@
 import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
-import { ResourceType } from '../../types/attio.js';
+import { warn } from '../../utils/logger.js';
+import { setGlobalContext } from '../../api/lazy-client.js';
 // Import from modular components
+import { filterAllowedTools } from '../../config/tool-mode.js';
 import { TOOL_DEFINITIONS } from './registry.js';
 import { executeToolRequest } from './dispatcher.js';
+// Constants for configuration
+const DEBUG_ENV_VAR = 'MCP_DEBUG_REQUESTS';
+const MAX_ARGUMENT_SIZE = 1024 * 1024; // 1MB limit for arguments
+/**
+ * Normalize tool request to handle missing arguments wrapper
+ * Fixes Issue #344: MCP protocol mismatch where arguments are not wrapped
+ *
+ * This function handles two cases:
+ * 1. Standard format: { name: "tool", arguments: { query: "value" } }
+ * 2. Loose format: { name: "tool", query: "value" }
+ *
+ * @param request - The incoming tool request (may have loose arguments)
+ * @returns Normalized request with proper arguments structure
+ */
+function normalizeToolRequest(request) {
+    // Validate request structure
+    if (!request.params || typeof request.params.name !== 'string') {
+        throw new Error('Invalid tool request: missing params or tool name');
+    }
+    // Type guard to check if arguments are already properly wrapped
+    if ('arguments' in request.params && request.params.arguments !== undefined) {
+        // Validate argument size to prevent DoS
+        const argSize = JSON.stringify(request.params.arguments).length;
+        if (argSize > MAX_ARGUMENT_SIZE) {
+            throw new Error(`Tool arguments too large: ${argSize} bytes (max: ${MAX_ARGUMENT_SIZE})`);
+        }
+        // Return clean request with only name and arguments
+        // This ensures no extra parameters pollute the request
+        return {
+            ...request,
+            params: {
+                name: request.params.name,
+                arguments: request.params.arguments,
+            },
+        };
+    }
+    // Handle loose arguments format
+    const params = request.params;
+    const { name, ...potentialArgs } = params;
+    // If there are additional params beyond 'name', treat them as arguments
+    const hasAdditionalParams = Object.keys(potentialArgs).length > 0;
+    if (hasAdditionalParams) {
+        // Validate argument size
+        const argSize = JSON.stringify(potentialArgs).length;
+        if (argSize > MAX_ARGUMENT_SIZE) {
+            throw new Error(`Tool arguments too large: ${argSize} bytes (max: ${MAX_ARGUMENT_SIZE})`);
+        }
+        // Use structured logging instead of console.error
+        if (process.env[DEBUG_ENV_VAR] === 'true') {
+            warn('tool:normalization', 'Normalizing loose arguments format (Issue #344)', {
+                tool: name,
+                originalParamKeys: Object.keys(request.params),
+                normalizedArgKeys: Object.keys(potentialArgs),
+                argumentCount: Object.keys(potentialArgs).length,
+            }, 'normalization');
+        }
+        // Create normalized request with wrapped arguments
+        return {
+            ...request,
+            params: {
+                name,
+                arguments: potentialArgs,
+            },
+        };
+    }
+    // No additional params, tool might not need arguments
+    return {
+        ...request,
+        params: {
+            name: request.params.name,
+            arguments: undefined,
+        },
+    };
+}
 /**
  * Registers tool-related request handlers with the server
  *
  * @param server - The MCP server instance
+ * @param context - Server context with configuration
  */
-export function registerToolHandlers(server) {
+export function registerToolHandlers(server, context) {
+    // Set the global context for lazy initialization if provided
+    if (context) {
+        setGlobalContext(context);
+    }
     // Handler for listing available tools
     server.setRequestHandler(ListToolsRequestSchema, async () => {
+        // Dynamically collect all available tool definitions
+        const allTools = [];
+        for (const toolDefs of Object.values(TOOL_DEFINITIONS)) {
+            if (toolDefs) {
+                if (Array.isArray(toolDefs)) {
+                    // Legacy format: array of tool definitions
+                    allTools.push(...toolDefs);
+                }
+                else if (typeof toolDefs === 'object') {
+                    // Universal format: object with tool definitions as values
+                    allTools.push(...Object.values(toolDefs));
+                }
+            }
+        }
+        const tools = filterAllowedTools(allTools);
         return {
-            tools: [
-                ...TOOL_DEFINITIONS[ResourceType.COMPANIES],
-                ...TOOL_DEFINITIONS[ResourceType.PEOPLE],
-                ...TOOL_DEFINITIONS[ResourceType.LISTS],
-                ...TOOL_DEFINITIONS[ResourceType.TASKS],
-                ...TOOL_DEFINITIONS[ResourceType.RECORDS],
-            ],
+            tools,
         };
     });
     // Handler for calling tools
     server.setRequestHandler(CallToolRequestSchema, async (request) => {
-        return await executeToolRequest(request);
+        try {
+            // Normalize request to handle missing arguments wrapper (Issue #344)
+            // Cast is safe because we're handling the protocol mismatch
+            const normalizedRequest = normalizeToolRequest(request);
+            return (await executeToolRequest(normalizedRequest));
+        }
+        catch (error) {
+            // Handle normalization errors
+            const errorMessage = error instanceof Error
+                ? error.message
+                : 'Unknown normalization error';
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error normalizing tool request: ${errorMessage}`,
+                    },
+                ],
+                isError: true,
+                error: {
+                    code: 400,
+                    message: errorMessage,
+                    type: 'normalization_error',
+                },
+            };
+        }
     });
 }
 // Re-export commonly used components for backward compatibility

package/dist/handlers/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/handlers/tools/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,iCAAiC;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,sCAAsC;IACtC,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;QAC1D,OAAO;YACL,KAAK,EAAE;gBACL,GAAG,gBAAgB,CAAC,YAAY,CAAC,SAAS,CAAC;gBAC3C,GAAG,gBAAgB,CAAC,YAAY,CAAC,MAAM,CAAC;gBACxC,GAAG,gBAAgB,CAAC,YAAY,CAAC,KAAK,CAAC;gBACvC,GAAG,gBAAgB,CAAC,YAAY,CAAC,KAAK,CAAC;gBACvC,GAAG,gBAAgB,CAAC,YAAY,CAAC,OAAO,CAAC;aAC1C;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,4BAA4B;IAC5B,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,OAAO,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC;AAED,gEAAgE;AAChE,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,GACf,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/handlers/tools/index.ts"],"names":[],"mappings":"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"}