Session manager for MCP connections.
This class manages the lifecycle of an MCP connection, including
authentication, initialization, and tool discovery.
```python theme={null}
from mcp_use.client.session import MCPSession
```
### `method` **init**
Initialize a new MCP session.
**Parameters**
> The connector to use for communicating with the MCP implementation.
> Whether to automatically connect to the MCP implementation.
**Signature**
```python wrap theme={null}
def __init__(connector: mcp_use.client.connectors.base.BaseConnector, auto_connect: bool = True):
```
### `method` call\_tool
Call an MCP tool.
**Parameters**
> The name of the tool to call.
> The arguments to pass to the tool.
> Optional timeout for the tool call.
**Returns**
> The result of the tool call.
**Signature**
```python wrap theme={null}
def call_tool(
name: str,
arguments: dict[str,
Any],
read_timeout_seconds: datetime.timedelta | None = None
):
```
### `method` connect
Connect to the MCP implementation.
**Signature**
```python wrap theme={null}
def connect():
```
### `method` disconnect
Disconnect from the MCP implementation.
**Signature**
```python wrap theme={null}
def disconnect():
```
### `method` get\_prompt
Get a prompt by name.
**Parameters**
> The name of the prompt to get.
> Optional arguments for the prompt.
**Returns**
> The prompt result with messages.
**Signature**
```python wrap theme={null}
def get_prompt(name: str, arguments: dict[str, typing.Any] | None = None):
```
### `method` initialize
Initialize the MCP session and discover available tools.
**Returns**
> The session information returned by the MCP implementation.
**Signature**
```python wrap theme={null}
def initialize():
```
### `property` is\_connected
Check if the connector is connected.
**Returns**
>
**Signature**
```python wrap theme={null}
def is_connected():
```
### `method` list\_prompts
List all available prompts from the MCP server.
**Returns**
> List of available prompts.
**Signature**
```python wrap theme={null}
def list_prompts():
```
### `method` list\_resources
List all available resources from the MCP server.
**Returns**
> List of available resources.
**Signature**
```python wrap theme={null}
def list_resources():
```
### `method` list\_tools
List all available tools from the MCP server.
**Returns**
> List of available tools.
**Signature**
```python wrap theme={null}
def list_tools():
```
### `method` read\_resource
Read a resource by URI.
**Parameters**
> The URI of the resource to read.
**Returns**
> The resource content.
**Signature**
```python wrap theme={null}
def read_resource(uri: pydantic.networks.AnyUrl):
```