google-adk-kotlin-core/com.google.adk.kt.tools.mcp/McpToolset/McpToolsetConfig

McpToolsetConfig

data class McpToolsetConfig(val stdioConnectionParams: McpConnectionParameters.Stdio? = null, val sseConnectionParams: McpConnectionParameters.Sse? = null, val streamableHttpConnectionParams: McpConnectionParameters.StreamableHttp? = null, val toolFilter: ToolFilter? = null, val useMcpResources: Boolean = false, val maxMcpResourceLength: Int = DEFAULT_MAX_RESOURCE_LENGTH)

Configuration for an McpToolset, used to construct one via toToolset.

Exactly one of stdioConnectionParams, sseConnectionParams, or streamableHttpConnectionParams must be set; toToolset throws if zero or more than one are provided.

Constructors

McpToolsetConfig

constructor(stdioConnectionParams: McpConnectionParameters.Stdio? = null, sseConnectionParams: McpConnectionParameters.Sse? = null, streamableHttpConnectionParams: McpConnectionParameters.StreamableHttp? = null, toolFilter: ToolFilter? = null, useMcpResources: Boolean = false, maxMcpResourceLength: Int = DEFAULT_MAX_RESOURCE_LENGTH)

Properties

maxMcpResourceLength

val maxMcpResourceLength: Int

Maximum length, in characters, of a single resource payload returned by load_mcp_resource. Longer payloads are truncated.

sseConnectionParams

val sseConnectionParams: McpConnectionParameters.Sse?

Connection parameters for an MCP server reached over SSE.

stdioConnectionParams

val stdioConnectionParams: McpConnectionParameters.Stdio?

Connection parameters for a local MCP server reached over stdio (e.g. one launched via npx or python3).

streamableHttpConnectionParams

val streamableHttpConnectionParams: McpConnectionParameters.StreamableHttp?

Connection parameters for an MCP server reached over the Streamable HTTP transport.

toolFilter

val toolFilter: ToolFilter?

Optional filter selecting which of the tools advertised by the server are exposed to the agent. Use ToolFilter.AllowList (or the ToolFilter.allowList helper) to keep tools by name, or ToolFilter.Predicate for context-aware selection that can consult the ReadonlyContext. When null, all tools advertised by the server are exposed. The resource tools added by useMcpResources are ADK's own and are not filtered.

useMcpResources

val useMcpResources: Boolean

When true, resource-related tools (list_mcp_resources, list_mcp_resource_templates, load_mcp_resource) are added to the toolset, granting the agent access to MCP resources exposed by the server. They are added only if the server reports the resources capability during the handshake; against a server that does not, they are omitted and a warning is logged, because the MCP client rejects the requests those tools would make. toolFilter does not apply to them: it selects among the tools the server advertises, so enabling this flag and filtering the server's tools are independent choices. Defaults to false.

Functions

toToolset

fun toToolset(headerProvider: suspend (ReadonlyContext) -> Map<String, String>? = null, progressConsumers: List<(McpSchema.ProgressNotification) -> Unit> = emptyList()): McpToolset

Creates an McpToolset from this configuration.