McpToolCallNodeConfiguration
Namespace: Meshmakers.Octo.MeshAdapter.Nodes.Transform
Calls one tool on the tenant's OctoMesh MCP service deterministically — no language model
decides anything. Typical use: after an AnthropicAiQuery@1 step has produced
schema-valid JSON, the pipeline writes it through an MCP tool such as
knowledge_upsert_page, so the tool's own guards (content guard, versioning) apply.
public record McpToolCallNodeConfiguration : TargetPathNodeConfiguration, INodeConfiguration, IEquatable<NodeConfiguration>, ITargetPathNodeConfiguration, IEquatable<TargetPathNodeConfiguration>, IEquatable<McpToolCallNodeConfiguration>
Inheritance Object → NodeConfiguration → TargetPathNodeConfiguration → McpToolCallNodeConfiguration
Implements INodeConfiguration, IEquatable<NodeConfiguration>, ITargetPathNodeConfiguration, IEquatable<TargetPathNodeConfiguration>, IEquatable<McpToolCallNodeConfiguration>
Remarks:
Allowlist.allowedTools is required and names every tool the node may
call. The tool to call (toolName, or the value at toolNamePath)
must be one of them (exact, case-sensitive match); otherwise the node fails before any token
is requested or any network call is made. continueOnError does not apply to
that failure.
Identity. The call always runs as the service account of
mcpServiceAccountConfigName (a System.Communication/ServiceAccountConfiguration,
e.g. knowledge-curator). Fail-closed: without a token the node fails; it never sends an
unauthenticated request. Credentials never appear in the pipeline definition.
Endpoint. The MCP service URL comes from the McpServerUrl of the
AiConfiguration named by aiConfigurationName (the per-cluster value, handed
over through the pipeline's Uses association), else from mcpServerUrl. The
tenant is appended: {url}/{tenantId}/mcp.
Properties
AllowedTools
The tools this node may call (exact MCP tool names, e.g. ["knowledge_upsert_page"]).
Required and non-empty: there is no "call any tool" mode.
public String[] AllowedTools { get; set; }
Property Value
ToolName
The tool to call. Exactly one of toolName and toolNamePath is set.
public string ToolName { get; set; }
Property Value
ToolNamePath
JSONPath to a string in the data context naming the tool to call (e.g. chosen by an earlier
step). The value must still be in allowedTools.
public string ToolNamePath { get; set; }
Property Value
ArgumentsPath
JSONPath to a JSON object in the data context that is sent as the tool's arguments. When not set, the tool is called with an empty argument object. A path that does not resolve to an object fails the node.
public string ArgumentsPath { get; set; }
Property Value
ExecutionIdArgument
Name of a top-level tool argument that receives the id of the current pipeline execution (a GUID
string), e.g. runRef for knowledge_upsert_page, so the written page version references
the exact run. The value replaces an argument of the same name from argumentsPath.
Not set = the arguments are sent unchanged.
public string ExecutionIdArgument { get; set; }
Property Value
AiConfigurationName
Well-known name of the System.Communication/AiConfiguration whose McpServerUrl is
used (recommended; the pipeline needs a Uses association to it). Takes precedence over
mcpServerUrl.
public string AiConfigurationName { get; set; }
Property Value
McpServerUrl
Fallback MCP service URL (e.g. https://localhost:5017 for local development) when no
aiConfigurationName supplies one.
public string McpServerUrl { get; set; }
Property Value
McpServiceAccountConfigName
Well-known name of the System.Communication/ServiceAccountConfiguration the tool call
runs as. Required.
public string McpServiceAccountConfigName { get; set; }
Property Value
TimeoutSeconds
Maximum duration of the MCP calls in seconds (default 90). Must be positive.
public int TimeoutSeconds { get; set; }
Property Value
ContinueOnError
Whether the pipeline continues when the tool call fails (MCP error, tool error result, unreachable server). Configuration errors and allowlist violations always fail the node.
public bool ContinueOnError { get; set; }
Property Value
TargetPath
public string TargetPath { get; set; }
Property Value
TargetValueWriteMode
public TargetValueWriteModes TargetValueWriteMode { get; set; }
Property Value
TargetValueWriteModes
TargetValueKind
public ValueKinds TargetValueKind { get; set; }
Property Value
ValueKinds
DocumentMode
public DocumentModes DocumentMode { get; set; }
Property Value
DocumentModes
Description
public string Description { get; set; }
Property Value
Constructors
McpToolCallNodeConfiguration()
public McpToolCallNodeConfiguration()