Skip to main content
View the source code for this module on GitHub: https://github.com/mcp-use/mcp-use/blob/main/libraries/python/mcp_use/agents/observability/callbacks_manager.py
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

from mcp_use.agents.observability.callbacks_manager import ObservabilityManager

​
method init

Initialize the ObservabilityManager.Parameters
​
custom_callbacks
list | None
default:"None"
Optional list of custom callbacks to use instead of defaults.
Signature
def __init__(custom_callbacks: list | None = None):

​
method add_callback

Add a callback to the custom callbacks list.Parameters
​
callback
required
The callback to add.
Signature
def add_callback(callback):

​
method clear_callbacks

Clear all custom callbacks.Signature
def clear_callbacks():

​
method get_callbacks

Get the list of callbacks to use.Returns
​
returns
list
List of callbacks - either custom callbacks if provided, or all available observability handlers.
Signature
def get_callbacks():

​
method get_handler_names

Get the names of available handlers.Returns
​
returns
list[str]
List of handler names (e.g., [“Langfuse”, “Laminar”])
Signature
def get_handler_names():

​
method has_callbacks

Check if any callbacks are available.Returns
​
returns
bool
True if callbacks are available, False otherwise.
Signature
def has_callbacks():

​
create_manager

​
function create_manager

Create a new ObservabilityManager instance.
from mcp_use.agents.observability.callbacks_manager import create_manager
Parameters
​
custom_callbacks
list | None
default:"None"
Optional list of custom callbacks.
Returns
​
returns
mcp_use.agents.observability.callbacks_manager.ObservabilityManager
A new ObservabilityManager instance.
Signature
def create_manager(custom_callbacks: list | None = None):

​
get_default_manager

​
function get_default_manager

Get the default ObservabilityManager instance.
from mcp_use.agents.observability.callbacks_manager import get_default_manager
Returns
​
returns
mcp_use.agents.observability.callbacks_manager.ObservabilityManager
The default ObservabilityManager instance (singleton).
Signature
def get_default_manager():