MCP Server Tool Call Event
Controlled node
Overview
The MCP Server Tool Call Event node is used to handle incoming tool requests when running an MCP (Model Context Protocol) server within Intellectible. This node listens for calls to a specific tool name and fires an event when that tool is invoked by an MCP client.
Use this node in conjunction with the MCPServer node (which defines the server and available tools) and the SetMCPOutput node (which returns results to the client).
Output Events
There is one output event option for this node:
- Fired: This fires when the MCP server receives a request to execute the tool specified in the node's Name property.
Inputs
| Input | Type | Description | Default |
|---|---|---|---|
| (none) | - | This node has no external inputs. It is triggered internally by the MCP server runtime when a matching tool call is received. | - |
Outputs
| Output | Type | Description |
|---|---|---|
| Fired | Event | Fires when the specified MCP tool is called by a client. |
Runtime Behavior and Defaults
The node registers itself during workflow initialization to listen for internal MCP server events matching the pattern __internal__mcp-server-tool-call.{toolName}, where {toolName} is the value provided in the Name property.
When a client application calls the tool via the MCP protocol, the node triggers its Fired event, allowing your workflow to execute the appropriate logic. To return data to the client, connect the downstream logic to a SetMCPOutput node.
| Property | Type | Description | Default |
|---|---|---|---|
| Name | Text | The exact name of the MCP tool to listen for. This must match a tool name defined in your MCPServer node. | - |
Example Usage
Basic MCP Server Setup
- Add an MCPServer node to define your server and list available tools (e.g., a tool named
get_weather). - Add an MCP Server Tool Call Event node and set its Name property to
get_weather. - Connect the Fired event to your business logic (e.g., an API Request node to fetch weather data).
- Connect the result to a SetMCPOutput node to return the weather information to the MCP client.
[MCPServer]
↓ (defines tools including "get_weather")
[MCP Server Tool Call Event]
Name: "get_weather"
↓ Fired event
[API Request]
↓ Weather data
[SetMCPOutput]
→ Returns result to MCP client
Ensure the Name property exactly matches the tool name defined in your MCPServer node's tool list, including case sensitivity.