Super MCP icon

Super MCP

Connect to multiple MCP servers and expose their tools to AI agents

Overview

This node, named "Super MCP," is designed to connect to multiple MCP servers configured via credentials. It discovers and exposes the tools available on these MCP servers for use by AI agents within n8n workflows. The node itself does not perform any direct execution or data processing; instead, it acts as a provider of tool definitions that AI agents can leverage.

Typical use cases include:

  • Integrating various MCP servers into an AI-driven automation environment.
  • Allowing AI agents to dynamically access and utilize tools from multiple MCP servers without manual configuration in each workflow.
  • Centralizing tool discovery and management for AI workflows that require diverse capabilities.

For example, if you have several MCP servers each offering different sets of automation tools, this node aggregates their tools so that AI agents can select and invoke them seamlessly.

Properties

Name Meaning
MCP Servers Configuration A notice property instructing users to configure multiple MCP servers in the node's credentials. Each server's tools will be discovered and made available to AI agents.

Output

  • The node outputs data on the ai_tool output channel with the output name "Tool."
  • The output JSON contains a response field which holds the discovered tools fetched from the configured MCP servers.
  • This output is intended for internal use by AI agents to understand what tools are available; it is not meant for direct user consumption.
  • The node does not produce binary data.

Dependencies

  • Requires credentials containing MCP server configurations in JSON format.
  • Depends on an external module McpManager (imported dynamically) responsible for connecting to MCP servers and retrieving their tools.
  • The node expects the MCP server configurations to be valid JSON with a structure including mcpServers.
  • No additional environment variables or n8n-specific configurations are explicitly required beyond the credential setup.

Troubleshooting

  • No MCP servers configured: If no MCP server configurations are found in the credentials, the node throws an error prompting to add MCP server configurations.
  • Invalid MCP configuration JSON: If the JSON in the credentials is malformed, an error indicates invalid JSON format.
  • No MCP servers defined: If the parsed configuration lacks any MCP servers, an error is thrown.
  • Failed to initialize MCP tools: Errors during connection or tool retrieval from MCP servers result in a failure message with details.
  • Direct execution error: Attempting to execute this node directly results in an error stating it cannot be executed directly because it only provides tools to AI agents.

To resolve these issues:

  • Ensure the MCP server configurations are correctly added in the credentials as valid JSON.
  • Verify that at least one MCP server is defined in the configuration.
  • Use this node only as a tool provider for AI agents, not as a standalone executable node.

Links and References

  • No external links are provided in the source code.
  • For more information on configuring credentials and using AI agents in n8n, refer to the official n8n documentation.

Discussion