DepTime

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

OldUse insteadChanged inEvidence
mcp.ClientSession.get_server_capabilitiesmcp.ClientSession.server_capabilities2.0.0the 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.CreateMessageResult.stopReasonmcp.CreateMessageResult.stop_reason2.0.0the same object at another path: “mcp.CreateMessageResult lost stopReason and gained stop_reason in the same release”
mcp.CreateMessageResultWithTools.stopReasonmcp.CreateMessageResultWithTools.stop_reason2.0.0the same object at another path: “mcp.CreateMessageResultWithTools lost stopReason and gained stop_reason in the same release”
mcp.Implementation.websiteUrlmcp.Implementation.website_url2.0.0the same object at another path: “mcp.Implementation lost websiteUrl and gained website_url in the same release”
mcp.InitializeResult.protocolVersionmcp.InitializeResult.protocol_version2.0.0the same object at another path: “mcp.InitializeResult lost protocolVersion and gained protocol_version in the same release”
mcp.InitializeResult.serverInfomcp.InitializeResult.server_info2.0.0the same object at another path: “mcp.InitializeResult lost serverInfo and gained server_info in the same release”
mcp.McpErrormcp.shared.exceptions.MCPError or mcp.MCPError2.0.0the 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.PromptsCapability.listChangedmcp.PromptsCapability.list_changed2.0.0the same object at another path: “mcp.PromptsCapability lost listChanged and gained list_changed in the same release”
mcp.Resource.mimeTypemcp.Resource.mime_type2.0.0the same object at another path: “mcp.Resource lost mimeType and gained mime_type in the same release”
mcp.ResourcesCapability.listChangedmcp.ResourcesCapability.list_changed2.0.0the same object at another path: “mcp.ResourcesCapability lost listChanged and gained list_changed in the same release”
mcp.RootsCapability.listChangedmcp.RootsCapability.list_changed2.0.0the same object at another path: “mcp.RootsCapability lost listChanged and gained list_changed in the same release”
mcp.Tool.inputSchemamcp.Tool.input_schema2.0.0the same object at another path: “mcp.Tool lost inputSchema and gained input_schema in the same release”
mcp.Tool.outputSchemamcp.Tool.output_schema2.0.0the same object at another path: “mcp.Tool lost outputSchema and gained output_schema in the same release”
mcp.ToolResultContent.isErrormcp.ToolResultContent.is_error2.0.0the same object at another path: “mcp.ToolResultContent lost isError and gained is_error in the same release”
mcp.ToolResultContent.structuredContentmcp.ToolResultContent.structured_content2.0.0the same object at another path: “mcp.ToolResultContent lost structuredContent and gained structured_content in the same release”
mcp.ToolResultContent.toolUseIdmcp.ToolResultContent.tool_use_id2.0.0the same object at another path: “mcp.ToolResultContent lost toolUseId and gained tool_use_id in the same release”
mcp.ToolsCapability.listChangedmcp.ToolsCapability.list_changed2.0.0the same object at another path: “mcp.ToolsCapability lost listChanged and gained list_changed in the same release”
mcp.client.auth.extensions.client_credentials.RFC7523OAuthClientProvidermcp.client.auth.extensions.client_credentials.PrivateKeyJWTOAuthProvider2.0.0the library's deprecation text: “RFC7523OAuthClientProvider is deprecated. Use ClientCredentialsOAuthProvider or PrivateKeyJWTOAuthProvider instead.”
mcp.client.auth.extensions.client_credentials.RFC7523OAuthClientProvider.__init__mcp.client.auth.extensions.client_credentials.ClientCredentialsOAuthProvider or mcp.client.auth.extensions.client_credentials.PrivateKeyJWTOAuthProvider2.0.0the library's deprecation text: “RFC7523OAuthClientProvider is deprecated. Use ClientCredentialsOAuthProvider or PrivateKeyJWTOAuthProvider instead.”
mcp.client.stdio.FallbackProcessmcp.os.win32.utilities.FallbackProcess2.0.0the 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.client.stdio.types.ClientRequestTypemcp.types.ClientRequest2.0.0the project's migration guide: “| ClientRequestType, ClientNotificationType, ClientResultType, ServerRequestType, ServerNotificationType, ServerResultType | The union is now the bare name: ClientRequest, ClientNotification, ClientResult, ServerRequest,”
mcp.client.stdio.types.Contentmcp.types.ContentBlock2.0.0the 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.client.stdio.types.ResourceReferencemcp.types.ResourceTemplateReference2.0.0the 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.client.stdio.types.ServerNotificationTypemcp.types.ServerNotification2.0.0the project's migration guide: “| ClientRequestType, ClientNotificationType, ClientResultType, ServerRequestType, ServerNotificationType, ServerResultType | The union is now the bare name: ClientRequest, ClientNotification, ClientResult, ServerRequest,”
mcp.client.stdio.types.ServerResultTypemcp.types.ServerResult2.0.0the project's migration guide: “| ClientRequestType, ClientNotificationType, ClientResultType, ServerRequestType, ServerNotificationType, ServerResultType | The union is now the bare name: ClientRequest, ClientNotification, ClientResult, ServerRequest,”
mcp.client.streamable_http.streamablehttp_clientmcp.client.streamable_http.streamable_http_client2.0.0the library's deprecation text: “Use streamable_http_client instead.”
mcp.server.FastMCPmcp.server.mcpserver.MCPServer2.0.0the 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.server.fastmcp.FastMCPmcp.server.mcpserver.MCPServer2.0.0the 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.server.fastmcp.server.FastMCPmcp.server.mcpserver.MCPServer2.0.0the 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.shared.exceptions.McpErrormcp.shared.exceptions.MCPError2.0.0the same object at another path: “mcp.shared.exceptions lost McpError and gained MCPError in the same release”
mcp.shared.memory.create_connected_server_and_client_sessionmcp.client.Client2.0.0the 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.types.AudioContent.mimeTypemcp.types.AudioContent.mime_type2.0.0the same object at another path: “mcp.types.AudioContent lost mimeType and gained mime_type in the same release”
mcp.types.CallToolResult.isErrormcp.types.CallToolResult.is_error2.0.0the same object at another path: “mcp.types.CallToolResult lost isError and gained is_error in the same release”
mcp.types.CallToolResult.structuredContentmcp.types.CallToolResult.structured_content2.0.0the same object at another path: “mcp.types.CallToolResult lost structuredContent and gained structured_content in the same release”
mcp.types.CancelTaskRequestParams.taskIdmcp.types.CancelTaskRequestParams.task_id2.0.0the same object at another path: “mcp.types.CancelTaskRequestParams lost taskId and gained task_id in the same release”
mcp.types.CancelledNotificationParams.requestIdmcp.types.CancelledNotificationParams.request_id2.0.0the same object at another path: “mcp.types.CancelledNotificationParams lost requestId and gained request_id in the same release”
mcp.types.ClientRequestTypemcp.types.ClientRequest2.0.0the project's migration guide: “| ClientRequestType, ClientNotificationType, ClientResultType, ServerRequestType, ServerNotificationType, ServerResultType | The union is now the bare name: ClientRequest, ClientNotification, ClientResult, ServerRequest,”
mcp.types.Completion.hasMoremcp.types.Completion.has_more2.0.0the same object at another path: “mcp.types.Completion lost hasMore and gained has_more in the same release”
mcp.types.Contentmcp.types.ContentBlock2.0.0the 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.types.CreateMessageRequestParams.includeContextmcp.types.CreateMessageRequestParams.include_context2.0.0the same object at another path: “mcp.types.CreateMessageRequestParams lost includeContext and gained include_context in the same release”
mcp.types.CreateMessageRequestParams.maxTokensmcp.types.CreateMessageRequestParams.max_tokens2.0.0the same object at another path: “mcp.types.CreateMessageRequestParams lost maxTokens and gained max_tokens in the same release”
mcp.types.CreateMessageRequestParams.modelPreferencesmcp.types.CreateMessageRequestParams.model_preferences2.0.0the same object at another path: “mcp.types.CreateMessageRequestParams lost modelPreferences and gained model_preferences in the same release”
mcp.types.CreateMessageRequestParams.stopSequencesmcp.types.CreateMessageRequestParams.stop_sequences2.0.0the same object at another path: “mcp.types.CreateMessageRequestParams lost stopSequences and gained stop_sequences in the same release”
mcp.types.CreateMessageRequestParams.systemPromptmcp.types.CreateMessageRequestParams.system_prompt2.0.0the same object at another path: “mcp.types.CreateMessageRequestParams lost systemPrompt and gained system_prompt in the same release”
mcp.types.CreateMessageRequestParams.toolChoicemcp.types.CreateMessageRequestParams.tool_choice2.0.0the same object at another path: “mcp.types.CreateMessageRequestParams lost toolChoice and gained tool_choice in the same release”
mcp.types.ElicitCompleteNotificationParams.elicitationIdmcp.types.ElicitCompleteNotificationParams.elicitation_id2.0.0the same object at another path: “mcp.types.ElicitCompleteNotificationParams lost elicitationId and gained elicitation_id in the same release”
mcp.types.ElicitRequestFormParams.requestedSchemamcp.types.ElicitRequestFormParams.requested_schema2.0.0the same object at another path: “mcp.types.ElicitRequestFormParams lost requestedSchema and gained requested_schema in the same release”
mcp.types.ElicitRequestURLParams.elicitationIdmcp.types.ElicitRequestURLParams.elicitation_id2.0.0the same object at another path: “mcp.types.ElicitRequestURLParams lost elicitationId and gained elicitation_id in the same release”
mcp.types.GetTaskPayloadRequestParams.taskIdmcp.types.GetTaskPayloadRequestParams.task_id2.0.0the same object at another path: “mcp.types.GetTaskPayloadRequestParams lost taskId and gained task_id in the same release”
mcp.types.GetTaskRequestParams.taskIdmcp.types.GetTaskRequestParams.task_id2.0.0the same object at another path: “mcp.types.GetTaskRequestParams lost taskId and gained task_id in the same release”
mcp.types.Icon.mimeTypemcp.types.Icon.mime_type2.0.0the same object at another path: “mcp.types.Icon lost mimeType and gained mime_type in the same release”
mcp.types.ImageContent.mimeTypemcp.types.ImageContent.mime_type2.0.0the same object at another path: “mcp.types.ImageContent lost mimeType and gained mime_type in the same release”
mcp.types.InitializeRequestParams.clientInfomcp.types.InitializeRequestParams.client_info2.0.0the same object at another path: “mcp.types.InitializeRequestParams lost clientInfo and gained client_info in the same release”
mcp.types.InitializeRequestParams.protocolVersionmcp.types.InitializeRequestParams.protocol_version2.0.0the same object at another path: “mcp.types.InitializeRequestParams lost protocolVersion and gained protocol_version in the same release”
mcp.types.ListResourceTemplatesResult.resourceTemplatesmcp.types.ListResourceTemplatesResult.resource_templates2.0.0the same object at another path: “mcp.types.ListResourceTemplatesResult lost resourceTemplates and gained resource_templates in the same release”
mcp.types.ModelPreferences.costPrioritymcp.types.ModelPreferences.cost_priority2.0.0the same object at another path: “mcp.types.ModelPreferences lost costPriority and gained cost_priority in the same release”
mcp.types.ModelPreferences.intelligencePrioritymcp.types.ModelPreferences.intelligence_priority2.0.0the same object at another path: “mcp.types.ModelPreferences lost intelligencePriority and gained intelligence_priority in the same release”
mcp.types.ModelPreferences.speedPrioritymcp.types.ModelPreferences.speed_priority2.0.0the same object at another path: “mcp.types.ModelPreferences lost speedPriority and gained speed_priority in the same release”
mcp.types.PaginatedResult.nextCursormcp.types.PaginatedResult.next_cursor2.0.0the same object at another path: “mcp.types.PaginatedResult lost nextCursor and gained next_cursor in the same release”
mcp.types.ProgressNotificationParams.progressTokenmcp.types.ProgressNotificationParams.progress_token2.0.0the same object at another path: “mcp.types.ProgressNotificationParams lost progressToken and gained progress_token in the same release”
mcp.types.RelatedTaskMetadata.taskIdmcp.types.RelatedTaskMetadata.task_id2.0.0the same object at another path: “mcp.types.RelatedTaskMetadata lost taskId and gained task_id in the same release”
mcp.types.ResourceContents.mimeTypemcp.types.ResourceContents.mime_type2.0.0the same object at another path: “mcp.types.ResourceContents lost mimeType and gained mime_type in the same release”
mcp.types.ResourceReferencemcp.types.ResourceTemplateReference2.0.0the 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.types.ResourceTemplate.mimeTypemcp.types.ResourceTemplate.mime_type2.0.0the same object at another path: “mcp.types.ResourceTemplate lost mimeType and gained mime_type in the same release”
mcp.types.ResourceTemplate.uriTemplatemcp.types.ResourceTemplate.uri_template2.0.0the same object at another path: “mcp.types.ResourceTemplate lost uriTemplate and gained uri_template in the same release”
mcp.types.ServerNotificationTypemcp.types.ServerNotification2.0.0the project's migration guide: “| ClientRequestType, ClientNotificationType, ClientResultType, ServerRequestType, ServerNotificationType, ServerResultType | The union is now the bare name: ClientRequest, ClientNotification, ClientResult, ServerRequest,”
mcp.types.ServerResultTypemcp.types.ServerResult2.0.0the project's migration guide: “| ClientRequestType, ClientNotificationType, ClientResultType, ServerRequestType, ServerNotificationType, ServerResultType | The union is now the bare name: ClientRequest, ClientNotification, ClientResult, ServerRequest,”
mcp.types.Task.createdAtmcp.types.Task.created_at2.0.0the same object at another path: “mcp.types.Task lost createdAt and gained created_at in the same release”
mcp.types.Task.lastUpdatedAtmcp.types.Task.last_updated_at2.0.0the same object at another path: “mcp.types.Task lost lastUpdatedAt and gained last_updated_at in the same release”
mcp.types.Task.pollIntervalmcp.types.Task.poll_interval2.0.0the same object at another path: “mcp.types.Task lost pollInterval and gained poll_interval in the same release”
mcp.types.Task.statusMessagemcp.types.Task.status_message2.0.0the same object at another path: “mcp.types.Task lost statusMessage and gained status_message in the same release”
mcp.types.Task.taskIdmcp.types.Task.task_id2.0.0the same object at another path: “mcp.types.Task lost taskId and gained task_id in the same release”
mcp.types.TasksSamplingCapability.createMessagemcp.types.TasksSamplingCapability.create_message2.0.0the same object at another path: “mcp.types.TasksSamplingCapability lost createMessage and gained create_message in the same release”
mcp.types.ToolAnnotations.destructiveHintmcp.types.ToolAnnotations.destructive_hint2.0.0the same object at another path: “mcp.types.ToolAnnotations lost destructiveHint and gained destructive_hint in the same release”
mcp.types.ToolAnnotations.idempotentHintmcp.types.ToolAnnotations.idempotent_hint2.0.0the same object at another path: “mcp.types.ToolAnnotations lost idempotentHint and gained idempotent_hint in the same release”
mcp.types.ToolAnnotations.openWorldHintmcp.types.ToolAnnotations.open_world_hint2.0.0the same object at another path: “mcp.types.ToolAnnotations lost openWorldHint and gained open_world_hint in the same release”
mcp.types.ToolAnnotations.readOnlyHintmcp.types.ToolAnnotations.read_only_hint2.0.0the same object at another path: “mcp.types.ToolAnnotations lost readOnlyHint and gained read_only_hint in the same release”
mcp.types.ToolExecution.taskSupportmcp.types.ToolExecution.task_support2.0.0the same object at another path: “mcp.types.ToolExecution lost taskSupport and gained task_support in the same release”
mcp.ServerSession.elicit(requestedSchema)requested_schema2.0.0the same object at another path: “mcp.ServerSession.elicit lost the parameter requestedSchema and gained requested_schema in the same release”
mcp.ServerSession.elicit_form(requestedSchema)requested_schema2.0.0the same object at another path: “mcp.ServerSession.elicit_form lost the parameter requestedSchema and gained requested_schema in the same release”
mcp.Client.subscribe_resourcemcp.Client.listen2.0.0the library's deprecation text: “resources/subscribe is removed as of 2026-07-28; use Client.listen() instead.”
mcp.Client.unsubscribe_resourcemcp.Client.listen2.0.0the library's deprecation text: “resources/unsubscribe is removed as of 2026-07-28; use Client.listen() instead.”
mcp.ClientSession.subscribe_resourcemcp.Client.listen2.0.0the library's deprecation text: “resources/subscribe is removed as of 2026-07-28; use Client.listen() instead.”
mcp.ClientSession.unsubscribe_resourcemcp.Client.listen2.0.0the library's deprecation text: “resources/unsubscribe is removed as of 2026-07-28; use Client.listen() instead.”

