NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
crates.io
crates.io, #1476 most downloaded on crates.io
Rust SDK for Model Context Protocol
Latest stable
3.9.0
Last release 17 days ago
05 Nov 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
2 years old
72 releases · first in 2025
Drag across the ruler to compare, or tap a release to open it.
*(auth)* structure protected resource discovery errors
Your coding agent can read these notes before it upgrades. Set up the MCP server →
*(transport)* expose body-free HTTP status errors
*(auth)* support OIDC ID-token subjects in enterprise exchange
*(client)* cancel an abandoned tools/call, prompts/get or resources/read
*(server)* keep discover lifecycle bootstrap-neutral
update LATEST and add LATEST_WITH_INITIALIZE
*(transport)* fall back after JSON discover rejections
*(model)* deprecate ServerInfo and ClientInfo aliases
add ServerHandler::negotiate_initialize
*(auth)* coordinate OAuth refreshes through credential stores
*(rmcp)* preserve elicitation requestedSchema $schema dialect
*(auth)* ignore query parameters when matching resources
*(auth)* map 401/403 challenges on the SSE GET stream
emit cache hints from handler macros
classify authorization-required errors
*(auth)* use discovered resource for token refresh
Compatibility: APIs deprecated before 3.0 have been removed, and the minimum supported Rust version is now 1.88.
RMCP 3.0 adds support for MCP 2026-07-28. Review the protocol key changes and the RMCP 3.0 migration guide before upgrading from 2.x.
Mcp-Session-Id, standalone GET stream, DELETE-based session termination, or Last-Event-ID resumption. RMCP creates a fresh handler per request, so persistent state must live outside the handler. stateful_mode is renamed to legacy_session_mode and now only controls older protocol versions; custom SSE clients must also accept an optional session ID.initialize/notifications/initialized; each request carries the protocol version and client capabilities in _meta, and servers expose server/discover. RMCP clients opt into this lifecycle with serve_with_lifecycle and ClientLifecycleMode::Discover or Auto; the existing serve() path remains available for legacy initialization.subscriptions/listen replaces the standalone GET stream and resources/subscribe/resources/unsubscribe. ping, logging/setLevel, and notifications/roots/list_changed are unavailable under 2026-07-28; RMCP retains their APIs for legacy protocol sessions.ServerHandler::call_tool, get_prompt, and read_resource now return MRTR-aware response enums. Manual handler implementations and exhaustive ServerResult matches must handle InputRequiredResult, and result models carry an optional result_type for legacy wire compatibility.io.modelcontextprotocol/tasks extension, including new task handlers, methods, and TaskManager APIs.MetaObject, RequestMetaObject, and NotificationMetaObject; Annotations::last_modified is now Option<String>; and tool structured content accepts any serde_json::Value.AuthorizationRequest; metadata discovery is renamed to resolve_metadata and returns provenance; and custom OAuth HTTP errors are now boxed source errors.issuer by @jamadeo in https://github.com/modelcontextprotocol/rust-sdk/pull/1051issuer in authorization server metadata by default by @jamadeo in https://github.com/modelcontextprotocol/rust-sdk/pull/1054Full Changelog: https://github.com/modelcontextprotocol/rust-sdk/compare/rmcp-v2.2.0...rmcp-v3.0.0
[breaking] remove deprecated v3 APIs
accept namespaced discovery server information
[breaking] reject missing issuer in authorization server metadata by default
expose oauth discovery metadata source
route SEP-2260 associated server requests to the originating SSE stream
StreamableHttpServerConfig::stateful_mode to legacy_session_mode (and the builder with_stateful_mode to with_legacy_session_mode) to clarify that the option only affects legacy protocol versions (< 2026-07-28); per SEP-2567 the 2026-07-28 draft version is always served statelessly (#999)private_key_jwt audiencereject auth servers lacking S256 PKCE support
add SEP-414 trace context meta accessors
deprecate roots/sampling/logging types
Migration guide: https://github.com/modelcontextprotocol/rust-sdk/discussions/926
update peer info on duplicate initialize (#862) — ⚠️ breaking: changes the Peer::peer_info() signature, see Breaking Changes above
[!WARNING]
⚠️ Breaking Changes
Despite being a minor version bump, this release contains a source-breaking API change (it should have been
2.0.0). If you depend onrmcp = "1.7", Cargo will resolve to1.8.0automatically and your build may fail. Pin to=1.7.xif you are not ready to migrate.
Peer::peer_info()return type changed (#862):- pub fn peer_info(&self) -> Option<&R::PeerInfo> + pub fn peer_info(&self) -> Option<Arc<R::PeerInfo>>This was needed so peer info can be re-set on a duplicate
initialize(it now lives behind anRwLock), which is why a borrow can no longer be returned.Migration: field access still works through
Arc'sDeref. If you need the old&InitializeResult(e.g. you bound the type explicitly), use.as_deref():// Before (1.7.x): info is &InitializeResult let info: Option<&InitializeResult> = client.peer_info(); // After (1.8.0): info is Arc<InitializeResult> let info: Option<Arc<InitializeResult>> = client.peer_info(); // To recover the old reference type: let info: Option<&InitializeResult> = client.peer_info().as_deref();
Peer::peer_info() signature, see Breaking Changes above*(rmcp)* flatten Resource variant of PromptMessageContent
*(http)* log Host/Origin rejections
*(transport)* add constructors for non_exhaustive error types
add Default and constructors to ServerSseMessage
*(transport)* add Unix domain socket client for streamable HTTP
add missing constructors for non-exhaustive model types
accept logging/setLevel and ping before initialized notification
implement OAuth 2.0 Client Credentials flow
*(auth)* pass WWW-Authenticate scopes to DCR registration request
*(auth)* [breaking] support returning extra fields from token exchange
*(streamable-http)* add json_response option for stateless server mode
add support for custom HTTP headers in StreamableHttpClient
*(elicitation)* add support URL elicitation. SEP-1036
execution.taskSupport on tools (#635)*(tasks)* #626 model task capabilities correctly
provide blanket implementations for ClientHandler and ServerHandler traits
add support for custom requests
*(meta)* add _meta field to prompts, resources and paginated result
add support for custom client notifications
*(streamable-http)* support both SSE and JSON response formats
*(auth)* implement CredentialStore trait
*(oauth)* respect oauth-protected-resource discovery
*(oauth)* fix oauth credential refresh
accept 204 in addition to 202 on initialize
add type-safe elicitation schema support
*(oauth)* pass bearer token to all streamable http requests
allow clients to override client_name
*(oauth)* do not treat empty secret as valid for public clients
*(SEP-973)* add support for icons and websiteUrl across relevant types
title field for data types (#410)change JSON-RPC request ID type from u32 to i64
*(rmcp)* add optional _meta to CallToolResult, EmbeddedResource, and ResourceContents
*(rmcp)* add authorization header support for the streamable http client
keep internal error in worker's quit reason
correct numeric types in progress notifications
*(rmcp)* allow both content and structured content
One column per month.