Struct McpHttpClientBuilder 

pub struct McpHttpClientBuilder { /* private fields */ }

Available on crate feature tools only.

Builder for HTTP-based MCP connections.

This builder creates connections to remote MCP servers using the streamable HTTP transport (SEP-1686 compliant).

Example

use adk_tool::mcp::{McpHttpClientBuilder, McpAuth, OAuth2Config};

// Simple connection
let toolset = McpHttpClientBuilder::new("https://mcp.example.com/v1")
    .connect()
    .await?;

// With OAuth2 authentication
let toolset = McpHttpClientBuilder::new("https://mcp.example.com/v1")
    .with_auth(McpAuth::oauth2(
        OAuth2Config::new("client-id", "https://auth.example.com/token")
            .with_secret("client-secret")
            .with_scopes(vec!["mcp:read".into()])
    ))
    .timeout(Duration::from_secs(60))
    .connect()
    .await?;

Implementations

impl McpHttpClientBuilder

pub fn new(endpoint: impl Into<String>) -> McpHttpClientBuilder

Create a new HTTP client builder for the given endpoint.

Arguments

• endpoint - The MCP server URL (e.g., https://mcp.example.com/v1)

pub fn with_auth(self, auth: McpAuth) -> McpHttpClientBuilder

Set authentication for the connection.

Example

let builder = McpHttpClientBuilder::new("https://mcp.example.com")
    .with_auth(McpAuth::bearer("my-token"));

pub fn timeout(self, timeout: Duration) -> McpHttpClientBuilder

Set the request timeout.

Default is 30 seconds.

pub fn header( self, key: impl Into<String>, value: impl Into<String>, ) -> McpHttpClientBuilder

Add a custom header to all requests.

pub fn with_elicitation_handler( self, handler: Arc<dyn ElicitationHandler>, ) -> McpHttpClientBuilder

Configure an elicitation handler for the HTTP connection.

When set, use connect_with_elicitation to create a toolset that advertises elicitation capabilities.

pub fn endpoint(&self) -> &str

Get the endpoint URL.

pub fn get_timeout(&self) -> Duration

Get the configured timeout.

pub fn get_auth(&self) -> &McpAuth

Get the authentication configuration.

pub async fn connect(self) -> Result<(), AdkError>

Available on non-crate feature http-transport only.

Connect to the MCP server (stub when http-transport feature is disabled).

pub async fn connect_with_elicitation(self) -> Result<(), AdkError>

Available on non-crate feature http-transport only.

Connect with elicitation support (stub when http-transport feature is disabled).

Trait Implementations

impl Clone for McpHttpClientBuilder

fn clone(&self) -> McpHttpClientBuilder

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for McpHttpClientBuilder

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.