n8n-nodes-browser-smart-automation 0.1.0

package/dist/shared/utils.js

@@ -0,0 +1,231 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var utils_exports = {};
+__export(utils_exports, {
+  connectMcpClient: () => connectMcpClient,
+  getAllTools: () => getAllTools,
+  getAuthHeaders: () => getAuthHeaders,
+  mapToNodeOperationError: () => mapToNodeOperationError,
+  tryRefreshOAuth2Token: () => tryRefreshOAuth2Token
+});
+module.exports = __toCommonJS(utils_exports);
+var import_client = require("@modelcontextprotocol/sdk/client/index.js");
+var import_sse = require("@modelcontextprotocol/sdk/client/sse.js");
+var import_streamableHttp = require("@modelcontextprotocol/sdk/client/streamableHttp.js");
+var import_n8n_workflow = require("n8n-workflow");
+var import_httpProxyAgent = require("@utils/httpProxyAgent");
+async function getAllTools(client, cursor) {
+  const { tools, nextCursor } = await client.listTools({ cursor });
+  if (nextCursor) {
+    return tools.concat(await getAllTools(client, nextCursor));
+  }
+  return tools;
+}
+function safeCreateUrl(url, baseUrl) {
+  try {
+    return (0, import_n8n_workflow.createResultOk)(new URL(url, baseUrl));
+  } catch (error) {
+    return (0, import_n8n_workflow.createResultError)(error);
+  }
+}
+function normalizeAndValidateUrl(input) {
+  const withProtocol = !/^https?:\/\//i.test(input) ? `https://${input}` : input;
+  const parsedUrl = safeCreateUrl(withProtocol);
+  if (!parsedUrl.ok) {
+    return (0, import_n8n_workflow.createResultError)(parsedUrl.error);
+  }
+  return parsedUrl;
+}
+function errorHasCode(error, code) {
+  return !!error && typeof error === "object" && ("code" in error && Number(error.code) === code || "message" in error && typeof error.message === "string" && error.message.includes(code.toString()));
+}
+function isUnauthorizedError(error) {
+  return errorHasCode(error, 401);
+}
+function isForbiddenError(error) {
+  return errorHasCode(error, 403);
+}
+function mapToNodeOperationError(node, error) {
+  switch (error.type) {
+    case "invalid_url":
+      return new import_n8n_workflow.NodeOperationError(node, error.error, {
+        message: "Could not connect to your MCP server. The provided URL is invalid."
+      });
+    case "auth":
+      return new import_n8n_workflow.NodeOperationError(node, error.error, {
+        message: "Could not connect to your MCP server. Authentication failed."
+      });
+    case "connection":
+    default:
+      return new import_n8n_workflow.NodeOperationError(node, error.error, {
+        message: "Could not connect to your MCP server"
+      });
+  }
+}
+async function connectMcpClient({
+  headers,
+  serverTransport,
+  endpointUrl,
+  name,
+  version,
+  onUnauthorized
+}) {
+  const endpoint = normalizeAndValidateUrl(endpointUrl);
+  if (!endpoint.ok) {
+    return (0, import_n8n_workflow.createResultError)({ type: "invalid_url", error: endpoint.error });
+  }
+  const client = new import_client.Client({ name, version: version.toString() }, { capabilities: {} });
+  if (serverTransport === "httpStreamable") {
+    try {
+      const transport = new import_streamableHttp.StreamableHTTPClientTransport(endpoint.result, {
+        requestInit: { headers },
+        fetch: import_httpProxyAgent.proxyFetch
+      });
+      await client.connect(transport);
+      return (0, import_n8n_workflow.createResultOk)(client);
+    } catch (error) {
+      if (onUnauthorized && isUnauthorizedError(error)) {
+        const newHeaders = await onUnauthorized(headers);
+        if (newHeaders) {
+          return await connectMcpClient({
+            headers: newHeaders,
+            serverTransport,
+            endpointUrl,
+            name,
+            version
+          });
+        }
+      }
+      if (isUnauthorizedError(error) || isForbiddenError(error)) {
+        return (0, import_n8n_workflow.createResultError)({ type: "auth", error });
+      } else {
+        return (0, import_n8n_workflow.createResultError)({ type: "connection", error });
+      }
+    }
+  }
+  try {
+    const sseTransport = new import_sse.SSEClientTransport(endpoint.result, {
+      eventSourceInit: {
+        fetch: async (url, init) => await (0, import_httpProxyAgent.proxyFetch)(url, {
+          ...init,
+          headers: {
+            ...headers,
+            Accept: "text/event-stream"
+          }
+        })
+      },
+      fetch: import_httpProxyAgent.proxyFetch,
+      requestInit: { headers }
+    });
+    await client.connect(sseTransport);
+    return (0, import_n8n_workflow.createResultOk)(client);
+  } catch (error) {
+    if (onUnauthorized && isUnauthorizedError(error)) {
+      const newHeaders = await onUnauthorized(headers);
+      if (newHeaders) {
+        return await connectMcpClient({
+          headers: newHeaders,
+          serverTransport,
+          endpointUrl,
+          name,
+          version
+        });
+      }
+    }
+    if (isUnauthorizedError(error) || isForbiddenError(error)) {
+      return (0, import_n8n_workflow.createResultError)({ type: "auth", error });
+    } else {
+      return (0, import_n8n_workflow.createResultError)({ type: "connection", error });
+    }
+  }
+}
+async function getAuthHeaders(ctx, authentication) {
+  switch (authentication) {
+    case "headerAuth": {
+      const header = await ctx.getCredentials("httpHeaderAuth").catch(() => null);
+      if (!header) return {};
+      return { headers: { [header.name]: header.value } };
+    }
+    case "bearerAuth": {
+      const result = await ctx.getCredentials("httpBearerAuth").catch(() => null);
+      if (!result) return {};
+      return { headers: { Authorization: `Bearer ${result.token}` } };
+    }
+    case "mcpOAuth2Api": {
+      const result = await ctx.getCredentials("mcpOAuth2Api").catch(() => null);
+      if (!result) return {};
+      return { headers: { Authorization: `Bearer ${result.oauthTokenData.access_token}` } };
+    }
+    case "multipleHeadersAuth": {
+      const result = await ctx.getCredentials(
+        "httpMultipleHeadersAuth"
+      ).catch(() => null);
+      if (!result) return {};
+      return {
+        headers: result.headers.values.reduce(
+          (acc, cur) => {
+            acc[cur.name] = cur.value;
+            return acc;
+          },
+          {}
+        )
+      };
+    }
+    case "none":
+    default: {
+      return {};
+    }
+  }
+}
+async function tryRefreshOAuth2Token(ctx, authentication, headers) {
+  if (authentication !== "mcpOAuth2Api") {
+    return null;
+  }
+  let access_token = null;
+  try {
+    const result = await ctx.helpers.refreshOAuth2Token.call(
+      ctx,
+      "mcpOAuth2Api"
+    );
+    access_token = result?.access_token;
+  } catch (error) {
+    return null;
+  }
+  if (!access_token) {
+    return null;
+  }
+  if (!headers) {
+    return {
+      Authorization: `Bearer ${access_token}`
+    };
+  }
+  return {
+    ...headers,
+    Authorization: `Bearer ${access_token}`
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  connectMcpClient,
+  getAllTools,
+  getAuthHeaders,
+  mapToNodeOperationError,
+  tryRefreshOAuth2Token
+});
+//# sourceMappingURL=utils.js.map

