Struct InputRequired 

pub struct InputRequired { /* private fields */ }

A handler’s request for input from the client (MCP 2026-07-28 multi round-trip requests): the client answers each request and calls again, the answers then in McpContext::input_response under the same keys, and state in McpContext::request_state.

use rust_web_server::mcp::{InputRequired, McpContent, McpServer};

let server = McpServer::new("greeter", "1.0").tool_with_context("greet", "Greets you", "{}", |ctx, _args| {
    match ctx.input_response("name") {
        Some(answer) => Ok(McpContent::text(format!("Hello! (you said {answer})"))),
        None => Ok(McpContent::input_required(InputRequired::new().elicit(
            "name",
            "What is your name?",
            r#"{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]}"#,
        ))),
    }
});

Implementations

impl InputRequired

pub fn new() -> Self

pub fn elicit(self, key: &str, message: &str, requested_schema: &str) -> Self

Ask the user to fill in a form: requested_schema is a JSON Schema object of primitive properties (elicitation/create, form mode). Needs the client’s elicitation capability.

pub fn sample(self, key: &str, request: &SamplingRequest) -> Self

Ask the client’s LLM (sampling/createMessage). Needs the client’s sampling capability.

pub fn list_roots(self, key: &str) -> Self

Ask for the client’s roots (roots/list). Needs the client’s roots capability.

pub fn state(self, state: impl Into<String>) -> Self

Opaque state for the retry, echoed back by the client: signed by the server, so the handler gets back exactly what it set.

Trait Implementations

impl Clone for InputRequired

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InputRequired

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

Formats the value using the given formatter.

impl Default for InputRequired

fn default() -> Self

Returns the “default value” for a type.