@mondaydotcomorg/atp-mcp-adapter 0.19.4 → 0.19.6

package/dist/atp-to-mcp.d.ts

@@ -0,0 +1,52 @@
+import type { AgentToolProtocolClient, Tool } from '@mondaydotcomorg/atp-client';
+/**
+ * MCP tool handler result
+ */
+export interface MCPToolResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}
+/**
+ * MCP Server interface - supports both legacy (v0.x) and modern (v1.x) SDK.
+ *
+ * Uses minimal duck-typing to avoid TypeScript variance issues with the
+ * MCP SDK's complex generic callback signatures.
+ */
+export interface MCPServerLike {
+    registerTool?: Function;
+    tool?: Function;
+}
+/**
+ * Registers ATP tools with an MCP server.
+ *
+ * @example
+ * ```typescript
+ * import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+ * import { AgentToolProtocolClient } from '@mondaydotcomorg/atp-client';
+ * import { registerATPTools } from '@mondaydotcomorg/atp-mcp-adapter';
+ *
+ * const client = new AgentToolProtocolClient({ baseUrl: 'http://localhost:3000' });
+ * await client.init();
+ * await client.connect();
+ *
+ * const mcpServer = new Server({ name: 'my-server', version: '1.0.0' }, { capabilities: { tools: {} } });
+ * registerATPTools(client, mcpServer);
+ * ```
+ */
+export declare function registerATPTools(client: AgentToolProtocolClient, mcpServer: MCPServerLike): void;
+/**
+ * Registers an array of ATP tools with an MCP server.
+ * Use this if you want more control over which tools to register.
+ * Supports both MCP SDK v0.x and v1.x APIs.
+ *
+ * @example
+ * ```typescript
+ * const tools = client.getATPTools().filter(t => t.name !== 'search_api');
+ * registerToolsWithMCP(tools, mcpServer);
+ * ```
+ */
+export declare function registerToolsWithMCP(tools: Tool[], mcpServer: MCPServerLike): void;
+//# sourceMappingURL=atp-to-mcp.d.ts.map

package/dist/atp-to-mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atp-to-mcp.d.ts","sourceRoot":"","sources":["../src/atp-to-mcp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AAEjF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC7B,YAAY,CAAC,EAAE,QAAQ,CAAC;IACxB,IAAI,CAAC,EAAE,QAAQ,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,uBAAuB,EAAE,SAAS,EAAE,aAAa,GAAG,IAAI,CAGhG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,aAAa,GAAG,IAAI,CA4ClF"}

package/dist/atp-to-mcp.js

@@ -0,0 +1,71 @@
+/**
+ * Registers ATP tools with an MCP server.
+ *
+ * @example
+ * ```typescript
+ * import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+ * import { AgentToolProtocolClient } from '@mondaydotcomorg/atp-client';
+ * import { registerATPTools } from '@mondaydotcomorg/atp-mcp-adapter';
+ *
+ * const client = new AgentToolProtocolClient({ baseUrl: 'http://localhost:3000' });
+ * await client.init();
+ * await client.connect();
+ *
+ * const mcpServer = new Server({ name: 'my-server', version: '1.0.0' }, { capabilities: { tools: {} } });
+ * registerATPTools(client, mcpServer);
+ * ```
+ */
+export function registerATPTools(client, mcpServer) {
+    const tools = client.getATPTools();
+    registerToolsWithMCP(tools, mcpServer);
+}
+/**
+ * Registers an array of ATP tools with an MCP server.
+ * Use this if you want more control over which tools to register.
+ * Supports both MCP SDK v0.x and v1.x APIs.
+ *
+ * @example
+ * ```typescript
+ * const tools = client.getATPTools().filter(t => t.name !== 'search_api');
+ * registerToolsWithMCP(tools, mcpServer);
+ * ```
+ */
+export function registerToolsWithMCP(tools, mcpServer) {
+    for (const tool of tools) {
+        const handler = async (args) => {
+            try {
+                const result = await tool.func(args);
+                const resultText = typeof result === 'string' ? result : JSON.stringify(result, null, 2);
+                return {
+                    content: [{ type: 'text', text: resultText }],
+                };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                return {
+                    content: [{ type: 'text', text: `Error: ${errorMessage}` }],
+                    isError: true,
+                };
+            }
+        };
+        if (typeof mcpServer.registerTool === 'function') {
+            const inputSchema = tool.zodSchema?.shape ?? {};
+            mcpServer.registerTool(tool.name, {
+                description: tool.description || '',
+                inputSchema,
+            }, handler);
+        }
+        else if (typeof mcpServer.tool === 'function') {
+            const jsonSchema = {
+                type: tool.inputSchema.type,
+                properties: tool.inputSchema.properties || {},
+                required: tool.inputSchema.required || [],
+            };
+            mcpServer.tool(tool.name, tool.description || '', jsonSchema, handler);
+        }
+        else {
+            throw new Error('MCP server does not have a compatible tool registration method. Expected registerTool() or tool() method.');
+        }
+    }
+}
+//# sourceMappingURL=atp-to-mcp.js.map