package/dist/shared/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../nodes/shared/utils.ts"],"sourcesContent":["import { Client } from '@modelcontextprotocol/sdk/client/index.js';\nimport { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js';\nimport { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';\n// import type { ClientOAuth2TokenData } from '@n8n/client-oauth2';\n\nexport interface ClientOAuth2TokenData {\n\taccess_token: string;\n\texpires_in: number;\n\trefresh_token?: string;\n\ttoken_type: string;\n}\nimport type {\n\tIExecuteFunctions,\n\tILoadOptionsFunctions,\n\tINode,\n\tISupplyDataFunctions,\n\tResult,\n} from 'n8n-workflow';\nimport { createResultError, createResultOk, NodeOperationError } from 'n8n-workflow';\n\nimport { proxyFetch } from '@utils/httpProxyAgent';\n\nimport type { McpAuthenticationOption, McpServerTransport, McpTool } from './types';\n\nexport async function getAllTools(client: Client, cursor?: string): Promise<McpTool[]> {\n\tconst { tools, nextCursor } = await client.listTools({ cursor });\n\n\tif (nextCursor) {\n\t\treturn (tools as McpTool[]).concat(await getAllTools(client, nextCursor));\n\t}\n\n\treturn tools as McpTool[];\n}\n\nfunction safeCreateUrl(url: string, baseUrl?: string | URL): Result<URL, Error> {\n\ttry {\n\t\treturn createResultOk(new URL(url, baseUrl));\n\t} catch (error) {\n\t\treturn createResultError(error);\n\t}\n}\n\nfunction normalizeAndValidateUrl(input: string): Result<URL, Error> {\n\tconst withProtocol = !/^https?:\\/\\//i.test(input) ? `https://${input}` : input;\n\tconst parsedUrl = safeCreateUrl(withProtocol);\n\n\tif (!parsedUrl.ok) {\n\t\treturn createResultError(parsedUrl.error);\n\t}\n\n\treturn parsedUrl;\n}\n\nfunction errorHasCode(error: unknown, code: number): boolean {\n\treturn (\n\t\t!!error &&\n\t\ttypeof error === 'object' &&\n\t\t(('code' in error && Number(error.code) === code) ||\n\t\t\t('message' in error &&\n\t\t\t\ttypeof error.message === 'string' &&\n\t\t\t\terror.message.includes(code.toString())))\n\t);\n}\n\nfunction isUnauthorizedError(error: unknown): boolean {\n\treturn errorHasCode(error, 401);\n}\n\nfunction isForbiddenError(error: unknown): boolean {\n\treturn errorHasCode(error, 403);\n}\n\ntype OnUnauthorizedHandler = (\n\theaders?: Record<string, string>,\n) => Promise<Record<string, string> | null>;\n\ntype ConnectMcpClientError =\n\t| { type: 'invalid_url'; error: Error }\n\t| { type: 'connection'; error: Error }\n\t| { type: 'auth'; error: Error };\n\nexport function mapToNodeOperationError(\n\tnode: INode,\n\terror: ConnectMcpClientError,\n): NodeOperationError {\n\tswitch (error.type) {\n\t\tcase 'invalid_url':\n\t\t\treturn new NodeOperationError(node, error.error, {\n\t\t\t\tmessage: 'Could not connect to your MCP server. The provided URL is invalid.',\n\t\t\t});\n\t\tcase 'auth':\n\t\t\treturn new NodeOperationError(node, error.error, {\n\t\t\t\tmessage: 'Could not connect to your MCP server. Authentication failed.',\n\t\t\t});\n\t\tcase 'connection':\n\t\tdefault:\n\t\t\treturn new NodeOperationError(node, error.error, {\n\t\t\t\tmessage: 'Could not connect to your MCP server',\n\t\t\t});\n\t}\n}\n\nexport async function connectMcpClient({\n\theaders,\n\tserverTransport,\n\tendpointUrl,\n\tname,\n\tversion,\n\tonUnauthorized,\n}: {\n\tserverTransport: McpServerTransport;\n\tendpointUrl: string;\n\theaders?: Record<string, string>;\n\tname: string;\n\tversion: number;\n\tonUnauthorized?: OnUnauthorizedHandler;\n}): Promise<Result<Client, ConnectMcpClientError>> {\n\tconst endpoint = normalizeAndValidateUrl(endpointUrl);\n\n\tif (!endpoint.ok) {\n\t\treturn createResultError({ type: 'invalid_url', error: endpoint.error });\n\t}\n\n\tconst client = new Client({ name, version: version.toString() }, { capabilities: {} });\n\n\tif (serverTransport === 'httpStreamable') {\n\t\ttry {\n\t\t\tconst transport = new StreamableHTTPClientTransport(endpoint.result, {\n\t\t\t\trequestInit: { headers },\n\t\t\t\tfetch: proxyFetch,\n\t\t\t});\n\t\t\tawait client.connect(transport);\n\t\t\treturn createResultOk(client);\n\t\t} catch (error) {\n\t\t\tif (onUnauthorized && isUnauthorizedError(error)) {\n\t\t\t\tconst newHeaders = await onUnauthorized(headers);\n\t\t\t\tif (newHeaders) {\n\t\t\t\t\t// Don't pass `onUnauthorized` to avoid possible infinite recursion\n\t\t\t\t\treturn await connectMcpClient({\n\t\t\t\t\t\theaders: newHeaders,\n\t\t\t\t\t\tserverTransport,\n\t\t\t\t\t\tendpointUrl,\n\t\t\t\t\t\tname,\n\t\t\t\t\t\tversion,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (isUnauthorizedError(error) || isForbiddenError(error)) {\n\t\t\t\treturn createResultError({ type: 'auth', error: error as Error });\n\t\t\t} else {\n\t\t\t\treturn createResultError({ type: 'connection', error: error as Error });\n\t\t\t}\n\t\t}\n\t}\n\n\ttry {\n\t\tconst sseTransport = new SSEClientTransport(endpoint.result, {\n\t\t\teventSourceInit: {\n\t\t\t\tfetch: async (url, init) =>\n\t\t\t\t\tawait proxyFetch(url, {\n\t\t\t\t\t\t...init,\n\t\t\t\t\t\theaders: {\n\t\t\t\t\t\t\t...headers,\n\t\t\t\t\t\t\tAccept: 'text/event-stream',\n\t\t\t\t\t\t},\n\t\t\t\t\t}),\n\t\t\t},\n\t\t\tfetch: proxyFetch,\n\t\t\trequestInit: { headers },\n\t\t});\n\t\tawait client.connect(sseTransport);\n\t\treturn createResultOk(client);\n\t} catch (error) {\n\t\tif (onUnauthorized && isUnauthorizedError(error)) {\n\t\t\tconst newHeaders = await onUnauthorized(headers);\n\t\t\tif (newHeaders) {\n\t\t\t\t// Don't pass `onUnauthorized` to avoid possible infinite recursion\n\t\t\t\treturn await connectMcpClient({\n\t\t\t\t\theaders: newHeaders,\n\t\t\t\t\tserverTransport,\n\t\t\t\t\tendpointUrl,\n\t\t\t\t\tname,\n\t\t\t\t\tversion,\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\n\t\tif (isUnauthorizedError(error) || isForbiddenError(error)) {\n\t\t\treturn createResultError({ type: 'auth', error: error as Error });\n\t\t} else {\n\t\t\treturn createResultError({ type: 'connection', error: error as Error });\n\t\t}\n\t}\n}\n\nexport async function getAuthHeaders(\n\tctx: Pick<IExecuteFunctions, 'getCredentials'>,\n\tauthentication: McpAuthenticationOption,\n): Promise<{ headers?: Record<string, string> }> {\n\tswitch (authentication) {\n\t\tcase 'headerAuth': {\n\t\t\tconst header = await ctx\n\t\t\t\t.getCredentials<{ name: string; value: string }>('httpHeaderAuth')\n\t\t\t\t.catch(() => null);\n\n\t\t\tif (!header) return {};\n\n\t\t\treturn { headers: { [header.name]: header.value } };\n\t\t}\n\t\tcase 'bearerAuth': {\n\t\t\tconst result = await ctx\n\t\t\t\t.getCredentials<{ token: string }>('httpBearerAuth')\n\t\t\t\t.catch(() => null);\n\n\t\t\tif (!result) return {};\n\n\t\t\treturn { headers: { Authorization: `Bearer ${result.token}` } };\n\t\t}\n\t\tcase 'mcpOAuth2Api': {\n\t\t\tconst result = await ctx\n\t\t\t\t.getCredentials<{ oauthTokenData: { access_token: string } }>('mcpOAuth2Api')\n\t\t\t\t.catch(() => null);\n\n\t\t\tif (!result) return {};\n\n\t\t\treturn { headers: { Authorization: `Bearer ${result.oauthTokenData.access_token}` } };\n\t\t}\n\t\tcase 'multipleHeadersAuth': {\n\t\t\tconst result = await ctx\n\t\t\t\t.getCredentials<{ headers: { values: Array<{ name: string; value: string }> } }>(\n\t\t\t\t\t'httpMultipleHeadersAuth',\n\t\t\t\t)\n\t\t\t\t.catch(() => null);\n\n\t\t\tif (!result) return {};\n\n\t\t\treturn {\n\t\t\t\theaders: result.headers.values.reduce(\n\t\t\t\t\t(acc, cur) => {\n\t\t\t\t\t\tacc[cur.name] = cur.value;\n\t\t\t\t\t\treturn acc;\n\t\t\t\t\t},\n\t\t\t\t\t{} as Record<string, string>,\n\t\t\t\t),\n\t\t\t};\n\t\t}\n\t\tcase 'none':\n\t\tdefault: {\n\t\t\treturn {};\n\t\t}\n\t}\n}\n\n/**\n * Tries to refresh the OAuth2 token, storing them in the database if successful\n * @param ctx - The execution context\n * @param authentication - The authentication method\n * @param headers - The headers to refresh\n * @returns The refreshed headers or null if the authentication method is not oAuth2Api or has failed\n */\nexport async function tryRefreshOAuth2Token(\n\tctx: IExecuteFunctions | ISupplyDataFunctions | ILoadOptionsFunctions,\n\tauthentication: McpAuthenticationOption,\n\theaders?: Record<string, string>,\n) {\n\tif (authentication !== 'mcpOAuth2Api') {\n\t\treturn null;\n\t}\n\n\tlet access_token: string | null = null;\n\ttry {\n\t\tconst result = (await ctx.helpers.refreshOAuth2Token.call(\n\t\t\tctx,\n\t\t\t'mcpOAuth2Api',\n\t\t)) as ClientOAuth2TokenData;\n\t\taccess_token = result?.access_token;\n\t} catch (error) {\n\t\treturn null;\n\t}\n\n\tif (!access_token) {\n\t\treturn null;\n\t}\n\n\tif (!headers) {\n\t\treturn {\n\t\t\tAuthorization: `Bearer ${access_token}`,\n\t\t};\n\t}\n\n\treturn {\n\t\t...headers,\n\t\tAuthorization: `Bearer ${access_token}`,\n\t};\n}\n"],"mappings":"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","names":[]}

package/jest.config.js

@@ -0,0 +1,24 @@
+/** @type {import('jest').Config} */
+module.exports = {
+	preset: 'ts-jest',
+	testEnvironment: 'node',
+	collectCoverageFrom: ['nodes/**/*.ts', '!nodes/**/__test__/**', '!nodes/**/*.test.ts'],
+	testMatch: ['**/__test__/**/*.test.ts'],
+	transform: {
+		'^.+\\.ts$': ['ts-jest', {
+			tsconfig: {
+				...require('./tsconfig.json').compilerOptions,
+				sourceMap: true,
+				types: ['jest', 'node'],
+			},
+		}],
+	},
+	moduleNameMapper: {
+		'^@utils/(.*)$': '<rootDir>/nodes/shared/$1',
+	},
+	globals: {
+		'ts-jest': {
+			isolatedModules: true,
+		},
+	},
+};

package/nodes/McpClient/McpClient.node.ts

@@ -0,0 +1,327 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type {
+	IBinaryKeyData,
+	IDataObject,
+	IExecuteFunctions,
+	INodeExecutionData,
+	INodeType,
+	INodeTypeDescription,
+	NodeExecutionWithMetadata,
+} from 'n8n-workflow';
+import { jsonParse, NodeConnectionTypes, NodeOperationError } from 'n8n-workflow';
+import { ZodError } from 'zod';
+import { prettifyError } from 'zod/v4/core';
+
+import * as listSearch from './listSearch';
+import * as resourceMapping from './resourceMapping';
+import { credentials, transportSelect } from '../shared/descriptions';
+import type { McpAuthenticationOption, McpServerTransport } from '../shared/types';
+import {
+	getAuthHeaders,
+	tryRefreshOAuth2Token,
+	connectMcpClient,
+	mapToNodeOperationError,
+} from '../shared/utils';
+
+export class McpClient implements INodeType {
+	description: INodeTypeDescription = {
+		displayName: 'MCP Client',
+		description: 'Standalone MCP Client',
+		name: 'mcpClient',
+		icon: {
+			light: 'file:../mcp.svg',
+			dark: 'file:../mcp.dark.svg',
+		},
+		group: ['transform'],
+		version: 1,
+		defaults: {
+			name: 'MCP Client',
+		},
+		credentials,
+		inputs: [NodeConnectionTypes.Main],
+		outputs: [NodeConnectionTypes.Main],
+		properties: [
+			transportSelect({
+				defaultOption: 'httpStreamable',
+			}),
+			{
+				displayName: 'MCP Endpoint URL',
+				name: 'endpointUrl',
+				type: 'string',
+				default: '',
+				placeholder: 'e.g. https://my-mcp-server.ai/mcp',
+				required: true,
+				description: 'The URL of the MCP server to connect to',
+			},
+			{
+				displayName: 'Authentication',
+				name: 'authentication',
+				type: 'options',
+				options: [
+					{
+						name: 'Bearer Auth',
+						value: 'bearerAuth',
+					},
+					{
+						name: 'Header Auth',
+						value: 'headerAuth',
+					},
+					{
+						name: 'MCP OAuth2',
+						value: 'mcpOAuth2Api',
+					},
+					{
+						name: 'Multiple Headers Auth',
+						value: 'multipleHeadersAuth',
+					},
+					{
+						name: 'None',
+						value: 'none',
+					},
+				],
+				default: 'none',
+				description: 'The way to authenticate with your endpoint',
+			},
+			{
+				displayName: 'Credentials',
+				name: 'credentials',
+				type: 'credentials',
+				default: '',
+				displayOptions: {
+					show: {
+						authentication: ['headerAuth', 'bearerAuth', 'mcpOAuth2Api', 'multipleHeadersAuth'],
+					},
+				},
+			},
+			{
+				displayName: 'Tool',
+				name: 'tool',
+				type: 'resourceLocator',
+				default: { mode: 'list', value: '' },
+				required: true,
+				description: 'The tool to use',
+				modes: [
+					{
+						displayName: 'From List',
+						name: 'list',
+						type: 'list',
+						typeOptions: {
+							searchListMethod: 'getTools',
+							searchable: true,
+							skipCredentialsCheckInRLC: true,
+						},
+					},
+					{
+						displayName: 'ID',
+						name: 'id',
+						type: 'string',
+					},
+				],
+			},
+			{
+				displayName: 'Input Mode',
+				name: 'inputMode',
+				type: 'options',
+				default: 'manual',
+				noDataExpression: true,
+				options: [
+					{
+						name: 'Manual',
+						value: 'manual',
+						description: 'Manually specify the input data for each tool parameter',
+					},
+					{
+						name: 'JSON',
+						value: 'json',
+						description: 'Specify the input data as a JSON object',
+					},
+				],
+			},
+			{
+				displayName: 'Parameters',
+				name: 'parameters',
+				type: 'resourceMapper',
+				default: {
+					mappingMode: 'defineBelow',
+					value: null,
+				},
+				noDataExpression: true,
+				required: true,
+				typeOptions: {
+					loadOptionsDependsOn: ['tool.value'],
+					resourceMapper: {
+						resourceMapperMethod: 'getToolParameters',
+						hideNoDataError: true,
+						addAllFields: false,
+						supportAutoMap: false,
+						mode: 'add',
+						fieldWords: {
+							singular: 'parameter',
+							plural: 'parameters',
+						},
+					},
+				},
+				displayOptions: {
+					show: {
+						inputMode: ['manual'],
+					},
+				},
+			},
+			{
+				displayName: 'JSON',
+				name: 'jsonInput',
+				type: 'json',
+				typeOptions: {
+					rows: 5,
+				},
+				default: '{\n  "my_field_1": "value",\n  "my_field_2": 1\n}\n',
+				validateType: 'object',
+				displayOptions: {
+					show: {
+						inputMode: ['json'],
+					},
+				},
+			},
+			{
+				displayName: 'Options',
+				name: 'options',
+				placeholder: 'Add Option',
+				description: 'Additional options to add',
+				type: 'collection',
+				default: {},
+				options: [
+					{
+						displayName: 'Convert to Binary',
+						name: 'convertToBinary',
+						type: 'boolean',
+						default: true,
+						description:
+							'Whether to convert images and audio to binary data. If false, images and audio will be returned as base64 encoded strings.',
+					},
+					{
+						displayName: 'Timeout',
+						name: 'timeout',
+						type: 'number',
+						typeOptions: {
+							minValue: 1,
+						},
+						default: 60000,
+						description: 'Time in ms to wait for tool calls to finish',
+					},
+				],
+			},
+		],
+	};
+
+	methods = {
+		listSearch,
+		resourceMapping,
+	};
+
+	async execute(
+		this: IExecuteFunctions,
+	): Promise<INodeExecutionData[][] | NodeExecutionWithMetadata[][] | null> {
+		const authentication = this.getNodeParameter('authentication', 0) as McpAuthenticationOption;
+		const serverTransport = this.getNodeParameter('serverTransport', 0) as McpServerTransport;
+		const endpointUrl = this.getNodeParameter('endpointUrl', 0) as string;
+		const node = this.getNode();
+		const { headers } = await getAuthHeaders(this, authentication);
+		const client = await connectMcpClient({
+			serverTransport,
+			endpointUrl,
+			headers,
+			name: node.type,
+			version: node.typeVersion,
+			onUnauthorized: async (headers) => await tryRefreshOAuth2Token(this, authentication, headers),
+		});
+		if (!client.ok) {
+			throw mapToNodeOperationError(node, client.error);
+		}
+
+		const inputMode = this.getNodeParameter('inputMode', 0, 'manual') as 'manual' | 'json';
+		const items = this.getInputData();
+		const returnData: INodeExecutionData[] = [];
+		for (let itemIndex = 0; itemIndex < items.length; itemIndex++) {
+			try {
+				const tool = this.getNodeParameter('tool.value', itemIndex) as string;
+				const options = this.getNodeParameter('options', itemIndex);
+				let parameters: IDataObject = {};
+				if (inputMode === 'manual') {
+					parameters = this.getNodeParameter('parameters.value', itemIndex) as IDataObject;
+				} else {
+					parameters = this.getNodeParameter('jsonInput', itemIndex) as IDataObject;
+				}
+
+				const result = (await client.result.callTool(
+					{
+						name: tool,
+						arguments: parameters,
+					},
+					undefined,
+					{
+						timeout: options.timeout ? Number(options.timeout) : undefined,
+					},
+				)) as CallToolResult;
+
+				let binaryIndex = 0;
+				const binary: IBinaryKeyData = {};
+				const content: IDataObject[] = [];
+				const convertToBinary = options.convertToBinary ?? true;
+				for (const contentItem of result.content) {
+					if (contentItem.type === 'text') {
+						content.push({
+							...contentItem,
+							text: jsonParse(contentItem.text, { fallbackValue: contentItem.text }),
+						});
+						continue;
+					}
+
+					if (convertToBinary && (contentItem.type === 'image' || contentItem.type === 'audio')) {
+						binary[`data_${binaryIndex}`] = await this.helpers.prepareBinaryData(
+							Buffer.from(contentItem.data, 'base64'),
+							undefined,
+							contentItem.mimeType,
+						);
+						binaryIndex++;
+						continue;
+					}
+
+					content.push(contentItem as IDataObject);
+				}
+
+				returnData.push({
+					json: {
+						content: content.length > 0 ? content : undefined,
+					},
+					binary: Object.keys(binary).length > 0 ? binary : undefined,
+					pairedItem: {
+						item: itemIndex,
+					},
+				});
+			} catch (e) {
+				const errorMessage =
+					e instanceof ZodError ? prettifyError(e) : e instanceof Error ? e.message : String(e);
+				if (this.continueOnFail()) {
+					returnData.push({
+						json: {
+							error: {
+								message: errorMessage,
+								issues: e instanceof ZodError ? e.issues : undefined,
+							},
+						},
+						pairedItem: {
+							item: itemIndex,
+						},
+					});
+					continue;
+				}
+
+				throw new NodeOperationError(node, errorMessage, {
+					itemIndex,
+				});
+			}
+		}
+
+		return [returnData];
+	}
+}