Zum Hauptinhalt springen

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​

String[]

ToolName​

The tool to call. Exactly one of toolName and toolNamePath is set.

public string ToolName { get; set; }

Property Value​

String

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​

String

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​

String

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​

String

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​

String

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​

String

McpServiceAccountConfigName​

Well-known name of the System.Communication/ServiceAccountConfiguration the tool call runs as. Required.

public string McpServiceAccountConfigName { get; set; }

Property Value​

String

TimeoutSeconds​

Maximum duration of the MCP calls in seconds (default 90). Must be positive.

public int TimeoutSeconds { get; set; }

Property Value​

Int32

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​

Boolean

TargetPath​

public string TargetPath { get; set; }

Property Value​

String

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​

String

Constructors​

McpToolCallNodeConfiguration()​

public McpToolCallNodeConfiguration()