---
title: "Callbacks Manager"
description: "Observability callbacks manager for MCP-use API Documentation"
icon: "code"
github: "https://github.com/mcp-use/mcp-use/blob/main/libraries/python/mcp_use/agents/observability/callbacks_manager.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/agents/observability/callbacks_manager.py' target='_blank' rel='noopener noreferrer'>https://github.com/mcp-use/mcp-use/blob/main/libraries/python/mcp_use/agents/observability/callbacks_manager.py</a>
</Callout>

Observability callbacks manager for MCP-use.

This module provides a centralized manager for handling observability callbacks
from various platforms (Langfuse, Laminar, etc.) in a clean and extensible way.

## ObservabilityManager

<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> ObservabilityManager</div>

Manages observability callbacks for MCP agents.

    This class provides a centralized way to collect and manage callbacks
    from various observability platforms (Langfuse, Laminar, etc.).

</div>
</RandomGradientBackground>
```python
from mcp_use.agents.observability.callbacks_manager import ObservabilityManager
```

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

Initialize the ObservabilityManager.


**Parameters**
><ParamField body="custom_callbacks" type="list | None" default="None" >   Optional list of custom callbacks to use instead of defaults. </ParamField>

**Signature**
```python wrap
def __init__(custom_callbacks: list | None = None):
```

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

Add a callback to the custom callbacks list.



**Parameters**
><ParamField body="callback" required="True" >   The callback to add. </ParamField>

**Signature**
```python wrap
def add_callback(callback):
```

</Card>

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

Clear all custom callbacks.


**Signature**
```python wrap
def clear_callbacks():
```

</Card>

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

Get the list of callbacks to use.



**Returns**
><ResponseField name="returns" type="list" >List of callbacks - either custom callbacks if provided, or all available observability handlers.</ResponseField>

**Signature**
```python wrap
def get_callbacks():
```

</Card>

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

Get the names of available handlers.



**Returns**
><ResponseField name="returns" type="list[str]" >List of handler names (e.g., [&quot;Langfuse&quot;, &quot;Laminar&quot;])</ResponseField>

**Signature**
```python wrap
def get_handler_names():
```

</Card>

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

Check if any callbacks are available.



**Returns**
><ResponseField name="returns" type="bool" >True if callbacks are available, False otherwise.</ResponseField>

**Signature**
```python wrap
def has_callbacks():
```

</Card>

</div>


## create_manager
<Card type="info">
### `function` create_manager

Create a new ObservabilityManager instance.


```python
from mcp_use.agents.observability.callbacks_manager import create_manager
```

**Parameters**
><ParamField body="custom_callbacks" type="list | None" default="None" >   Optional list of custom callbacks. </ParamField>

**Returns**
><ResponseField name="returns" type="mcp_use.agents.observability.callbacks_manager.ObservabilityManager" >A new ObservabilityManager instance.</ResponseField>

**Signature**
```python wrap
def create_manager(custom_callbacks: list | None = None):
```

</Card>


## get_default_manager
<Card type="info">
### `function` get_default_manager

Get the default ObservabilityManager instance.


```python
from mcp_use.agents.observability.callbacks_manager import get_default_manager
```

**Returns**
><ResponseField name="returns" type="mcp_use.agents.observability.callbacks_manager.ObservabilityManager" >The default ObservabilityManager instance (singleton).</ResponseField>

**Signature**
```python wrap
def get_default_manager():
```

</Card>
