Embabel Agent Documentation/com.embabel.agent.spi.config.spring/ConditionalOnMcpConnection

ConditionalOnMcpConnection

@Target(allowedTargets = [AnnotationTarget.FUNCTION, AnnotationTarget.CLASS])

annotation class ConditionalOnMcpConnection(val value: String)

Conditional annotation that enables bean creation only when a specific MCP connection is configured in Spring AI properties.

Checks for the presence of: spring.ai.mcp.client.stdio.connections.{connectionName}.command spring.ai.mcp.client.sse.connections.{connectionName}.url

Parameters

value

The connection name(s) as defined in spring.ai.mcp.client.stdio.connections

Example usage:

@Bean
@ConditionalOnMcpConnection("github-mcp")
fun githubToolsGroup(): ToolGroup { ... }

// Multiple connections - ANY match
@Bean
@ConditionalOnMcpConnection("brave-search-mcp", "fetch-mcp")
fun webToolsGroup(): ToolGroup { ... }

Properties

value

val value: Array<out String>

The MCP connection name(s) as defined in spring.ai.mcp.client.stdio.connections