Struct Server 

pub struct Server<H, T, R, P, K> { /* private fields */ }

A configured MCP server ready to serve requests.

The type parameters track which capabilities are available:

• H: Base server handler
• T: Tool handler (NotRegistered or Registered<TH>)
• R: Resource handler
• P: Prompt handler
• K: Task handler

Implementations

impl<H, T, R, P, K> Server<H, T, R, P, K>

where H: ServerHandler,

pub const fn capabilities(&self) -> &ServerCapabilities

Get the server’s capabilities.

pub const fn list_page_size(self, page_size: usize) -> Self

Enable pagination of tools/list, resources/list, resources/templates/list, and prompts/list at the given page size.

By default pagination is disabled (each list returns all items with no nextCursor). Setting a page size bounds the response payload; clients follow the returned nextCursor to fetch subsequent pages. A size of 0 is treated as disabled.

pub fn with_completion<C: CompletionHandler + 'static>( self, completion: C, ) -> Self

Register a completion handler and advertise the completions capability.

This wires completion/complete on both the runtime and the framework adapters. Completion is a leaf capability, so unlike tools/resources/ prompts/tasks it is not tracked in the type parameters.

pub const fn handler(&self) -> &H

Get a reference to the base handler.

pub fn server_info(&self) -> ServerInfo

Get the server info from the base handler.

impl<H, TH, R, P, K> Server<H, Registered<TH>, R, P, K>

where H: ServerHandler, TH: ToolHandler,

pub const fn tool_handler(&self) -> &TH

Get a reference to the tool handler.

impl<H, T, RH, P, K> Server<H, T, Registered<RH>, P, K>

where H: ServerHandler, RH: ResourceHandler,

pub const fn resource_handler(&self) -> &RH

Get a reference to the resource handler.

impl<H, T, R, PH, K> Server<H, T, R, Registered<PH>, K>

where H: ServerHandler, PH: PromptHandler,

pub const fn prompt_handler(&self) -> &PH

Get a reference to the prompt handler.

impl<H, T, R, P, KH> Server<H, T, R, P, Registered<KH>>

where H: ServerHandler, KH: TaskHandler,

pub const fn task_handler(&self) -> &KH

Get a reference to the task handler.

impl<H, T, R, P, K> Server<H, T, R, P, K>

where H: ServerHandler + Send + Sync + 'static, T: Send + Sync + 'static, R: Send + Sync + 'static, P: Send + Sync + 'static, K: Send + Sync + 'static, Self: RequestRouter,

Extension methods for Server to run with a transport.

pub async fn serve<Tr>(self, transport: Tr) -> Result<(), McpError>

where Tr: Transport + 'static, Tr::Error: Into<McpError>,

Run this server over the given transport.

Trait Implementations

impl<H, T, R, P, K> RequestRouter for Server<H, T, R, P, K>

where H: ServerHandler + Send + Sync, T: ToolSlot, R: ResourceSlot, P: PromptSlot, K: TaskSlot,

Single RequestRouter implementation over the typestate handler slots.

Each capability is a slot (Registered<H> / NotRegistered) exposing an optional object-safe handler; routing checks each in turn. Adding a dispatched capability is one slot plus one arm here – there is no per-combination explosion. The shared per-method routing logic lives in crate::router.

fn server_info(&self) -> ServerInfo

Get the server info.

async fn route_notification( &self, method: &str, _params: Option<&Value>, ctx: &Context<'_>, )

Dispatch an inbound client notification (e.g. notifications/initialized or notifications/roots/list_changed) to the server’s lifecycle hooks. Analogous to route but for notifications — there is no reply. Defaults to a no-op.

async fn route( &self, method: &str, params: Option<&Value>, ctx: &Context<'_>, ) -> Result<Value, McpError>

Route a request and return the result.

async fn tool_task_support(&self, name: &str, ctx: &Context<'_>) -> TaskSupport

The task-augmentation support a tool declares (Tool.execution.taskSupport), used to gate task-augmented tools/call. Defaults to Forbidden.

async fn call_tool_json( &self, name: &str, args: Object, ctx: &Context<'_>, ) -> Result<Value, McpError>

Run a tool to completion for task-augmented execution, returning its CallToolResult as JSON (the tasks/result payload). Defaults to method-not-found.