Base class for MCP connectors.
This class defines the interface that all MCP connectors must implement.
```python theme={null}
from mcp_use.client.connectors.base import BaseConnector
```
### `method` **init**
Initialize base connector with common attributes.
**Parameters**
> Optional callback to handle sampling requests from servers.
> Optional callback to handle elicitation requests from servers.
> Optional callback to handle messages from servers.
> Optional callback to handle log messages from servers.
> Optional list of middleware to apply to requests.
> Optional initial list of roots to advertise to the server.
> Optional custom callback to handle roots/list requests.
**Signature**
```python wrap theme={null}
def __init__(sampling_callback: mcp.client.session.SamplingFnT | None = None, elicitation_callback: mcp.client.session.ElicitationFnT | None = None, message_handler: mcp.client.session.MessageHandlerFnT | None = None, logging_callback: mcp.client.session.LoggingFnT | None = None, middleware: list[mcp_use.client.middleware.middleware.Middleware] | None = None, roots: list[mcp.types.Root] | None = None, list_roots_callback: mcp.client.session.ListRootsFnT | None = None):
```
### `method` call\_tool
Call an MCP tool with automatic reconnection handling.
**Parameters**
> The name of the tool to call.
> The arguments to pass to the tool.
> timeout seconds when calling tool
**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
):
```
### `property` client\_info
Get the client info for the connector.
**Returns**
>
**Signature**
```python wrap theme={null}
def client_info():
```
### `method` connect
Establish a connection to the MCP implementation.
**Signature**
```python wrap theme={null}
def connect():
```
### `method` disconnect
Close the connection to the MCP implementation.
**Signature**
```python wrap theme={null}
def disconnect():
```
### `method` get\_prompt
Get a prompt by name.
**Parameters**
> Name identifier
> Dictionary of key-value pairs
**Returns**
>
**Signature**
```python wrap theme={null}
def get_prompt(name: str, arguments: dict[str, typing.Any] | None = None):
```
### `method` get\_roots
Get the current list of roots.
**Returns**
> A copy of the current roots list.
**Signature**
```python wrap theme={null}
def get_roots():
```
### `method` initialize
Initialize the MCP session and return session information.
**Returns**
>
**Signature**
```python wrap theme={null}
def initialize():
```
### `property` is\_connected
Check if the connector is actually connected and the connection is alive.
This property checks not only the connected flag but also verifies that
the underlying connection manager and streams are still active.
**Returns**
>
**Signature**
```python wrap theme={null}
def is_connected():
```
### `method` list\_prompts
List all available prompts from the MCP implementation.
**Returns**
>
**Signature**
```python wrap theme={null}
def list_prompts():
```
### `method` list\_resources
List all available resources from the MCP implementation.
**Returns**
>
**Signature**
```python wrap theme={null}
def list_resources():
```
### `property` list\_roots\_callback
Get the list\_roots\_callback to pass to ClientSession.
This always returns a callback to ensure the roots capability is advertised.
**Returns**
>
**Signature**
```python wrap theme={null}
def list_roots_callback():
```
### `method` list\_tools
List all available tools from the MCP implementation.
**Returns**
>
**Signature**
```python wrap theme={null}
def list_tools():
```
### `property` prompts
Get the list of available prompts.
.. deprecated::
This property is deprecated because it may return stale data when the server
sends list change notifications. Use \`await list\_prompts()' instead to ensure
you always get the latest data.
**Returns**
>
**Signature**
```python wrap theme={null}
def prompts():
```
### `property` public\_identifier
Get the identifier for the connector.
**Returns**
>
**Signature**
```python wrap theme={null}
def public_identifier():
```
### `method` read\_resource
Read a resource by URI.
**Parameters**
> Parameter value
**Returns**
>
**Signature**
```python wrap theme={null}
def read_resource(uri: pydantic.networks.AnyUrl):
```
### `property` resources
Get the list of available resources.
.. deprecated::
This property is deprecated because it may return stale data when the server
sends list change notifications. Use `await list_resources()` instead to ensure
you always get the latest data.
**Returns**
>
**Signature**
```python wrap theme={null}
def resources():
```
### `method` set\_roots
Set the roots and notify the server if connected.
Roots represent directories or files that the client has access to.
Example:
```python theme={null}
await connector.set_roots([
Root(uri="file:///home/user/project", name="My Project"),
Root(uri="file:///home/user/data"),
])
```
**Parameters**
> Array of Root objects with `uri` (must start with "file://") and optional `name`.
**Signature**
```python wrap theme={null}
def set_roots(roots: list[mcp.types.Root]):
```
### `property` tools
Get the list of available tools.
.. deprecated::
This property is deprecated because it may return stale data when the server
sends list change notifications. Use `await list_tools()` instead to ensure
you always get the latest data.
**Returns**
>
**Signature**
```python wrap theme={null}
def tools():
```