See ExMCP.ClientConfig.add_fallback/3.

@spec add_validation_rule(t(), atom(), validation_rule(), String.t()) :: t()

Adds a custom validation rule for a specific field.

Examples

config = ExMCP.ClientConfigEnhanced.new()
|> ExMCP.ClientConfigEnhanced.add_validation_rule(
  :timeout,
  &validate_timeout_range/1,
  "Timeout must be between 1000 and 300000 ms"
)

@spec diff_configs(t(), t()) :: String.t()

Shows differences between two configurations.

Examples

diff = ExMCP.ClientConfigEnhanced.diff_configs(old_config, new_config)
IO.puts(diff)

@spec from_env(atom(), atom(), keyword()) :: t()

Creates a configuration from Application environment settings.

Examples

# Load from config/config.exs: config :my_app, mcp_config: [...]
config = ExMCP.ClientConfigEnhanced.from_env(:my_app, :mcp_config)

# With fallback to default profile
config = ExMCP.ClientConfigEnhanced.from_env(:my_app, :mcp_config, default: :production)

@spec from_env_vars(env_mapping() | nil) :: t()

Creates a configuration from system environment variables.

Examples

# Use default variable mapping
config = ExMCP.ClientConfigEnhanced.from_env_vars()

# Use custom mapping
mapping = %{
  "API_URL" => :url,
  "API_TIMEOUT" => {:timeouts, :request},
  "RETRY_COUNT" => {:retry_policy, :max_attempts}
}
config = ExMCP.ClientConfigEnhanced.from_env_vars(mapping)

@spec from_template(
  template_name(),
  keyword()
) :: t()

Creates configuration from a template with customizations.

Examples

# Production API template
config = ExMCP.ClientConfigEnhanced.from_template(:production_api, 
  url: "https://api.production.com",
  auth: [type: :bearer, token: "secret"]
)

# Development local template
config = ExMCP.ClientConfigEnhanced.from_template(:development_local,
  command: ["python", "dev_server.py"]
)

See ExMCP.ClientConfig.get_all_transports/1.

@spec inspect_config(
  t(),
  keyword()
) :: String.t()

Pretty-prints configuration for debugging.

Examples

ExMCP.ClientConfigEnhanced.inspect_config(config)
ExMCP.ClientConfigEnhanced.inspect_config(config, sections: [:transport, :auth])

@spec merge_configs(t(), t(), merge_strategy()) :: t()

Merges two configurations with specified strategy.

Examples

# Deep merge (default)
merged = ExMCP.ClientConfigEnhanced.merge_configs(base, override)

# Override strategy
merged = ExMCP.ClientConfigEnhanced.merge_configs(base, override, :override)

@spec merge_env_overrides(t(), env_mapping()) :: t()

Merges environment overrides into an existing configuration.

Examples

base_config = ExMCP.ClientConfigEnhanced.new(:production)
config = ExMCP.ClientConfigEnhanced.merge_env_overrides(base_config, %{
  "OVERRIDE_URL" => :url,
  "OVERRIDE_TIMEOUT" => {:timeouts, :request}
})

See ExMCP.ClientConfig.new/0.

See ExMCP.ClientConfig.new/1.

See ExMCP.ClientConfig.new/2.

See ExMCP.ClientConfig.put_auth/3.

@spec put_client_info(t(), keyword() | map()) :: t()

Configures client information with automatic user_agent generation.

See ExMCP.ClientConfig.put_custom/3.

@spec put_observability(
  t(),
  keyword()
) :: t()

Configures observability settings with enhanced deep merging.

@spec put_pool(t(), keyword() | map()) :: t()

Sets the pool configuration using enhanced macro-generated setter.

Automatically handles merging and validation based on field requirements.

@spec put_retry_policy(t(), keyword() | map()) :: t()

@spec put_retry_policy(
  t(),
  keyword()
) :: t()

Configures retry policy with validation.

See ExMCP.ClientConfig.put_timeout/2.

See ExMCP.ClientConfig.put_transport/3.

@spec quick_http(
  String.t(),
  keyword()
) :: t()

Quick HTTP configuration for common scenarios.

Examples

config = ExMCP.ClientConfigEnhanced.quick_http("https://api.example.com")
config = ExMCP.ClientConfigEnhanced.quick_http("https://api.example.com", 
  auth: [type: :bearer, token: "secret"],
  timeout: 30_000
)

@spec quick_stdio(
  String.t() | [String.t()],
  keyword()
) :: t()

Quick stdio configuration for common scenarios.

Examples

config = ExMCP.ClientConfigEnhanced.quick_stdio(["python", "server.py"])
config = ExMCP.ClientConfigEnhanced.quick_stdio("mcp-server", 
  env: [{"DEBUG", "1"}],
  timeout: 15_000
)

See ExMCP.ClientConfig.to_client_opts/1.

See ExMCP.ClientConfig.validate/1.

@spec validate_with_rules(
  t(),
  keyword()
) :: :ok | {:error, [{atom(), String.t()}]}

Validates configuration with enhanced error reporting and custom rules.

Examples

case ExMCP.ClientConfigEnhanced.validate_with_rules(config) do
  :ok -> {:ok, client} = ExMCP.connect(config)
  {:error, detailed_errors} -> handle_validation_errors(detailed_errors)
end