---
title: "Websocket"
description: "WebSocket connector for MCP implementations API Documentation"
icon: "code"
github: "https://github.com/mcp-use/mcp-use/blob/main/libraries/python/mcp_use/client/connectors/websocket.py"
---

import {RandomGradientBackground} from "/snippets/gradient.jsx"

<Callout type="info" title="Source Code">
View the source code for this module on GitHub: <a href='https://github.com/mcp-use/mcp-use/blob/main/libraries/python/mcp_use/client/connectors/websocket.py' target='_blank' rel='noopener noreferrer'>https://github.com/mcp-use/mcp-use/blob/main/libraries/python/mcp_use/client/connectors/websocket.py</a>
</Callout>

WebSocket connector for MCP implementations.

This module provides a connector for communicating with MCP implementations
through WebSocket connections.

## WebSocketConnector

<div>
<RandomGradientBackground className="rounded-lg p-4 w-full h-full rounded-full">
<div className="text-black">
<div className="text-black font-bold text-xl mb-2 mt-8"><code className="!text-black">class</code> WebSocketConnector</div>

Connector for MCP implementations using WebSocket transport.

    This connector uses WebSockets to communicate with remote MCP implementations,
    using a connection manager to handle the proper lifecycle management.

</div>
</RandomGradientBackground>
```python
from mcp_use.client.connectors.websocket import WebSocketConnector
```

<Card type="info">
### `method` __init__

Initialize a new WebSocket connector.


**Parameters**
><ParamField body="url" type="str" required="True" >   The WebSocket URL to connect to. </ParamField>
><ParamField body="headers" type="dict[str, str] | None" default="None" >   Optional additional headers. </ParamField>
><ParamField body="auth" type="str | dict[str, typing.Any] | httpx.Auth | None" default="None" >   Authentication method - can be: </ParamField>

**Signature**
```python wrap
def __init__(url: str, headers: dict[str, str] | None = None, auth: str | dict[str, typing.Any] | httpx.Auth | None = None):
```

</Card>
<Card type="info">
### `method` request

Send a raw request to the MCP implementation.


**Parameters**
><ParamField body="method" type="str" required="True" >   String value </ParamField>
><ParamField body="params" type="dict[str, typing.Any] | None" default="None" >   Dictionary of key-value pairs </ParamField>

**Returns**
><ResponseField name="returns" type="Any" />

**Signature**
```python wrap
def request(method: str, params: dict[str, typing.Any] | None = None):
```

</Card>

</div>
