> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mcp-use.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Version 1.3.13

> Package reorganization and improved module structure

<Card img="https://mcp-use.com/api/og/release?v=1.3.13" title="Release 1.3.13" href="https://github.com/mcp-use/mcp-use/releases/tag/python-v1.3.13">
  This release focuses on **package reorganization** to provide clearer module structure and better separation of concerns.
</Card>

This release focuses on package reorganization to provide clearer module structure and better separation of concerns. The library has been restructured into logical namespaces for improved discoverability and maintainability.

## Bug Fixes

### LangChain Version Compatibility

Fixed compatibility issues caused by LangChain's 1.0.0 release. The library is temporarily pinned to LangChain 0.3.27 to prevent breaking changes. Migration to LangChain 1.0.0 is planned for a future release.

## Package Reorganization

The package has been reorganized into clearer, more intuitive modules:

* **`mcp_use.client.*`** - Client-related functionality
  * `mcp_use.client.auth` - Authentication mechanisms (OAuth, Bearer)
  * `mcp_use.client.connectors` - Connection transports (HTTP, WebSocket, Stdio, Sandbox)
  * `mcp_use.client.middleware` - Request/response middleware
  * `mcp_use.client.task_managers` - Connection task managers

* **`mcp_use.agents.*`** - Agent-related functionality
  * `mcp_use.agents.adapters` - LLM framework adapters (LangChain, etc.)
  * `mcp_use.agents.managers` - Server management tools and utilities

This reorganization provides:

* Better code discoverability through logical namespacing
* Clear separation between client and agent concerns
* Improved maintainability and extensibility
* More intuitive import paths

## Deprecation Notices

<Warning>
  The following import paths are now deprecated and will be removed in future versions:
</Warning>

### Authentication

```python theme={null}
# Deprecated
from mcp_use.auth import BearerAuth, OAuth
from mcp_use.auth.oauth_callback import OAuthCallbackServer, CallbackResponse

# Use instead
from mcp_use.client.auth import BearerAuth, OAuth
from mcp_use.client.auth.oauth_callback import OAuthCallbackServer, CallbackResponse
```

### Middleware

```python theme={null}
# Deprecated
from mcp_use.middleware import Middleware, MiddlewareManager, MiddlewareContext
from mcp_use.middleware.metrics import MetricsMiddleware, PerformanceMetricsMiddleware, ErrorTrackingMiddleware, CombinedAnalyticsMiddleware

# Use instead
from mcp_use.client.middleware import Middleware, MiddlewareManager, MiddlewareContext
from mcp_use.client.middleware.metrics import MetricsMiddleware, PerformanceMetricsMiddleware, ErrorTrackingMiddleware, CombinedAnalyticsMiddleware
```

### Task Managers

```python theme={null}
# Deprecated
from mcp_use.task_managers import ConnectionManager, SseConnectionManager, StdioConnectionManager, StreamableHttpConnectionManager, WebSocketConnectionManager

# Use instead
from mcp_use.client.task_managers import ConnectionManager, SseConnectionManager, StdioConnectionManager, StreamableHttpConnectionManager, WebSocketConnectionManager
```

### Adapters

```python theme={null}
# Deprecated
from mcp_use.adapters import BaseAdapter, LangChainAdapter

# Use instead
from mcp_use.agents.adapters import BaseAdapter, LangChainAdapter
```

### Server Managers

```python theme={null}
# Deprecated
from mcp_use.managers import ServerManager, MCPServerTool, ConnectServerTool, DisconnectServerTool, GetActiveServerTool, ListServersTool, SearchToolsTool

# Use instead
from mcp_use.agents.managers import ServerManager, MCPServerTool, ConnectServerTool, DisconnectServerTool, GetActiveServerTool, ListServersTool, SearchToolsTool
```

### Exceptions

```python theme={null}
# Deprecated
from mcp_use.exceptions import MCPError, OAuthDiscoveryError, OAuthAuthenticationError, ConnectionError, ConfigurationError

# Use instead
from mcp_use.client.exceptions import MCPError, OAuthDiscoveryError, OAuthAuthenticationError, ConnectionError, ConfigurationError
```

### Types

```python theme={null}
# Deprecated
from mcp_use.types.sandbox import SandboxOptions

# Use instead
from mcp_use.client.connectors.sandbox import SandboxOptions
```

**Backward Compatibility:** All deprecated import paths continue to work in version 1.3.13 but will emit deprecation warnings. Please migrate to the new import paths before the next major release.

**Note:** Top-level imports like `from mcp_use import MCPAgent, MCPClient, MCPSession` remain supported and are NOT deprecated.

## Migration Guide

To migrate your code:

1. Replace old import paths with new ones as shown above
2. Run your tests to ensure everything works
3. The functionality remains identical - only the import paths have changed

The reorganization maintains full backward compatibility, so existing code will continue to work while you migrate to the new structure.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.