mcp-enhanced

Enhanced MCP nodes for n8n with AI Agent support

Package Information

Released: 9/21/2025

Downloads: 23 weekly / 95 monthly

Latest Version: 1.0.11

Author: Euihyeon Pyeon

Available Nodes

MCP Client

No description available

Documentation

n8n-nodes-mcp-enhanced

Enhanced MCP Client for n8n with AI Agent Support

This is an enhanced version of the n8n community node that lets you interact with Model Context Protocol (MCP) servers in your n8n workflows, with special optimizations for AI Agent integration.

Key Enhancement: Tool Name and Tool Parameters are now fully JSON-compatible, allowing AI Agents to automatically select and configure MCP tools without manual intervention.

MCP is a protocol that enables AI models to interact with external tools and data sources in a standardized way. This node allows you to connect to MCP servers, access resources, execute tools, and use prompts.

n8n is a fair-code licensed workflow automation platform.

What's Enhanced

AI Agent Compatibility

Direct Field Control: AI Agents can now directly control both Tool Name and Tool Parameters fields
Automatic Tool Selection: Tool Name field now supports AI Agent "let the model define this parameter" feature
Flexible Parameter Formats: Support multiple input formats for maximum compatibility
Backward Compatibility: All existing workflows continue to work unchanged

Enhanced Parameter Handling

The node now supports multiple parameter formats with intelligent parsing:

// AI Agent Direct Control (v1.0.5+, recommended)
Tool Name: "search_arxiv"                    // AI Agent sets this directly
Tool Parameters: {                           // AI Agent sets this directly
  "query": "artificial intelligence",
  "max_results": 10
}

// Nested format (legacy, still supported)
Tool Name: ""                                // Can be empty
Tool Parameters: [{
  "Tool_Parameters": {
    "tool_name": "search_arxiv", 
    "parameters": {
      "query": "artificial intelligence",
      "max_results": 10
    }
  }
}]

// Direct nested format
Tool Name: ""                                // Can be empty  
Tool Parameters: {
  "Tool_Parameters": {
    "tool_name": "search_arxiv",
    "parameters": {...}
  }
}

Parsing Priority Logic

Tool Name field priority: If Tool Name is set, it takes precedence
Parameter extraction: Tool Parameters are parsed as direct parameters
Nested fallback: If Tool Name is empty, extract from nested Tool_Parameters structure
Legacy support: Maintains compatibility with all previous formats

Installation

Follow the installation guide in the n8n community nodes documentation.

Install via npm

npm install n8n-nodes-mcp-enhanced

Install in n8n

Go to Settings > Community Nodes
Enter package name: n8n-nodes-mcp-enhanced
Click Install

Important: Set the N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE environment variable to true if you want to use the MCP Client node as a tool in AI Agents.

Credentials

The MCP Client node supports three types of credentials to connect to an MCP server:

Command-line Based Transport (STDIO)

Command: The command to start the MCP server
Arguments: Optional arguments to pass to the server command
Environment Variables: Variables to pass to the server in NAME=VALUE format

HTTP Streamable Transport (Recommended)

HTTP Streamable URL: The HTTP endpoint that supports streaming responses
Additional Headers: Optional headers to send with requests

Server-Sent Events (SSE) Transport (Legacy)

SSE URL: The URL of the SSE endpoint
Messages Post Endpoint: Optional custom endpoint for posting messages
Additional Headers: Optional headers to send with requests

Operations

Execute Tool - Execute a specific tool with parameters (Enhanced for AI Agents)
Get Prompt - Get a specific prompt template
List Prompts - Get a list of available prompts
List Resources - Get a list of available resources from the MCP server
List Tools - Get a list of available tools
Read Resource - Read a specific resource by URI

Using with AI Agents

Enable Tool Usage

Set environment variable:

export N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true

AI Agent Integration

Add MCP Client node to your workflow
Configure credentials for your MCP server
In AI Agent node, enable MCP Client as a tool
AI Agent will automatically control both Tool Name and Tool Parameters fields

v1.0.5+ Enhanced AI Agent Experience

With the latest improvements, AI Agents can now:

Directly set Tool Name: "let the model define this parameter" option available
Directly set Tool Parameters: Full control over parameter structure
Intelligent parsing: Automatic handling of different input formats
Better UX: Cleaner separation between tool selection and parameters

Example AI Agent Prompt

Search for recent papers about "transformer architecture" using arXiv, 
then summarize the top 3 results.

The AI Agent will automatically:

Set Tool Name to "search_arxiv" (directly in Tool Name field)
Set Tool Parameters to {"query": "transformer architecture", "max_results": 3}
Execute the search with proper MCP protocol handling
Process and return results

Environment Variables

Support for Docker environment variables with MCP_ prefix:

version: '3'
services:
  n8n:
    image: n8nio/n8n
    environment:
      - MCP_BRAVE_API_KEY=your-api-key
      - MCP_OPENAI_API_KEY=your-openai-key
      - N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true