class RemoteAgent
Agent that executes remotely via API.
```python theme={null}
from mcp_use.agents.remote import RemoteAgent
```
### `method` **init**
Initialize remote agent.
**Parameters**
> The ID of the remote agent to execute
> The ID of the chat session to use. If None, a new chat session will be created.
> API key for authentication. If None, will check MCP\_USE\_API\_KEY env var
> Base URL for the remote API
**Signature**
```python wrap theme={null}
def __init__(agent_id: str, chat_id: str | None = None, api_key: str | None = None, base_url: str = "https://cloud.mcp-use.com"):
```
### `method` close
Close the HTTP client.
**Signature**
```python wrap theme={null}
def close():
```
### `method` run
Executes the agent and returns the final result.
This method uses HTTP streaming to avoid timeouts for long-running tasks.
It consumes the entire stream and returns only the final result.
**Parameters**
> Query string or input
> Integer value
> List of items
> Parameter value
**Returns**
>
**Signature**
```python wrap theme={null}
def run(
query: str,
max_steps: int | None = None,
external_history: list[langchain_core.messages.base.BaseMessage] | None = None,
output_schema: type[~T] | None = None
):
```
### `method` stream
Stream the execution of a query on the remote agent using HTTP streaming.
**Parameters**
> Query string or input
> Integer value
> List of items
> Parameter value
**Returns**
>
**Signature**
```python wrap theme={null}
def stream(
query: str,
max_steps: int | None = None,
external_history: list[langchain_core.messages.base.BaseMessage] | None = None,
output_schema: type[~T] | None = None
):
```