Removed, with no replacement stated37

OldGone in
mcp.ClientSession.experimental2.0.0
mcp.ErrorData.model_config2.0.0
mcp.JSONRPCError.model_config2.0.0
mcp.JSONRPCResponse.model_config2.0.0
mcp.McpError.__init__2.0.0
mcp.McpError.error2.0.0
mcp.ServerSession.experimental2.0.0
mcp.ServerSession.incoming_messages2.0.0
mcp.ServerSession.send_message2.0.0
mcp.client.__main__2.0.0
mcp.client.experimental2.0.0
mcp.client.websocket2.0.0
mcp.server.experimental2.0.0
mcp.server.fastmcp2.0.0
mcp.server.websocket2.0.0
mcp.shared.experimental2.0.0
mcp.shared.progress2.0.0
mcp.shared.response_router2.0.0
mcp.shared.session2.0.0
mcp.shared.version2.0.0
mcp.types.AnyFunction2.0.0
mcp.types.ClientNotificationType2.0.0
mcp.types.ClientResultType2.0.0
mcp.types.Cursor2.0.0
mcp.types.MethodT2.0.0
mcp.types.NotificationParamsT2.0.0
mcp.types.RequestParamsT2.0.0
mcp.types.ServerRequestType2.0.0
mcp.types.TASK_FORBIDDEN2.0.0
mcp.types.TASK_OPTIONAL2.0.0
mcp.types.TASK_REQUIRED2.0.0
mcp.types.TASK_STATUS_CANCELLED2.0.0
mcp.types.TASK_STATUS_COMPLETED2.0.0
mcp.types.TASK_STATUS_FAILED2.0.0
mcp.types.TASK_STATUS_INPUT_REQUIRED2.0.0
mcp.types.TASK_STATUS_WORKING2.0.0
mcp.types.TaskExecutionMode2.0.0

No names match.