Struct SdkMcpTool 

pub struct SdkMcpTool {
    pub name: String,
    pub description: String,
    pub input_schema: Value,
    pub handler: SdkMcpToolHandler,
    pub annotations: Option<ToolAnnotations>,
}

Definition of an in-process MCP tool.

Created via the tool() factory function. Can be customized with with_annotations() before being passed to create_sdk_mcp_server().

Fields

• name — Unique tool name (used by the model to invoke it).
• description — Human-readable description of what the tool does.
• input_schema — JSON Schema defining the tool’s input parameters.
• handler — Async function that executes the tool logic.
• annotations — Optional behavioral hints (read-only, destructive, etc.).

Fields

name: String

Tool name exposed to Claude.

description: String

Human-readable tool description.

input_schema: Value

JSON Schema for the tool arguments.

handler: SdkMcpToolHandler

Async handler invoked for tool calls.

annotations: Option<ToolAnnotations>

Optional behavior hints for the model/runtime.

Implementations

impl SdkMcpTool

pub fn with_annotations(self, annotations: ToolAnnotations) -> Self

Adds behavioral annotations to this tool.

Annotations provide hints about the tool’s behavior (e.g., read-only, destructive, idempotent) to help with permission handling.

Returns self for method chaining.

Example

use claude_code::{tool, ToolAnnotations};
use serde_json::{json, Value};

let tool = tool(
    "read_status",
    "Reads status",
    json!({"type":"object"}),
    |_args: Value| async move { Ok(json!({"content": []})) },
)
.with_annotations(ToolAnnotations {
    read_only_hint: Some(true),
    ..Default::default()
});

assert!(tool.annotations.is_some());

Trait Implementations

impl Clone for SdkMcpTool

fn clone(&self) -> SdkMcpTool

Returns a duplicate of the value.

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

Performs copy-assignment from source.