package/dist/atp-to-mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atp-to-mcp.js","sourceRoot":"","sources":["../src/atp-to-mcp.ts"],"names":[],"mappings":"AAqBA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAA+B,EAAE,SAAwB;IACzF,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACnC,oBAAoB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAa,EAAE,SAAwB;IAC3E,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,KAAK,EAAE,IAA6B,EAA0B,EAAE;YAC/E,IAAI,CAAC;gBACJ,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACrC,MAAM,UAAU,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;gBACzF,OAAO;oBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;iBACtD,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC5E,OAAO;oBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,YAAY,EAAE,EAAE,CAAC;oBACpE,OAAO,EAAE,IAAI;iBACb,CAAC;YACH,CAAC;QACF,CAAC,CAAC;QAEF,IAAI,OAAO,SAAS,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;YAClD,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC;YAChD,SAAS,CAAC,YAAY,CACrB,IAAI,CAAC,IAAI,EACT;gBACC,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;gBACnC,WAAW;aACX,EACD,OAAO,CACP,CAAC;QACH,CAAC;aAAM,IAAI,OAAO,SAAS,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACjD,MAAM,UAAU,GAAG;gBAClB,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;gBAC3B,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,UAAU,IAAI,EAAE;gBAC7C,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,QAAQ,IAAI,EAAE;aACzC,CAAC;YACF,SAAS,CAAC,IAAI,CACb,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,WAAW,IAAI,EAAE,EACtB,UAAU,EACV,OAAO,CACP,CAAC;QACH,CAAC;aAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,2GAA2G,CAAC,CAAC;QAC9H,CAAC;IACF,CAAC;AACF,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 export { MCPConnector } from './mcp-connector.js';
 export { MCPHttpConnector } from './http-connector.js';
+export { registerATPTools, registerToolsWithMCP } from './atp-to-mcp.js';
 export type { MCPTool, MCPPrompt } from './types.js';
+export type { MCPToolResult, MCPServerLike } from './atp-to-mcp.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACzE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACrD,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -1,3 +1,4 @@
 export { MCPConnector } from './mcp-connector.js';
 export { MCPHttpConnector } from './http-connector.js';
+export { registerATPTools, registerToolsWithMCP } from './atp-to-mcp.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@mondaydotcomorg/atp-mcp-adapter",
-	"version": "0.19.4",
+	"version": "0.19.6",
 	"description": "MCP compatibility adapter for Agent Tool Protocol",
 	"type": "module",
 	"main": "./dist/index.js",
@@ -41,13 +41,22 @@
 	],
 	"license": "MIT",
 	"dependencies": {
-		"@modelcontextprotocol/sdk": "^0.5.0",
-		"@mondaydotcomorg/atp-protocol": "0.19.4",
-		"@mondaydotcomorg/atp-server": "0.19.4",
+		"@mondaydotcomorg/atp-protocol": "0.19.6",
+		"@mondaydotcomorg/atp-server": "0.19.6"
+	},
+	"peerDependencies": {
+		"@modelcontextprotocol/sdk": ">=0.5.0",
 		"zod": "^3.25.0"
 	},
