MCP Server Trigger node#

Use the MCP Server Trigger node to allow n8n to act as a Model Context Protocol (MCP) server, making n8n tools and workflows available to MCP clients.

Credentials

You can find authentication information for this node here.

How the MCP Server Trigger node works#

The MCP Server Trigger node acts as an entry point into n8n for MCP clients. It operates by exposing a URL that MCP clients can interact with to access n8n tools.

Unlike conventional trigger nodes, which respond to events and pass their output to the next connected node, the MCP Server Trigger node only connects to and executes tool nodes. Clients can list the available tools and call individual tools to perform work.

You can expose n8n workflows to clients by attaching them with the Custom n8n Workflow Tool node.

Server-Sent Events (SSE) support

The MCP Server Trigger node supports Server-Sent Events (SSE), a long-lived transport built on top of HTTP, for connections between clients and the server. It currently doesn't support standard input/output (stdio) transport.

Node parameters#

Use these parameters to configure your node.

MCP URL#

The MCP Server Trigger node has two MCP URLs: test and production. n8n displays the URLs at the top of the node panel.

Select Test URL or Production URL to toggle which URL n8n displays.

Test: n8n registers a test MCP URL when you select Listen for Test Event or Test workflow, if the workflow isn't active. When you call the MCP URL, n8n displays the data in the workflow.
Production: n8n registers a production MCP URL when you activate the workflow. When using the production URL, n8n doesn't display the data in the workflow. You can still view workflow data for a production execution: select the Executions tab in the workflow, then select the workflow execution you want to view.

Authentication#

You can require authentication for clients connecting to your MCP URL. Choose from these authentication methods:

Bearer auth
Header auth

Refer to the HTTP request credentials for more information on setting up each credential type.

Path#

By default, this field contains a randomly generated MCP URL path, to avoid conflicts with other MCP Server Trigger nodes.

You can manually specify a URL path, including adding route parameters. For example, you may need to do this if you use n8n to prototype an API and want consistent endpoint URLs.

The Path field can take the following formats:

/:variable
/path/:variable
/:variable/path
/:variable1/path/:variable2
/:variable1/:variable2

Templates and examples#

Integrating with Claude Desktop#

You can connect to the MCP Server Trigger node from Claude Desktop by running a gateway to proxy SSE messages to stdio-based servers.

To do so, add the following to your Claude Desktop configuration:

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway",
        "--sse",
        "<MCP_URL>",
        "--header",
        "Authorization: Bearer <MCP_BEARER_TOKEN>"
      ]
    }
  }
}

Be sure to replace the <MCP_URL> and <MCP_BEARER_TOKEN> placeholders with the values from your MCP Server Trigger node parameters and credentials.

Limitations#

Configuring the MCP Server Trigger node with webhook replicas#

The MCP Server Trigger node relies on Server-Sent Events (SSE), which require the same server instance to handle persistent connections. This can cause problems when running n8n in queue mode depending on your webhook processor configuration:

If you use queue mode with a single webhook replica, the MCP Server Trigger node works as expected.
If you run multiple webhook replicas, you need to route all /mcp* requests to a single, dedicated webhook replica. Create a separate replica set with one webhook container for MCP requests. Afterward, update your ingress or load balancer configuration to direct all /mcp* traffic to that instance.

Caution when running with multiple webhook replicas

If you run an MCP Server Trigger node with multiple webhook replicas and don't route all /mcp* requests to a single, dedicated webhook replica, your SSE connections will frequently break or fail to reliably deliver events.

n8n also provides an MCP Client Tool node that allows you to connect your n8n AI agents to external tools.

Refer to the MCP documentation and MCP specification for more details about the protocol, servers, and clients.