Class DefaultMcpClientBuilder<T>

java.lang.Object

dev.langchain4j.agentic.mcp.DefaultMcpClientBuilder<T>

All Implemented Interfaces:

InternalAgent, McpClientBuilder<T>, AgentInstance, InvocationHandler

public class DefaultMcpClientBuilder<T>
extends Object
implements McpClientBuilder<T>, InternalAgent, InvocationHandler

Method Summary

Modifier and Type	Method	Description
AgentCondition	activationCondition()	The condition under which this agent runs when it is invoked as a subagent, or null when it always runs.
McpClientBuilder<T>	activationCondition(String description, Predicate<AgenticScope> activationCondition)	Sets the condition, with its description, under which the agent runs when it is invoked as a subagent of an agentic system.
String	agentId()
void	appendId(String idSuffix)
List<AgentArgument>	arguments()
boolean	async()
McpClientBuilder<T>	async(boolean async)
T	build()
String	description()
McpClientBuilder<T>	inputKeys(String... inputKeys)
Object	invoke(Object proxy, Method method, Object[] args)
AgentListener	listener()
McpClientBuilder<T>	listener(AgentListener agentListener)
String	name()
String	outputKey()
McpClientBuilder<T>	outputKey(String outputKey)
Type	outputType()
AgentInstance	parent()
Class<? extends Planner>	plannerType()
void	registerInheritedParentListener(AgentListener parentListener)
void	setParent(InternalAgent parent)
List<AgentInstance>	subagents()
McpClientBuilder<T>	toolName(String toolName)
AgenticSystemTopology	topology()
Class<?>	type()

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface AgentInstance

as, leaf, optional

Methods inherited from interface InternalAgent

allowChatMemory, allowStreamingOutput, compensateOnError, enableCrossAgentCompensation, setAgentId

Methods inherited from interface McpClientBuilder

activationCondition

Method Details

toolName

public McpClientBuilder<T> toolName(String toolName)

Specified by:

toolName in interface McpClientBuilder<T>

inputKeys

public McpClientBuilder<T> inputKeys(String... inputKeys)

Specified by:

inputKeys in interface McpClientBuilder<T>

outputKey

public McpClientBuilder<T> outputKey(String outputKey)

Specified by:

outputKey in interface McpClientBuilder<T>

async

public McpClientBuilder<T> async(boolean async)

Specified by:

async in interface McpClientBuilder<T>

listener

public McpClientBuilder<T> listener(AgentListener agentListener)

Specified by:

listener in interface McpClientBuilder<T>

activationCondition

public McpClientBuilder<T> activationCondition(String description,
 Predicate<AgenticScope> activationCondition)

Description copied from interface: McpClientBuilder

Sets the condition, with its description, under which the agent runs when it is invoked as a subagent of an agentic system. When the condition is false the MCP tool is not called and the agent is skipped. It can be evaluated more than once, so it must be free of side effects.

Specified by:

activationCondition in interface McpClientBuilder<T>

build

public T build()

Specified by:

build in interface McpClientBuilder<T>

invoke

public Object invoke(Object proxy,
 Method method,
 Object[] args)
              throws Exception

Specified by:

invoke in interface InvocationHandler

Throws:

Exception

setParent

public void setParent(InternalAgent parent)

Specified by:

setParent in interface InternalAgent

registerInheritedParentListener

public void registerInheritedParentListener(AgentListener parentListener)

Specified by:

registerInheritedParentListener in interface InternalAgent

appendId

public void appendId(String idSuffix)

Specified by:

appendId in interface InternalAgent

listener

public AgentListener listener()

Specified by:

listener in interface InternalAgent

type

public Class<?> type()

Specified by:

type in interface AgentInstance

plannerType

public Class<? extends Planner> plannerType()

Specified by:

plannerType in interface AgentInstance

name

public String name()

Specified by:

name in interface AgentInstance

agentId

public String agentId()

Specified by:

agentId in interface AgentInstance

description

public String description()

Specified by:

description in interface AgentInstance

outputType

public Type outputType()

Specified by:

outputType in interface AgentInstance

outputKey

public String outputKey()

Specified by:

outputKey in interface AgentInstance

async

public boolean async()

Specified by:

async in interface AgentInstance

activationCondition

public AgentCondition activationCondition()

Description copied from interface: AgentInstance

The condition under which this agent runs when it is invoked as a subagent, or null when it always runs. When the condition is false, the agent is skipped: it is not invoked, it writes nothing to the AgenticScope and its parent's planner is notified of the skip. The condition is ignored when the agent is invoked directly, as the root of an agentic system.

The condition can be evaluated more than once for a single invocation, by the planner of the parent while selecting its next agents and again when the agent is invoked, so it must be cheap and free of side effects.

Specified by:

activationCondition in interface AgentInstance

arguments

public List<AgentArgument> arguments()

Specified by:

arguments in interface AgentInstance

parent

public AgentInstance parent()

Specified by:

parent in interface AgentInstance

subagents

public List<AgentInstance> subagents()

Specified by:

subagents in interface AgentInstance

topology

public AgenticSystemTopology topology()

Specified by:

topology in interface AgentInstance