MCP Python SDK 1.x → 2.xWhat was renamed or removed, and what to use instead
mcp 1.30.0 → 2.3.0
Every name and argument that went away in this migration, read from each release's own code, with what the library itself, its migration guide, or a move to another path says to use instead.
84renamed or replaced
37removed, no replacement stated
Renamed or replaced84
| Old | Use instead | Changed in | Evidence |
|---|---|---|---|
mcp. | mcp. | 2.0.0 | the project's migration guide: “ClientSession now exposes the negotiated server metadata as properties: server_capabilities, server_info, instructions, and protocol_version. [...] The get_server_capabilities() method has been removed. (https://github.com/model” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.CreateMessageResult lost stopReason and gained stop_reason in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.CreateMessageResultWithTools lost stopReason and gained stop_reason in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.Implementation lost websiteUrl and gained website_url in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.InitializeResult lost protocolVersion and gained protocol_version in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.InitializeResult lost serverInfo and gained server_info in the same release” |
mcp. | mcp. or mcp. | 2.0.0 | the project's migration guide: “The McpError exception class has been renamed to MCPError for consistent naming with the MCP acronym style used throughout the SDK. (https://github.com/modelcontextprotocol/python-sdk/blob/main/docs/migration.md#mcperror-renamed-to-mcpe” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.PromptsCapability lost listChanged and gained list_changed in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.Resource lost mimeType and gained mime_type in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.ResourcesCapability lost listChanged and gained list_changed in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.RootsCapability lost listChanged and gained list_changed in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.Tool lost inputSchema and gained input_schema in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.Tool lost outputSchema and gained output_schema in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.ToolResultContent lost isError and gained is_error in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.ToolResultContent lost structuredContent and gained structured_content in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.ToolResultContent lost toolUseId and gained tool_use_id in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.ToolsCapability lost listChanged and gained list_changed in the same release” |
mcp. | mcp. | 2.0.0 | the library's deprecation text: “RFC7523OAuthClientProvider is deprecated. Use ClientCredentialsOAuthProvider or PrivateKeyJWTOAuthProvider instead.” |
mcp. | mcp. or mcp. | 2.0.0 | the library's deprecation text: “RFC7523OAuthClientProvider is deprecated. Use ClientCredentialsOAuthProvider or PrivateKeyJWTOAuthProvider instead.” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.client.stdio.FallbackProcess was removed in 2.0.0; the same object is still public as mcp.os.win32.utilities.FallbackProcess” |
mcp. | mcp. | 2.0.0 | the project's migration guide: “| ClientRequestType, ClientNotificationType, ClientResultType, ServerRequestType, ServerNotificationType, ServerResultType | The union is now the bare name: ClientRequest, ClientNotification, ClientResult, ServerRequest,” |
mcp. | mcp. | 2.0.0 | the project's migration guide: “The following type aliases and classes have been removed from the protocol types (mcp.types / mcp_types): [...] | Content | ContentBlock | (https://github.com/modelcontextprotocol/python-sdk/blob/main/docs/migration.md#removed-type-” |
mcp. | mcp. | 2.0.0 | the project's migration guide: “The following type aliases and classes have been removed from the protocol types (mcp.types / mcp_types): [...] | ResourceReference | ResourceTemplateReference | (https://github.com/modelcontextprotocol/python-sdk/blob/main/docs/mig” |
mcp. | mcp. | 2.0.0 | the project's migration guide: “| ClientRequestType, ClientNotificationType, ClientResultType, ServerRequestType, ServerNotificationType, ServerResultType | The union is now the bare name: ClientRequest, ClientNotification, ClientResult, ServerRequest,” |
mcp. | mcp. | 2.0.0 | the project's migration guide: “| ClientRequestType, ClientNotificationType, ClientResultType, ServerRequestType, ServerNotificationType, ServerResultType | The union is now the bare name: ClientRequest, ClientNotification, ClientResult, ServerRequest,” |
mcp. | mcp. | 2.0.0 | the library's deprecation text: “Use streamable_http_client instead.” |
mcp. | mcp. | 2.0.0 | the project's migration guide: “The FastMCP class has been renamed to MCPServer to better reflect its role as the main server class in the SDK. (https://github.com/modelcontextprotocol/python-sdk/blob/main/docs/migration.md#fastmcp-renamed-to-mcpserver)” |
mcp. | mcp. | 2.0.0 | the project's migration guide: “The FastMCP class has been renamed to MCPServer to better reflect its role as the main server class in the SDK. (https://github.com/modelcontextprotocol/python-sdk/blob/main/docs/migration.md#fastmcp-renamed-to-mcpserver)” |
mcp. | mcp. | 2.0.0 | the project's migration guide: “The FastMCP class has been renamed to MCPServer to better reflect its role as the main server class in the SDK. (https://github.com/modelcontextprotocol/python-sdk/blob/main/docs/migration.md#fastmcp-renamed-to-mcpserver)” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.shared.exceptions lost McpError and gained MCPError in the same release” |
mcp. | mcp. | 2.0.0 | the project's migration guide: “The create_connected_server_and_client_session helper in mcp.shared.memory has been removed. Use mcp.client.Client instead — it accepts a Server or MCPServer instance directly and handles the in-memory transport and session setup ” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.AudioContent lost mimeType and gained mime_type in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.CallToolResult lost isError and gained is_error in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.CallToolResult lost structuredContent and gained structured_content in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.CancelTaskRequestParams lost taskId and gained task_id in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.CancelledNotificationParams lost requestId and gained request_id in the same release” |
mcp. | mcp. | 2.0.0 | the project's migration guide: “| ClientRequestType, ClientNotificationType, ClientResultType, ServerRequestType, ServerNotificationType, ServerResultType | The union is now the bare name: ClientRequest, ClientNotification, ClientResult, ServerRequest,” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.Completion lost hasMore and gained has_more in the same release” |
mcp. | mcp. | 2.0.0 | the project's migration guide: “The following type aliases and classes have been removed from the protocol types (mcp.types / mcp_types): [...] | Content | ContentBlock | (https://github.com/modelcontextprotocol/python-sdk/blob/main/docs/migration.md#removed-type-” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.CreateMessageRequestParams lost includeContext and gained include_context in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.CreateMessageRequestParams lost maxTokens and gained max_tokens in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.CreateMessageRequestParams lost modelPreferences and gained model_preferences in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.CreateMessageRequestParams lost stopSequences and gained stop_sequences in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.CreateMessageRequestParams lost systemPrompt and gained system_prompt in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.CreateMessageRequestParams lost toolChoice and gained tool_choice in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.ElicitCompleteNotificationParams lost elicitationId and gained elicitation_id in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.ElicitRequestFormParams lost requestedSchema and gained requested_schema in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.ElicitRequestURLParams lost elicitationId and gained elicitation_id in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.GetTaskPayloadRequestParams lost taskId and gained task_id in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.GetTaskRequestParams lost taskId and gained task_id in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.Icon lost mimeType and gained mime_type in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.ImageContent lost mimeType and gained mime_type in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.InitializeRequestParams lost clientInfo and gained client_info in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.InitializeRequestParams lost protocolVersion and gained protocol_version in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.ListResourceTemplatesResult lost resourceTemplates and gained resource_templates in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.ModelPreferences lost costPriority and gained cost_priority in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.ModelPreferences lost intelligencePriority and gained intelligence_priority in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.ModelPreferences lost speedPriority and gained speed_priority in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.PaginatedResult lost nextCursor and gained next_cursor in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.ProgressNotificationParams lost progressToken and gained progress_token in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.RelatedTaskMetadata lost taskId and gained task_id in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.ResourceContents lost mimeType and gained mime_type in the same release” |
mcp. | mcp. | 2.0.0 | the project's migration guide: “The following type aliases and classes have been removed from the protocol types (mcp.types / mcp_types): [...] | ResourceReference | ResourceTemplateReference | (https://github.com/modelcontextprotocol/python-sdk/blob/main/docs/mig” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.ResourceTemplate lost mimeType and gained mime_type in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.ResourceTemplate lost uriTemplate and gained uri_template in the same release” |
mcp. | mcp. | 2.0.0 | the project's migration guide: “| ClientRequestType, ClientNotificationType, ClientResultType, ServerRequestType, ServerNotificationType, ServerResultType | The union is now the bare name: ClientRequest, ClientNotification, ClientResult, ServerRequest,” |
mcp. | mcp. | 2.0.0 | the project's migration guide: “| ClientRequestType, ClientNotificationType, ClientResultType, ServerRequestType, ServerNotificationType, ServerResultType | The union is now the bare name: ClientRequest, ClientNotification, ClientResult, ServerRequest,” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.Task lost createdAt and gained created_at in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.Task lost lastUpdatedAt and gained last_updated_at in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.Task lost pollInterval and gained poll_interval in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.Task lost statusMessage and gained status_message in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.Task lost taskId and gained task_id in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.TasksSamplingCapability lost createMessage and gained create_message in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.ToolAnnotations lost destructiveHint and gained destructive_hint in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.ToolAnnotations lost idempotentHint and gained idempotent_hint in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.ToolAnnotations lost openWorldHint and gained open_world_hint in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.ToolAnnotations lost readOnlyHint and gained read_only_hint in the same release” |
mcp. | mcp. | 2.0.0 | the same object at another path: “mcp.types.ToolExecution lost taskSupport and gained task_support in the same release” |
mcp. | requested_schema | 2.0.0 | the same object at another path: “mcp.ServerSession.elicit lost the parameter requestedSchema and gained requested_schema in the same release” |
mcp. | requested_schema | 2.0.0 | the same object at another path: “mcp.ServerSession.elicit_form lost the parameter requestedSchema and gained requested_schema in the same release” |
mcp. | mcp. | 2.0.0 | the library's deprecation text: “resources/subscribe is removed as of 2026-07-28; use Client.listen() instead.” |
mcp. | mcp. | 2.0.0 | the library's deprecation text: “resources/unsubscribe is removed as of 2026-07-28; use Client.listen() instead.” |
mcp. | mcp. | 2.0.0 | the library's deprecation text: “resources/subscribe is removed as of 2026-07-28; use Client.listen() instead.” |
mcp. | mcp. | 2.0.0 | the library's deprecation text: “resources/unsubscribe is removed as of 2026-07-28; use Client.listen() instead.” |
Removed, with no replacement stated37
| Old | Gone in |
|---|---|
mcp. | 2.0.0 |
mcp. | 2.0.0 |
mcp. | 2.0.0 |
mcp. | 2.0.0 |
mcp. | 2.0.0 |
mcp. | 2.0.0 |
mcp. | 2.0.0 |
mcp. | 2.0.0 |
mcp. | 2.0.0 |
mcp. | 2.0.0 |
mcp. | 2.0.0 |
mcp. | 2.0.0 |
mcp. | 2.0.0 |
mcp. | 2.0.0 |
mcp. | 2.0.0 |
mcp. | 2.0.0 |
mcp. | 2.0.0 |
mcp. | 2.0.0 |
mcp. | 2.0.0 |
mcp. | 2.0.0 |
mcp. | 2.0.0 |
mcp. | 2.0.0 |
mcp. | 2.0.0 |
mcp. | 2.0.0 |
mcp. | 2.0.0 |
mcp. | 2.0.0 |
mcp. | 2.0.0 |
mcp. | 2.0.0 |
mcp. | 2.0.0 |
mcp. | 2.0.0 |
mcp. | 2.0.0 |
mcp. | 2.0.0 |
mcp. | 2.0.0 |
mcp. | 2.0.0 |
mcp. | 2.0.0 |
mcp. | 2.0.0 |
mcp. | 2.0.0 |
No names match.