Skip to content

initial docs for standalone mcp client node #3975

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
HumanistSerif merged 7 commits into from
Dec 7, 2025
Merged

initial docs for standalone mcp client node #3975

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
a231c65
initial docs for standalone mcp client node
pdwarf Dec 4, 2025
022aac1
Merge branch 'main' into doc-1685-docs-for-standalone-mcp-client-node
pdwarf Dec 4, 2025
20262ab
Fix mention of Tool node (copy & paste artifact)
pdwarf Dec 4, 2025
7079e42
Merge branch 'main' into doc-1685-docs-for-standalone-mcp-client-node
pdwarf Dec 4, 2025
3d8065c
Removed accidental copy pasted option from mcp tool node
pdwarf Dec 4, 2025
1d45b0a
Minor tech writer edits
HumanistSerif Dec 7, 2025
01b7b71
Merge branch 'main' into doc-1685-docs-for-standalone-mcp-client-node
HumanistSerif Dec 7, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
52 changes: 52 additions & 0 deletions docs/integrations/builtin/core-nodes/n8n-nodes-langchain.mcpClient.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
---
title: MCP Client node documentation
description: Learn how to use the MCP Client node in n8n. Follow technical documentation to integrate MCP Client node into your workflows.
contentType: [integration, reference]
---

# MCP Client node

The MCP Client node is a [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) client that allows you to use the tools that are exposed by an external MCP server.

Check warning on line 9 in docs/integrations/builtin/core-nodes/n8n-nodes-langchain.mcpClient.md

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[from-write-good.Passive] 'are exposed' may be passive voice. Use active voice if you can.

Raw Output:
{"message": "[from-write-good.Passive] 'are exposed' may be passive voice. Use active voice if you can.", "location": {"path": "docs/integrations/builtin/core-nodes/n8n-nodes-langchain.mcpClient.md", "range": {"start": {"line": 9, "column": 148}}}, "severity": "WARNING"}

You can use the MCP Client node to use MCP tools as regular steps in a workflow.

If you want to use MCP tools as tools for an AI Agent, use the [MCP Client Tool node](/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.toolmcp.md) instead.

/// note | Credentials
The MCP Client node supports [Bearer](/integrations/builtin/credentials/httprequest.md#using-bearer-auth), generic [header](/integrations/builtin/credentials/httprequest.md#using-header-auth), and [OAuth2](/integrations/builtin/credentials/httprequest.md#using-oauth2) authentication methods.
///

## Node parameters

Configure the node with the following parameters.

* **Server Transport**: The transport protocol used by the MCP Server endpoint you want to connect to.
* **MCP Endpoint URL**: The URL of the external MCP Server. For example, `https://mcp.notion.com/mcp`.
* **Authentication**: The authentication method for authentication to your MCP server. The MCP Client node supports [bearer](/integrations/builtin/credentials/httprequest.md#using-bearer-auth), generic [header](/integrations/builtin/credentials/httprequest.md#using-header-auth), and [OAuth2](/integrations/builtin/credentials/httprequest.md#using-oauth2) authentication. Select **None** to attempt to connect without authentication.
* **Tool**: Select the tool to use in the node. The list of tools is automatically fetched from the external MCP server.
* **Input Mode**:
* **Manual**: Specify each tool parameter manually.
* **JSON**: Specify tool parameters as a JSON object. Use this mode for tools with nested parameters.

## Options

* **Convert to Binary**: Whether to convert images and audio to binary data. If false, images and audio are returned as base64 encoded strings.

Check warning on line 33 in docs/integrations/builtin/core-nodes/n8n-nodes-langchain.mcpClient.md

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[from-write-good.Passive] 'are returned' may be passive voice. Use active voice if you can.

Raw Output:
{"message": "[from-write-good.Passive] 'are returned' may be passive voice. Use active voice if you can.", "location": {"path": "docs/integrations/builtin/core-nodes/n8n-nodes-langchain.mcpClient.md", "range": {"start": {"line": 33, "column": 105}}}, "severity": "WARNING"}
* **Timeout**: Time in milliseconds to wait for tool calls to finish.

## Templates and examples

<!-- see https://www.notion.so/n8n/Pull-in-templates-for-the-integrations-pages-37c716837b804d30a33b47475f6e3780 -->
[[ templatesWidget(page.title, 'mcp-client') ]]

## Related resources

To use MCP tools with AI Agents, n8n has the [MCP Client Tool node](/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.toolmcp.md).

n8n also has an [MCP Server Trigger](/integrations/builtin/core-nodes/n8n-nodes-langchain.mcptrigger.md) node that allows you to expose n8n tools to external AI Agents.

Refer to the [MCP documentation](https://modelcontextprotocol.io/introduction) and [MCP specification](https://modelcontextprotocol.io/specification/) for more details about the protocol, servers, and clients.

--8<-- "_snippets/integrations/builtin/cluster-nodes/tools-link.md"

--8<-- "_snippets/integrations/builtin/cluster-nodes/langchain-overview-link.md"

1 change: 1 addition & 0 deletions nav.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -229,6 +229,7 @@ nav:
- integrations/builtin/core-nodes/n8n-nodes-base.splitinbatches.md
- Manual Trigger: integrations/builtin/core-nodes/n8n-nodes-base.manualworkflowtrigger.md
- integrations/builtin/core-nodes/n8n-nodes-base.markdown.md
- MCP Client: integrations/builtin/core-nodes/n8n-nodes-langchain.mcpClient.md
- MCP Server Trigger: integrations/builtin/core-nodes/n8n-nodes-langchain.mcptrigger.md
- integrations/builtin/core-nodes/n8n-nodes-base.merge.md
- integrations/builtin/core-nodes/n8n-nodes-base.n8n.md
Expand Down