​

MCPConnectionError

class MCPConnectionError(Exception):

​

MCPToolError

class MCPToolError(Exception):

​

ensure_strict_json_schema

def ensure_strict_json_schema(schema: dict[str, Any]):

​

_ensure_strict_json_schema

def _ensure_strict_json_schema(json_schema: object):

​

resolve_ref

def resolve_ref():

​

is_dict

def is_dict(obj: object):

​

is_list

def is_list(obj: object):

​

has_more_than_n_keys

def has_more_than_n_keys(obj: dict[str, object], n: int):

​

MCPToolkit

class MCPToolkit(BaseToolkit):

1. Using the async context manager (recommended):

​

Toolkit is connected here

​

Toolkit is automatically disconnected here

2. Using the factory method:

​

Toolkit is connected here

​

Don’t forget to disconnect when done!

3. Using explicit connect/disconnect:

​

Toolkit is connected here

​

Don’t forget to disconnect when done!

• clients (Optional[List[MCPClient]], optional): List of :obj:MCPClient instances to manage. (default: :obj:None)
• config_path (Optional[str], optional): Path to a JSON configuration file defining MCP servers. The file should contain server configurations in the standard MCP format. (default: :obj:None)
• config_dict (Optional[Dict[str, Any]], optional): Dictionary containing MCP server configurations in the same format as the config file. This allows for programmatic configuration without file I/O. (default: :obj:None)
• timeout (Optional[float], optional): Timeout for connection attempts in seconds. This timeout applies to individual client connections. (default: :obj:None)
• clients (List[MCPClient]): List of :obj:MCPClient instances being managed by this toolkit.

​

init

def __init__(
    self,
    clients: Optional[List[MCPClient]] = None,
    config_path: Optional[str] = None,
    config_dict: Optional[Dict[str, Any]] = None,
    timeout: Optional[float] = None
):

​

is_connected

def is_connected(self):

​

connect_sync

def connect_sync(self):

​

disconnect_sync

def disconnect_sync(self):

​

enter

def __enter__(self):

​

exit

def __exit__(
    self,
    exc_type,
    exc_val,
    exc_tb
):

​

create_sync

def create_sync(
    cls,
    clients: Optional[List[MCPClient]] = None,
    config_path: Optional[str] = None,
    config_dict: Optional[Dict[str, Any]] = None,
    timeout: Optional[float] = None
):

​

_load_clients_from_config

def _load_clients_from_config(self, config_path: str):

​

_load_clients_from_dict

def _load_clients_from_dict(self, config: Dict[str, Any]):

​

_create_client_from_config

def _create_client_from_config(self, name: str, cfg: Dict[str, Any]):

​

_ensure_strict_tool_schema

def _ensure_strict_tool_schema(self, tool: FunctionTool):

• Ensure parameters exist with at least an empty properties object (OpenAI requirement).
• Try converting parameters to strict using ensure_strict_json_schema.
• If conversion fails, mark function.strict = False and keep best-effort parameters.

​

get_tools

def get_tools(self):

​

get_text_tools

def get_text_tools(self):

​

call_tool_sync

def call_tool_sync(self, tool_name: str, tool_args: Dict[str, Any]):

​

list_available_tools

def list_available_tools(self):