+	"peerDependenciesMeta": {
+		"@modelcontextprotocol/sdk": {
+			"optional": true
+		}
+	},
 	"devDependencies": {
+		"@modelcontextprotocol/sdk": "^1.23.0",
 		"typescript": "^5.3.3",
-		"vitest": "^1.2.1"
+		"vitest": "^1.2.1",
+		"zod": "^3.25.0"
 	}
 }

package/src/atp-to-mcp.ts

@@ -0,0 +1,100 @@
+import type { AgentToolProtocolClient, Tool } from '@mondaydotcomorg/atp-client';
+
+/**
+ * MCP tool handler result
+ */
+export interface MCPToolResult {
+	content: Array<{ type: 'text'; text: string }>;
+	isError?: boolean;
+}
+
+/**
+ * MCP Server interface - supports both legacy (v0.x) and modern (v1.x) SDK.
+ * 
+ * Uses minimal duck-typing to avoid TypeScript variance issues with the 
+ * MCP SDK's complex generic callback signatures.
+ */
+export interface MCPServerLike {
+	registerTool?: Function;
+	tool?: Function;
+}
+
+/**
+ * Registers ATP tools with an MCP server.
+ *
+ * @example
+ * ```typescript
+ * import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+ * import { AgentToolProtocolClient } from '@mondaydotcomorg/atp-client';
+ * import { registerATPTools } from '@mondaydotcomorg/atp-mcp-adapter';
+ *
+ * const client = new AgentToolProtocolClient({ baseUrl: 'http://localhost:3000' });
+ * await client.init();
+ * await client.connect();
+ *
+ * const mcpServer = new Server({ name: 'my-server', version: '1.0.0' }, { capabilities: { tools: {} } });
+ * registerATPTools(client, mcpServer);
+ * ```
+ */
+export function registerATPTools(client: AgentToolProtocolClient, mcpServer: MCPServerLike): void {
+	const tools = client.getATPTools();
+	registerToolsWithMCP(tools, mcpServer);
+}
+
+/**
+ * Registers an array of ATP tools with an MCP server.
+ * Use this if you want more control over which tools to register.
+ * Supports both MCP SDK v0.x and v1.x APIs.
+ *
+ * @example
+ * ```typescript
+ * const tools = client.getATPTools().filter(t => t.name !== 'search_api');
+ * registerToolsWithMCP(tools, mcpServer);
+ * ```
+ */
+export function registerToolsWithMCP(tools: Tool[], mcpServer: MCPServerLike): void {
+	for (const tool of tools) {
+		const handler = async (args: Record<string, unknown>): Promise<MCPToolResult> => {
+			try {
+				const result = await tool.func(args);
+				const resultText = typeof result === 'string' ? result : JSON.stringify(result, null, 2);
+				return {
+					content: [{ type: 'text' as const, text: resultText }],
+				};
+			} catch (error) {
+				const errorMessage = error instanceof Error ? error.message : String(error);
+				return {
+					content: [{ type: 'text' as const, text: `Error: ${errorMessage}` }],
+					isError: true,
+				};
+			}
+		};
+
+		if (typeof mcpServer.registerTool === 'function') {
+			const inputSchema = tool.zodSchema?.shape ?? {};
+			mcpServer.registerTool(
+				tool.name,
+				{
+					description: tool.description || '',
+					inputSchema,
+				},
+				handler
+			);
+		} else if (typeof mcpServer.tool === 'function') {
+			const jsonSchema = {
+				type: tool.inputSchema.type,
+				properties: tool.inputSchema.properties || {},
+				required: tool.inputSchema.required || [],
+			};
+			mcpServer.tool(
+				tool.name,
+				tool.description || '',
+				jsonSchema,
+				handler
+			);
+		} else {
+			throw new Error('MCP server does not have a compatible tool registration method. Expected registerTool() or tool() method.');
+		}
+	}
+}
+

package/src/index.ts

@@ -1,3 +1,5 @@
 export { MCPConnector } from './mcp-connector.js';
 export { MCPHttpConnector } from './http-connector.js';
+export { registerATPTools, registerToolsWithMCP } from './atp-to-mcp.js';
 export type { MCPTool, MCPPrompt } from './types.js';
+export type { MCPToolResult, MCPServerLike } from './atp-to-mcp.js';