mcp-use 1.3.8__py3-none-any.whl → 1.3.9__py3-none-any.whl

mcp_use/__init__.py

@@ -25,7 +25,6 @@ __all__ = [
     "StdioConnector",
     "WebSocketConnector",
     "HttpConnector",
-    "create_session_from_config",
     "load_config_file",
     "logger",
     "MCP_USE_DEBUG",

mcp_use/adapters/base.py

@@ -91,14 +91,14 @@ class BaseAdapter(ABC):
 
         connector_tools = []
         # Now create tools for each MCP tool
-        for tool in connector.tools:
+        for tool in await connector.list_tools():
             # Convert the tool and add it to the list if conversion was successful
             converted_tool = self._convert_tool(tool, connector)
             if converted_tool:
                 connector_tools.append(converted_tool)
 
         # Convert resources to tools so that agents can access resource content directly
-        resources_list = connector.resources or []
+        resources_list = await connector.list_resources() or []
         if resources_list:
             for resource in resources_list:
                 converted_resource = self._convert_resource(resource, connector)
@@ -106,7 +106,7 @@ class BaseAdapter(ABC):
                     connector_tools.append(converted_resource)
 
         # Convert prompts to tools so that agents can retrieve prompt content
-        prompts_list = connector.prompts or []
+        prompts_list = await connector.list_prompts() or []
         if prompts_list:
             for prompt in prompts_list:
                 converted_prompt = self._convert_prompt(prompt, connector)

mcp_use/adapters/langchain_adapter.py

@@ -21,6 +21,7 @@ from mcp.types import (
 from pydantic import BaseModel, Field, create_model
 
 from ..connectors.base import BaseConnector
+from ..errors.error_formatting import format_error
 from ..logging import logger
 from .base import BaseAdapter
 
@@ -159,11 +160,11 @@ class LangChainAdapter(BaseAdapter):
                     except Exception as e:
                         # Log the exception for debugging
                         logger.error(f"Error parsing tool result: {e}")
-                        return f"Error parsing result: {e!s}; Raw content: {tool_result.content!r}"
+                        return format_error(e, tool=self.name, tool_content=tool_result.content)
 
                 except Exception as e:
                     if self.handle_tool_error:
-                        return f"Error executing MCP tool: {str(e)}"
+                        return format_error(e, tool=self.name)  # Format the error to make LLM understand it
                     raise
 
         return McpToLangChainAdapter()
@@ -204,7 +205,7 @@ class LangChainAdapter(BaseAdapter):
                     return content_decoded
                 except Exception as e:
                     if self.handle_tool_error:
-                        return f"Error reading resource: {str(e)}"
+                        return format_error(e, tool=self.name)  # Format the error to make LLM understand it
                     raise
 
         return ResourceTool()
@@ -261,7 +262,7 @@ class LangChainAdapter(BaseAdapter):
                     return result.messages
                 except Exception as e:
                     if self.handle_tool_error:
-                        return f"Error fetching prompt: {str(e)}"
+                        return format_error(e, tool=self.name)  # Format the error to make LLM understand it
                     raise
 
         return PromptTool()

mcp_use/agents/remote.py

@@ -14,6 +14,11 @@ from ..logging import logger
 
 T = TypeVar("T", bound=BaseModel)
 
+# API endpoint constants
+API_CHATS_ENDPOINT = "/api/v1/chats"
+API_CHAT_EXECUTE_ENDPOINT = "/api/v1/chats/{chat_id}/execute"
+API_CHAT_DELETE_ENDPOINT = "/api/v1/chats/{chat_id}"
+
 
 class RemoteAgent:
     """Agent that executes remotely via API."""
@@ -28,6 +33,7 @@ class RemoteAgent:
         """
         self.agent_id = agent_id
         self.base_url = base_url
+        self._chat_id = None  # Persistent chat session
 
         # Handle API key validation
         if api_key is None:
@@ -103,6 +109,49 @@ class RemoteAgent:
                 return output_schema.model_validate({"content": str(result_data)})
             raise
 
+    async def _create_chat_session(self, query: str) -> str:
+        """Create a persistent chat session for the agent.
+        Args:
+            query: The initial query (not used in title anymore)
+        Returns:
+            The chat ID of the created session
+        Raises:
+            RuntimeError: If chat creation fails
+        """
+        chat_payload = {
+            "title": f"Remote Agent Session - {self.agent_id}",
+            "agent_id": self.agent_id,
+            "type": "agent_execution",
+        }
+
+        headers = {"Content-Type": "application/json", "x-api-key": self.api_key}
+        chat_url = f"{self.base_url}{API_CHATS_ENDPOINT}"
+
+        logger.info(f"📝 Creating chat session for agent {self.agent_id}")
+
+        try:
+            chat_response = await self._client.post(chat_url, json=chat_payload, headers=headers)
+            chat_response.raise_for_status()
+
+            chat_data = chat_response.json()
+            chat_id = chat_data["id"]
+            logger.info(f"✅ Chat session created: {chat_id}")
+            return chat_id
+
+        except httpx.HTTPStatusError as e:
+            status_code = e.response.status_code
+            response_text = e.response.text
+
+            if status_code == 404:
+                raise RuntimeError(
+                    f"Agent not found: Agent '{self.agent_id}' does not exist or you don't have access to it. "
+                    "Please verify the agent ID and ensure it exists in your account."
+                ) from e
+            else:
+                raise RuntimeError(f"Failed to create chat session: {status_code} - {response_text}") from e
+        except Exception as e:
+            raise RuntimeError(f"Failed to create chat session: {str(e)}") from e
+
     async def run(
         self,
         query: str,
@@ -126,20 +175,28 @@ class RemoteAgent:
         if external_history is not None:
             logger.warning("External history is not yet supported for remote execution")
 
-        payload = {"query": query, "max_steps": max_steps or 10}
+        try:
+            logger.info(f"🌐 Executing query on remote agent {self.agent_id}")
 
-        # Add structured output schema if provided
-        if output_schema is not None:
-            payload["output_schema"] = self._pydantic_to_json_schema(output_schema)
-            logger.info(f"🔧 Using structured output with schema: {output_schema.__name__}")
+            # Step 1: Create a chat session for this agent (only if we don't have one)
+            if self._chat_id is None:
+                self._chat_id = await self._create_chat_session(query)
 
-        headers = {"Content-Type": "application/json", "x-api-key": self.api_key}
+            chat_id = self._chat_id
 
-        url = f"{self.base_url}/api/v1/agents/{self.agent_id}/run"
+            # Step 2: Execute the agent within the chat context
+            execution_payload = {"query": query, "max_steps": max_steps or 10}
 
-        try:
-            logger.info(f"🌐 Executing query on remote agent {self.agent_id}")
-            response = await self._client.post(url, json=payload, headers=headers)
+            # Add structured output schema if provided
+            if output_schema is not None:
+                execution_payload["output_schema"] = self._pydantic_to_json_schema(output_schema)
+                logger.info(f"🔧 Using structured output with schema: {output_schema.__name__}")
+
+            headers = {"Content-Type": "application/json", "x-api-key": self.api_key}
+            execution_url = f"{self.base_url}{API_CHAT_EXECUTE_ENDPOINT.format(chat_id=chat_id)}"
+            logger.info(f"🚀 Executing agent in chat {chat_id}")
+
+            response = await self._client.post(execution_url, json=execution_payload, headers=headers)
             response.raise_for_status()
 
             result = response.json()

mcp_use/client.py

@@ -9,7 +9,7 @@ import json
 import warnings
 from typing import Any
 
-from mcp.client.session import ElicitationFnT, SamplingFnT
+from mcp.client.session import ElicitationFnT, LoggingFnT, MessageHandlerFnT, SamplingFnT
 
 from mcp_use.types.sandbox import SandboxOptions
 
@@ -33,6 +33,8 @@ class MCPClient:
         sandbox_options: SandboxOptions | None = None,
         sampling_callback: SamplingFnT | None = None,
         elicitation_callback: ElicitationFnT | None = None,
+        message_handler: MessageHandlerFnT | None = None,
+        logging_callback: LoggingFnT | None = None,
     ) -> None:
         """Initialize a new MCP client.
 
@@ -51,6 +53,8 @@ class MCPClient:
         self.active_sessions: list[str] = []
         self.sampling_callback = sampling_callback
         self.elicitation_callback = elicitation_callback
+        self.message_handler = message_handler
+        self.logging_callback = logging_callback
         # Load configuration if provided
         if config is not None:
             if isinstance(config, str):
@@ -66,6 +70,8 @@ class MCPClient:
         sandbox_options: SandboxOptions | None = None,
         sampling_callback: SamplingFnT | None = None,
         elicitation_callback: ElicitationFnT | None = None,
+        message_handler: MessageHandlerFnT | None = None,
+        logging_callback: LoggingFnT | None = None,
     ) -> "MCPClient":
         """Create a MCPClient from a dictionary.
 
@@ -82,6 +88,8 @@ class MCPClient:
             sandbox_options=sandbox_options,
             sampling_callback=sampling_callback,
             elicitation_callback=elicitation_callback,
+            message_handler=message_handler,
+            logging_callback=logging_callback,
         )
 
     @classmethod
@@ -92,6 +100,8 @@ class MCPClient:
         sandbox_options: SandboxOptions | None = None,
         sampling_callback: SamplingFnT | None = None,
         elicitation_callback: ElicitationFnT | None = None,
+        message_handler: MessageHandlerFnT | None = None,
+        logging_callback: LoggingFnT | None = None,
     ) -> "MCPClient":
         """Create a MCPClient from a configuration file.
 
@@ -108,6 +118,8 @@ class MCPClient:
             sandbox_options=sandbox_options,
             sampling_callback=sampling_callback,
             elicitation_callback=elicitation_callback,
+            message_handler=message_handler,
+            logging_callback=logging_callback,
         )
 
     def add_server(
@@ -187,6 +199,8 @@ class MCPClient:
             sandbox_options=self.sandbox_options,
             sampling_callback=self.sampling_callback,
             elicitation_callback=self.elicitation_callback,
+            message_handler=self.message_handler,
+            logging_callback=self.logging_callback,
         )
 
         # Create the session

mcp_use/config.py

@@ -7,17 +7,11 @@ This module provides functionality to load MCP configuration from JSON files.
 import json
 from typing import Any
 
-from mcp.client.session import ElicitationFnT, SamplingFnT
+from mcp.client.session import ElicitationFnT, LoggingFnT, MessageHandlerFnT, SamplingFnT
 
 from mcp_use.types.sandbox import SandboxOptions
 
-from .connectors import (
-    BaseConnector,
-    HttpConnector,
-    SandboxConnector,
-    StdioConnector,
-    WebSocketConnector,
-)
+from .connectors import BaseConnector, HttpConnector, SandboxConnector, StdioConnector, WebSocketConnector
 from .connectors.utils import is_stdio_server
 
 
@@ -40,6 +34,8 @@ def create_connector_from_config(
     sandbox_options: SandboxOptions | None = None,
     sampling_callback: SamplingFnT | None = None,
     elicitation_callback: ElicitationFnT | None = None,
+    message_handler: MessageHandlerFnT | None = None,
+    logging_callback: LoggingFnT | None = None,
 ) -> BaseConnector:
     """Create a connector based on server configuration.
     This function can be called with just the server_config parameter:
@@ -61,6 +57,8 @@ def create_connector_from_config(
             env=server_config.get("env", None),
             sampling_callback=sampling_callback,
             elicitation_callback=elicitation_callback,
+            message_handler=message_handler,
+            logging_callback=logging_callback,
         )
 
     # Sandboxed connector
@@ -72,6 +70,8 @@ def create_connector_from_config(
             e2b_options=sandbox_options,
             sampling_callback=sampling_callback,
             elicitation_callback=elicitation_callback,
+            message_handler=message_handler,
+            logging_callback=logging_callback,
         )
 
     # HTTP connector
@@ -84,6 +84,8 @@ def create_connector_from_config(
             sse_read_timeout=server_config.get("sse_read_timeout", 60 * 5),
             sampling_callback=sampling_callback,
             elicitation_callback=elicitation_callback,
+            message_handler=message_handler,
+            logging_callback=logging_callback,
         )
 
     # WebSocket connector

mcp_use/connectors/base.py

@@ -5,14 +5,27 @@ This module provides the base connector interface that all MCP connectors
 must implement.
 """
 
+import warnings
 from abc import ABC, abstractmethod
 from datetime import timedelta
 from typing import Any
 
 from mcp import ClientSession, Implementation
-from mcp.client.session import ElicitationFnT, SamplingFnT
+from mcp.client.session import ElicitationFnT, LoggingFnT, MessageHandlerFnT, SamplingFnT
 from mcp.shared.exceptions import McpError
-from mcp.types import CallToolResult, GetPromptResult, Prompt, ReadResourceResult, Resource, Tool
+from mcp.types import (
+    CallToolResult,
+    GetPromptResult,
+    Prompt,
+    PromptListChangedNotification,
+    ReadResourceResult,
+    Resource,
+    ResourceListChangedNotification,
+    ServerCapabilities,
+    ServerNotification,
+    Tool,
+    ToolListChangedNotification,
+)
 from pydantic import AnyUrl
 
 import mcp_use
@@ -31,6 +44,8 @@ class BaseConnector(ABC):
         self,
         sampling_callback: SamplingFnT | None = None,
         elicitation_callback: ElicitationFnT | None = None,
+        message_handler: MessageHandlerFnT | None = None,
+        logging_callback: LoggingFnT | None = None,
     ):
         """Initialize base connector with common attributes."""
         self.client_session: ClientSession | None = None
@@ -43,6 +58,9 @@ class BaseConnector(ABC):
         self.auto_reconnect = True  # Whether to automatically reconnect on connection loss (not configurable for now)
         self.sampling_callback = sampling_callback
         self.elicitation_callback = elicitation_callback
+        self.message_handler = message_handler
+        self.logging_callback = logging_callback
+        self.capabilities: ServerCapabilities | None = None
 
     @property
     def client_info(self) -> Implementation:
@@ -53,6 +71,20 @@ class BaseConnector(ABC):
             url="https://github.com/mcp-use/mcp-use",
         )
 
+    async def _internal_message_handler(self, message: Any) -> None:
+        """Wrap the user-provided message handler."""
+        if isinstance(message, ServerNotification):
+            if isinstance(message.root, ToolListChangedNotification):
+                logger.debug("Received tool list changed notification")
+            elif isinstance(message.root, ResourceListChangedNotification):
+                logger.debug("Received resource list changed notification")
+            elif isinstance(message.root, PromptListChangedNotification):
+                logger.debug("Received prompt list changed notification")
+
+        # Call the user's handler
+        if self.message_handler:
+            await self.message_handler(message)
+
     @abstractmethod
     async def connect(self) -> None:
         """Establish a connection to the MCP implementation."""
@@ -125,37 +157,37 @@ class BaseConnector(ABC):
         result = await self.client_session.initialize()
         self._initialized = True  # Mark as initialized
 
-        server_capabilities = result.capabilities
+        self.capabilities = result.capabilities
 
-        if server_capabilities.tools:
+        if self.capabilities.tools:
             # Get available tools directly from client session
             try:
                 tools_result = await self.client_session.list_tools()
                 self._tools = tools_result.tools if tools_result else []
             except Exception as e:
-                logger.error(f"Error listing tools: {e}")
+                logger.error(f"Error listing tools for connector {self.public_identifier}: {e}")
                 self._tools = []
         else:
             self._tools = []
 
-        if server_capabilities.resources:
+        if self.capabilities.resources:
             # Get available resources directly from client session
             try:
                 resources_result = await self.client_session.list_resources()
                 self._resources = resources_result.resources if resources_result else []
             except Exception as e:
-                logger.error(f"Error listing resources: {e}")
+                logger.error(f"Error listing resources for connector {self.public_identifier}: {e}")
                 self._resources = []
         else:
             self._resources = []
 
-        if server_capabilities.prompts:
+        if self.capabilities.prompts:
             # Get available prompts directly from client session
             try:
                 prompts_result = await self.client_session.list_prompts()
                 self._prompts = prompts_result.prompts if prompts_result else []
             except Exception as e:
-                logger.error(f"Error listing prompts: {e}")
+                logger.error(f"Error listing prompts for connector {self.public_identifier}: {e}")
                 self._prompts = []
         else:
             self._prompts = []
@@ -170,21 +202,57 @@ class BaseConnector(ABC):
 
     @property
     def tools(self) -> list[Tool]:
-        """Get the list of available tools."""
+        """Get the list of available tools.
+
+        .. deprecated::
+            This property is deprecated because it may return stale data when the server
+            sends list change notifications. Use `await list_tools()` instead to ensure
+            you always get the latest data.
+        """
+        warnings.warn(
+            "The 'tools' property is deprecated and may return stale data. "
+            "Use 'await list_tools()' instead to ensure fresh data.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         if self._tools is None:
             raise RuntimeError("MCP client is not initialized")
         return self._tools
 
     @property
     def resources(self) -> list[Resource]:
-        """Get the list of available resources."""
+        """Get the list of available resources.
+
+        .. deprecated::
+            This property is deprecated because it may return stale data when the server
+            sends list change notifications. Use `await list_resources()` instead to ensure
+            you always get the latest data.
+        """
+        warnings.warn(
+            "The 'resources' property is deprecated and may return stale data. "
+            "Use 'await list_resources()' instead to ensure fresh data.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         if self._resources is None:
             raise RuntimeError("MCP client is not initialized")
         return self._resources
 
     @property
     def prompts(self) -> list[Prompt]:
-        """Get the list of available prompts."""
+        """Get the list of available prompts.
+
+        .. deprecated::
+            This property is deprecated because it may return stale data when the server
+            sends list change notifications. Use `await list_prompts()' instead to ensure
+            you always get the latest data.
+        """
+        warnings.warn(
+            "The 'prompts' property is deprecated and may return stale data. "
+            "Use 'await list_prompts()' instead to ensure fresh data.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         if self._prompts is None:
             raise RuntimeError("MCP client is not initialized")
         return self._prompts
@@ -303,28 +371,39 @@ class BaseConnector(ABC):
     async def list_tools(self) -> list[Tool]:
         """List all available tools from the MCP implementation."""
 
+        if self.capabilities and not self.capabilities.tools:
+            logger.debug(f"Server {self.public_identifier} does not support tools")
+            return []
+
         # Ensure we're connected
         await self._ensure_connected()
 
         logger.debug("Listing tools")
         try:
             result = await self.client_session.list_tools()
+            self._tools = result.tools
             return result.tools
         except McpError as e:
-            logger.error(f"Error listing tools: {e}")
+            logger.error(f"Error listing tools for connector {self.public_identifier}: {e}")
             return []
 
     async def list_resources(self) -> list[Resource]:
         """List all available resources from the MCP implementation."""
+
+        if self.capabilities and not self.capabilities.resources:
+            logger.debug(f"Server {self.public_identifier} does not support resources")
+            return []
+
         # Ensure we're connected
         await self._ensure_connected()
 
         logger.debug("Listing resources")
         try:
             result = await self.client_session.list_resources()
+            self._resources = result.resources
             return result.resources
         except McpError as e:
-            logger.error(f"Error listing resources: {e}")
+            logger.warning(f"Error listing resources for connector {self.public_identifier}: {e}")
             return []
 
     async def read_resource(self, uri: AnyUrl) -> ReadResourceResult:
@@ -337,14 +416,20 @@ class BaseConnector(ABC):
 
     async def list_prompts(self) -> list[Prompt]:
         """List all available prompts from the MCP implementation."""
+
+        if self.capabilities and not self.capabilities.prompts:
+            logger.debug(f"Server {self.public_identifier} does not support prompts")
+            return []
+
         await self._ensure_connected()
 
         logger.debug("Listing prompts")
         try:
             result = await self.client_session.list_prompts()
+            self._prompts = result.prompts
             return result.prompts
         except McpError as e:
-            logger.error(f"Error listing prompts: {e}")
+            logger.error(f"Error listing prompts for connector {self.public_identifier}: {e}")
             return []
 
     async def get_prompt(self, name: str, arguments: dict[str, Any] | None = None) -> GetPromptResult:

mcp_use/connectors/http.py

@@ -7,7 +7,7 @@ through HTTP APIs with SSE or Streamable HTTP for transport.
 
 import httpx
 from mcp import ClientSession
-from mcp.client.session import ElicitationFnT, SamplingFnT
+from mcp.client.session import ElicitationFnT, LoggingFnT, MessageHandlerFnT, SamplingFnT
 
 from ..logging import logger
 from ..task_managers import SseConnectionManager, StreamableHttpConnectionManager
@@ -30,6 +30,8 @@ class HttpConnector(BaseConnector):
         sse_read_timeout: float = 60 * 5,
         sampling_callback: SamplingFnT | None = None,
         elicitation_callback: ElicitationFnT | None = None,
+        message_handler: MessageHandlerFnT | None = None,
+        logging_callback: LoggingFnT | None = None,
     ):
         """Initialize a new HTTP connector.
 
@@ -42,7 +44,12 @@ class HttpConnector(BaseConnector):
             sampling_callback: Optional sampling callback.
             elicitation_callback: Optional elicitation callback.
         """
-        super().__init__(sampling_callback=sampling_callback, elicitation_callback=elicitation_callback)
+        super().__init__(
+            sampling_callback=sampling_callback,
+            elicitation_callback=elicitation_callback,
+            message_handler=message_handler,
+            logging_callback=logging_callback,
+        )
         self.base_url = base_url.rstrip("/")
         self.auth_token = auth_token
         self.headers = headers or {}
@@ -78,6 +85,8 @@ class HttpConnector(BaseConnector):
                 write_stream,
                 sampling_callback=self.sampling_callback,
                 elicitation_callback=self.elicitation_callback,
+                message_handler=self._internal_message_handler,
+                logging_callback=self.logging_callback,
                 client_info=self.client_info,
             )
             await test_client.__aenter__()
@@ -162,6 +171,8 @@ class HttpConnector(BaseConnector):
                         write_stream,
                         sampling_callback=self.sampling_callback,
                         elicitation_callback=self.elicitation_callback,
+                        message_handler=self._internal_message_handler,
+                        logging_callback=self.logging_callback,
                         client_info=self.client_info,
                     )
                     await self.client_session.__aenter__()

mcp_use/connectors/sandbox.py

@@ -12,7 +12,7 @@ import time
 
 import aiohttp
 from mcp import ClientSession
-from mcp.client.session import ElicitationFnT, SamplingFnT
+from mcp.client.session import ElicitationFnT, LoggingFnT, MessageHandlerFnT, SamplingFnT
 
 from ..logging import logger
 from ..task_managers import SseConnectionManager
@@ -20,10 +20,7 @@ from ..task_managers import SseConnectionManager
 # Import E2B SDK components (optional dependency)
 try:
     logger.debug("Attempting to import e2b_code_interpreter...")
-    from e2b_code_interpreter import (
-        CommandHandle,
-        Sandbox,
-    )
+    from e2b_code_interpreter import CommandHandle, Sandbox
 
     logger.debug("Successfully imported e2b_code_interpreter")
 except ImportError as e:
@@ -53,6 +50,8 @@ class SandboxConnector(BaseConnector):
         sse_read_timeout: float = 60 * 5,
         sampling_callback: SamplingFnT | None = None,
         elicitation_callback: ElicitationFnT | None = None,
+        message_handler: MessageHandlerFnT | None = None,
+        logging_callback: LoggingFnT | None = None,
     ):
         """Initialize a new sandbox connector.
 
@@ -67,7 +66,12 @@ class SandboxConnector(BaseConnector):
             sampling_callback: Optional sampling callback.
             elicitation_callback: Optional elicitation callback.
         """
-        super().__init__(sampling_callback=sampling_callback, elicitation_callback=elicitation_callback)
+        super().__init__(
+            sampling_callback=sampling_callback,
+            elicitation_callback=elicitation_callback,
+            message_handler=message_handler,
+            logging_callback=logging_callback,
+        )
         if Sandbox is None:
             raise ImportError(
                 "E2B SDK (e2b-code-interpreter) not found. Please install it with "
@@ -227,6 +231,8 @@ class SandboxConnector(BaseConnector):
                 write_stream,
                 sampling_callback=self.sampling_callback,
                 elicitation_callback=self.elicitation_callback,
+                message_handler=self._internal_message_handler,
+                logging_callback=self.logging_callback,
                 client_info=self.client_info,
             )
             await self.client_session.__aenter__()

mcp_use/connectors/stdio.py

@@ -8,7 +8,7 @@ through the standard input/output streams.
 import sys
 
 from mcp import ClientSession, StdioServerParameters
-from mcp.client.session import ElicitationFnT, SamplingFnT
+from mcp.client.session import ElicitationFnT, LoggingFnT, MessageHandlerFnT, SamplingFnT
 
 from ..logging import logger
 from ..task_managers import StdioConnectionManager
@@ -31,6 +31,8 @@ class StdioConnector(BaseConnector):
         errlog=sys.stderr,
         sampling_callback: SamplingFnT | None = None,
         elicitation_callback: ElicitationFnT | None = None,
+        message_handler: MessageHandlerFnT | None = None,
+        logging_callback: LoggingFnT | None = None,
     ):
         """Initialize a new stdio connector.
 
@@ -42,7 +44,12 @@ class StdioConnector(BaseConnector):
             sampling_callback: Optional callback to sample the client.
             elicitation_callback: Optional callback to elicit the client.
         """
-        super().__init__(sampling_callback=sampling_callback, elicitation_callback=elicitation_callback)
+        super().__init__(
+            sampling_callback=sampling_callback,
+            elicitation_callback=elicitation_callback,
+            message_handler=message_handler,
+            logging_callback=logging_callback,
+        )
         self.command = command
         self.args = args or []  # Ensure args is never None
         self.env = env
@@ -69,6 +76,8 @@ class StdioConnector(BaseConnector):
                 write_stream,
                 sampling_callback=self.sampling_callback,
                 elicitation_callback=self.elicitation_callback,
+                message_handler=self._internal_message_handler,
+                logging_callback=self.logging_callback,
                 client_info=self.client_info,
             )
             await self.client_session.__aenter__()

mcp_use/errors/__init__.py

@@ -0,0 +1 @@
+

mcp_use/errors/error_formatting.py

@@ -0,0 +1,29 @@
+import traceback
+
+from ..logging import logger
+
+retryable_exceptions = (TimeoutError, ConnectionError)  # We can add more exceptions here
+
+
+def format_error(error: Exception, **context) -> dict:
+    """
+    Formats an exception into a structured format that can be understood by LLMs.
+
+    Args:
+        error: The exception to format.
+        **context: Additional context to include in the formatted error.
+
+    Returns:
+        A dictionary containing the formatted error.
+    """
+    formatted_context = {
+        "error": type(error).__name__,
+        "details": str(error),
+        "isRetryable": isinstance(error, retryable_exceptions),
+        "stack": traceback.format_exc(),
+        "code": getattr(error, "code", "UNKNOWN"),
+    }
+    formatted_context.update(context)
+
+    logger.error(f"Structured error: {formatted_context}")  # For observability (maybe remove later)
+    return formatted_context

mcp_use/managers/server_manager.py

@@ -4,13 +4,7 @@ from mcp_use.client import MCPClient
 from mcp_use.logging import logger
 
 from ..adapters.base import BaseAdapter
-from .tools import (
-    ConnectServerTool,
-    DisconnectServerTool,
-    GetActiveServerTool,
-    ListServersTool,
-    SearchToolsTool,
-)
+from .tools import ConnectServerTool, DisconnectServerTool, GetActiveServerTool, ListServersTool, SearchToolsTool
 
 
 class ServerManager:

mcp_use/managers/tools/connect_server.py

@@ -2,6 +2,7 @@ from typing import ClassVar
 
 from pydantic import BaseModel, Field
 
+from mcp_use.errors.error_formatting import format_error
 from mcp_use.logging import logger
 
 from .base_tool import MCPServerTool
@@ -62,7 +63,7 @@ class ConnectServerTool(MCPServerTool):
 
         except Exception as e:
             logger.error(f"Error connecting to server '{server_name}': {e}")
-            return f"Failed to connect to server '{server_name}': {str(e)}"
+            return format_error(e, server_name=server_name)
 
     def _run(self, server_name: str) -> str:
         """Synchronous version that raises a NotImplementedError - use _arun instead."""

mcp_use/managers/tools/disconnect_server.py

@@ -2,6 +2,7 @@ from typing import ClassVar
 
 from pydantic import BaseModel
 
+from mcp_use.errors.error_formatting import format_error
 from mcp_use.logging import logger
 
 from .base_tool import MCPServerTool
@@ -36,7 +37,7 @@ class DisconnectServerTool(MCPServerTool):
             return f"Successfully disconnected from MCP server '{server_name}'."
         except Exception as e:
             logger.error(f"Error disconnecting from server '{server_name}': {e}")
-            return f"Failed to disconnect from server '{server_name}': {str(e)}"
+            return format_error(e, server_name=server_name)
 
     async def _arun(self, **kwargs) -> str:
         """Async implementation of _run."""

mcp_use/managers/tools/list_servers_tool.py

@@ -2,6 +2,7 @@ from typing import ClassVar
 
 from pydantic import BaseModel
 
+from mcp_use.errors.error_formatting import format_error
 from mcp_use.logging import logger
 
 from .base_tool import MCPServerTool
@@ -44,6 +45,7 @@ class ListServersTool(MCPServerTool):
                     result += f"   {tool_count} tools available for this server\n"
             except Exception as e:
                 logger.error(f"Unexpected error listing tools for server '{server_name}': {e}")
+                return format_error(e, server=server_name, operation="list_tools")
 
         return result
 

mcp_use/session.py

@@ -5,8 +5,12 @@ This module provides a session manager for MCP connections,
 which handles authentication, initialization, and tool discovery.
 """
 
+from datetime import timedelta
 from typing import Any
 
+from mcp.types import CallToolResult, GetPromptResult, Prompt, ReadResourceResult, Resource, Tool
+from pydantic import AnyUrl
+
 from .connectors.base import BaseConnector
 
 
@@ -82,3 +86,69 @@ class MCPSession:
             True if the connector is connected, False otherwise.
         """
         return self.connector.is_connected
+
+    # Convenience methods for MCP operations
+    async def call_tool(
+        self, name: str, arguments: dict[str, Any], read_timeout_seconds: timedelta | None = None
+    ) -> CallToolResult:
+        """Call an MCP tool.
+
+        Args:
+            name: The name of the tool to call.
+            arguments: The arguments to pass to the tool.
+            read_timeout_seconds: Optional timeout for the tool call.
+
+        Returns:
+            The result of the tool call.
+
+        Raises:
+            RuntimeError: If the connection is lost and cannot be reestablished.
+        """
+        return await self.connector.call_tool(name, arguments, read_timeout_seconds)
+
+    async def list_tools(self) -> list[Tool]:
+        """List all available tools from the MCP server.
+
+        Returns:
+            List of available tools.
+        """
+        return await self.connector.list_tools()
+
+    async def list_resources(self) -> list[Resource]:
+        """List all available resources from the MCP server.
+
+        Returns:
+            List of available resources.
+        """
+        return await self.connector.list_resources()
+
+    async def read_resource(self, uri: AnyUrl) -> ReadResourceResult:
+        """Read a resource by URI.
+
+        Args:
+            uri: The URI of the resource to read.
+
+        Returns:
+            The resource content.
+        """
+        return await self.connector.read_resource(uri)
+
+    async def list_prompts(self) -> list[Prompt]:
+        """List all available prompts from the MCP server.
+
+        Returns:
+            List of available prompts.
+        """
+        return await self.connector.list_prompts()
+
+    async def get_prompt(self, name: str, arguments: dict[str, Any] | None = None) -> GetPromptResult:
+        """Get a prompt by name.
+
+        Args:
+            name: The name of the prompt to get.
+            arguments: Optional arguments for the prompt.
+
+        Returns:
+            The prompt result with messages.
+        """
+        return await self.connector.get_prompt(name, arguments)

mcp_use/telemetry/telemetry.py

@@ -11,10 +11,7 @@ from posthog import Posthog
 from scarf import ScarfEventLogger
 
 from mcp_use.logging import MCP_USE_DEBUG
-from mcp_use.telemetry.events import (
-    BaseTelemetryEvent,
-    MCPAgentExecutionEvent,
-)
+from mcp_use.telemetry.events import BaseTelemetryEvent, MCPAgentExecutionEvent
 from mcp_use.telemetry.utils import get_package_version
 from mcp_use.utils import singleton
 

{mcp_use-1.3.8.dist-info → mcp_use-1.3.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-use
-Version: 1.3.8
+Version: 1.3.9
 Summary: MCP Library for LLMs
 Author-email: Pietro Zullo <pietro.zullo@gmail.com>
 License: MIT
@@ -46,25 +46,30 @@ Description-Content-Type: text/markdown
 <div align="center">
 <div align="center" style="margin: 0 auto; max-width: 80%;">
   <picture>
-    <source media="(prefers-color-scheme: dark)" srcset="static/logo_white.svg">
-    <source media="(prefers-color-scheme: light)" srcset="static/logo_black.svg">
-    <img alt="mcp use logo" src="./static/logo-white.svg" width="80%" style="margin: 20px auto;">
+    <source media="(prefers-color-scheme: dark)" srcset="static/logo-gh.jpg">
+    <source media="(prefers-color-scheme: light)" srcset="static/logo-gh.jpg">
+    <img alt="mcp use logo" src="./static/logo-gh.jpg" width="80%" style="margin: 20px auto;">
   </picture>
 </div>
 
 <br>
 
-# Connect any LLM to any MCP server
+# Create MCP Clients and Agents
 
+<p align="center">
+<a href="https://www.producthunt.com/products/mcp-use?embed=true&utm_source=badge-featured&utm_medium=badge&utm_source=badge-mcp&#0045;use" target="_blank"><img src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1002629&theme=neutral&t=1754609432704" alt="mcp&#0045;use - Open&#0032;source&#0032;SDK&#0032;and&#0032;infra&#0032;for&#0032;MCP&#0032;servers&#0032;&#0038;&#0032;agents | Product Hunt" style="width: 150px; height: 32px;" width="150" height="32" /></a>
+</p>
 <p align="center">
     <a href="https://github.com/pietrozullo/mcp-use/stargazers" alt="GitHub stars">
         <img src="https://img.shields.io/github/stars/pietrozullo/mcp-use?style=social" /></a>
+    <a href="https://pypi.org/project/mcp_use/" alt="PyPI Downloads">
+        <img src="https://static.pepy.tech/badge/mcp-use" /></a>
     <a href="https://pypi.org/project/mcp_use/" alt="PyPI Version">
         <img src="https://img.shields.io/pypi/v/mcp_use.svg"/></a>
+    <a href="https://github.com/mcp-use/mcp-use-ts" alt="TypeScript">
+      <img src="https://img.shields.io/badge/TypeScript-mcp--use-3178C6?logo=typescript&logoColor=white" /></a>
     <a href="https://github.com/pietrozullo/mcp-use/blob/main/LICENSE" alt="License">
         <img src="https://img.shields.io/github/license/pietrozullo/mcp-use" /></a>
-    <a href="https://pypi.org/project/mcp_use/" alt="PyPI Downloads">
-        <img src="https://static.pepy.tech/badge/mcp-use" /></a>
     <a href="https://docs.mcp-use.com" alt="Documentation">
         <img src="https://img.shields.io/badge/docs-mcp--use.com-blue" /></a>
     <a href="https://mcp-use.com" alt="Website">
@@ -88,10 +93,10 @@ Description-Content-Type: text/markdown
 - Visit the [mcp-use docs](https://docs.mcp-use.com/) to get started with mcp-use library
 - For the TypeScript version, visit [mcp-use-ts](https://github.com/mcp-use/mcp-use-ts)
 
-| Supports  | |
-| :--- | :--- |
+| Supports       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| :------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | **Primitives** | [![Tools](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-tools&label=Tools&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Resources](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-resources&label=Resources&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Prompts](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-prompts&label=Prompts&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Sampling](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-sampling&label=Sampling&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Elicitation](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-elicitation&label=Elicitation&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) |
-| **Transports** | [![Stdio](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=transport-stdio&label=Stdio&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![SSE](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=transport-sse&label=SSE&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Streamable HTTP](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=transport-streamableHttp&label=Streamable%20HTTP&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) |
+| **Transports** | [![Stdio](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=transport-stdio&label=Stdio&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![SSE](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=transport-sse&label=SSE&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Streamable HTTP](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=transport-streamableHttp&label=Streamable%20HTTP&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml)                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
 
 ## Features
 
@@ -417,29 +422,7 @@ if __name__ == "__main__":
     asyncio.run(run_blender_example())
 ```
 
-# Configuration File Support
-
-MCP-Use supports initialization from configuration files, making it easy to manage and switch between different MCP server setups:
-
-```python
-import asyncio
-from mcp_use import create_session_from_config
-
-async def main():
-    # Create an MCP session from a config file
-    session = create_session_from_config("mcp-config.json")
-
-    # Initialize the session
-    await session.initialize()
-
-    # Use the session...
-
-    # Disconnect when done
-    await session.disconnect()
-
-if __name__ == "__main__":
-    asyncio.run(main())
-```
+# Configuration Support
 
 ## HTTP Connection Example
 
@@ -695,6 +678,47 @@ The `SandboxOptions` type provides configuration for the sandbox environment:
 - **Consistent environment**: Ensure consistent behavior across different systems
 - **Resource efficiency**: Offload resource-intensive tasks to cloud infrastructure
 
+# Direct Tool Calls (Without LLM)
+
+You can call MCP server tools directly without an LLM when you need programmatic control:
+
+```python
+import asyncio
+from mcp_use import MCPClient
+
+async def call_tool_example():
+    config = {
+        "mcpServers": {
+            "everything": {
+                "command": "npx",
+                "args": ["-y", "@modelcontextprotocol/server-everything"],
+            }
+        }
+    }
+
+    client = MCPClient.from_dict(config)
+
+    try:
+        await client.create_all_sessions()
+        session = client.get_session("everything")
+
+        # Call tool directly
+        result = await session.call_tool(
+            name="add",
+            arguments={"a": 1, "b": 2}
+        )
+
+        print(f"Result: {result.content[0].text}")  # Output: 3
+
+    finally:
+        await client.close_all_sessions()
+
+if __name__ == "__main__":
+    asyncio.run(call_tool_example())
+```
+
+See the complete example: [examples/direct_tool_call.py](examples/direct_tool_call.py)
+
 # Build a Custom Agent:
 
 You can also build your own custom agent using the LangChain adapter:
@@ -813,23 +837,27 @@ Thanks to all our amazing contributors!
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/38653995?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/patchy631/ai-engineering-hub"><strong>patchy631/ai-engineering-hub</strong></a></td>
-    <td>⭐ 15189</td>
+    <td>⭐ 15920</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/170207473?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/tavily-ai/meeting-prep-agent"><strong>tavily-ai/meeting-prep-agent</strong></a></td>
     <td>⭐ 129</td>
   </tr>
   <tr>
-    <td><img src="https://avatars.githubusercontent.com/u/187057607?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/hud-evals/hud-sdk"><strong>hud-evals/hud-sdk</strong></a></td>
-    <td>⭐ 75</td>
+    <td><img src="https://avatars.githubusercontent.com/u/164294848?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/buildfastwithai/gen-ai-experiments"><strong>buildfastwithai/gen-ai-experiments</strong></a></td>
+    <td>⭐ 93</td>
+  </tr>
+  <tr>
+    <td><img src="https://avatars.githubusercontent.com/u/187057607?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/hud-evals/hud-python"><strong>hud-evals/hud-python</strong></a></td>
+    <td>⭐ 76</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/20041231?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/krishnaik06/MCP-CRASH-Course"><strong>krishnaik06/MCP-CRASH-Course</strong></a></td>
-    <td>⭐ 58</td>
+    <td>⭐ 61</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/54944174?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/larksuite/lark-samples"><strong>larksuite/lark-samples</strong></a></td>
-    <td>⭐ 31</td>
+    <td>⭐ 35</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/892404?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/truemagic-coder/solana-agent-app"><strong>truemagic-coder/solana-agent-app</strong></a></td>
@@ -845,11 +873,7 @@ Thanks to all our amazing contributors!
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/100749943?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/Deniscartin/mcp-cli"><strong>Deniscartin/mcp-cli</strong></a></td>
-    <td>⭐ 18</td>
-  </tr>
-  <tr>
-    <td><img src="https://avatars.githubusercontent.com/u/6688805?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/innovaccer/Healthcare-MCP"><strong>innovaccer/Healthcare-MCP</strong></a></td>
-    <td>⭐ 15</td>
+    <td>⭐ 19</td>
   </tr>
 </table>
 

{mcp_use-1.3.8.dist-info → mcp_use-1.3.9.dist-info}/RECORD

@@ -1,33 +1,35 @@
-mcp_use/__init__.py,sha256=I3gFxw6Id45RksUBIZS1kxBW3ItjFXuAfoReJabpnW0,1055
-mcp_use/client.py,sha256=dziKHIZIclLk64ycF4keegiVp93YKqSyGok7Rv4j8bE,10958
-mcp_use/config.py,sha256=J3ebF9dlQxui3pSONTFtVYO035E7d0CP4HAvN0INgE4,3103
+mcp_use/__init__.py,sha256=vyjxKmfVDtkbJ6sthDEH_m-uJGXxkYdUBMwBpCt72zA,1021
+mcp_use/client.py,sha256=4WnFrbBBa3YX3brfBgZrhb_OgAT8mMfVzLUHwnnKi8o,11701
+mcp_use/config.py,sha256=yRgUPCMUzkFqROyccG2wjuhGxneCcbgnrHWHQ6z_hoc,3487
 mcp_use/logging.py,sha256=CRtkPwR-bkXK_kQ0QOL86RikMWOHzEOi7A8VRHkNsZw,4270
-mcp_use/session.py,sha256=4kwcB_IkTt_3FiBSTI1H17KhL1W_6N5oai3HTxFrTH4,2496
+mcp_use/session.py,sha256=DpH_z0a3xYemV9yWzlrf-IPZtpR27CI2S-gAm2jbCAc,4700
 mcp_use/utils.py,sha256=QavJcVq2WxUUUCCpPCUeOB5bqIS0FFmpK-RAZkGc6aA,720
 mcp_use/adapters/__init__.py,sha256=-xCrgPThuX7x0PHGFDdjb7M-mgw6QV3sKu5PM7ShnRg,275
-mcp_use/adapters/base.py,sha256=U1z_UzojC-bytb4ZuKTRpEgEp-2F_BVBgqEXbUqLYB4,6901
-mcp_use/adapters/langchain_adapter.py,sha256=LdlpRyLORhl8NZvtAmisgPelXkhEbBErSNdGHb8SF18,10860
+mcp_use/adapters/base.py,sha256=8XB3xWZ6nJPhhmHwVtHT8-HO0D_9nnxzOkbVDP-fI3k,6940
+mcp_use/adapters/langchain_adapter.py,sha256=zGEVMXLj_jpSXUMHOh5u-fxkkrK2zpSibOSGCy_VMr0,11033
 mcp_use/agents/__init__.py,sha256=FzkntihbAqzixWdWe99zIrrcIfd4N3YWltNniutG9VA,267
 mcp_use/agents/base.py,sha256=EN-dRbwOi9vIqofFg3jmi5yT2VKlwEr9Cwi1DZgB3eE,1591
 mcp_use/agents/mcpagent.py,sha256=Vh4VOxxh-6sJwK1tTtJgUWZcp1bd3hb_JnATc7x9sKk,46698
-mcp_use/agents/remote.py,sha256=_8TKP-hfr8NsexbpaEz8bK4LU-opILJMnTL7TbQBiY4,10575
+mcp_use/agents/remote.py,sha256=peSw3aixybneTWgrGlSZedUvo_FuISSiWqFgySZSwEM,13011
 mcp_use/agents/prompts/system_prompt_builder.py,sha256=E86STmxcl2Ic763_114awNqFB2RyLrQlbvgRmJajQjI,4116
 mcp_use/agents/prompts/templates.py,sha256=acg2Q-_uQDL-3q5ZUwwwFrP7wqqf-SEyq0XWDDHt69s,1906
 mcp_use/connectors/__init__.py,sha256=cUF4yT0bNr8qeLkSzg28SHueiV5qDaHEB1l1GZ2K0dc,536
-mcp_use/connectors/base.py,sha256=bCPOrSb3xzuxQRFpcLf7tCG1UmMFtr9IVM7br8JlbzI,13878
-mcp_use/connectors/http.py,sha256=8LVzXtVtdLVQH9xMIqPzKfPEmaO_cxzMIu4g4oGIung,7912
-mcp_use/connectors/sandbox.py,sha256=RX8xssn0cIObW6CjOqY7ZrO_D9lTzCZKdRcJ5lQSmQg,11441
-mcp_use/connectors/stdio.py,sha256=jTNhrsHxkRgSI9uAnj4bbFsBwe6zooc-oNcMXV_s9Xk,3378
+mcp_use/connectors/base.py,sha256=R1Qh9D6btullQUGiMBVZewP3M7d-0VrsIt4bSw3bHxI,17482
+mcp_use/connectors/http.py,sha256=eiX5NAsT9mnzqWRAoxb6qG3nWxPiVyw5MVcwRY8D6lE,8436
+mcp_use/connectors/sandbox.py,sha256=oXs4Q_1bQJ10XOrJLjFUBKvFy2VmWmyzLhotczl44Po,11804
+mcp_use/connectors/stdio.py,sha256=4gXdXyaeA3B-ywAjPmbEEbHxP2Gg5cWsXNC2kHkubDA,3766
 mcp_use/connectors/utils.py,sha256=zQ8GdNQx0Twz3by90BoU1RsWPf9wODGof4K3-NxPXeA,366
 mcp_use/connectors/websocket.py,sha256=G7ZeLJNPVl9AG6kCmiNJz1N2Ing_QxT7pSswigTKi8Y,9650
+mcp_use/errors/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+mcp_use/errors/error_formatting.py,sha256=17lhj5goGHuTbJ5oLCUXyJ2SuIbzsuSM1Wk8LPeqY9k,911
 mcp_use/managers/__init__.py,sha256=FRTuJw5kYtY1Eo7wN9Aeqeqo1euiR5slvrx5Fl_SGvk,383
-mcp_use/managers/server_manager.py,sha256=8F6jEwZOoAfR1y1O7zk-BSZ1LVYcLZTSQZLRClhSE2I,5278
+mcp_use/managers/server_manager.py,sha256=eWxiuP0yL3HWSyCWdHqNZ1isZfa3IZDWVEjWSfYOs_A,5253
 mcp_use/managers/tools/__init__.py,sha256=zcpm4HXsp8NUMRJeyT6DdB8cgIMDs46pBfoTD-odhGU,437
 mcp_use/managers/tools/base_tool.py,sha256=Jbbp7SwmHKDk8jT_6yVIv7iNsn6KaV_PljWuhhLcbXg,509
-mcp_use/managers/tools/connect_server.py,sha256=MGYQCl11q-w6gSIYuT44dDk7ILV3Oh7kGAJ4fsNXbso,2923
-mcp_use/managers/tools/disconnect_server.py,sha256=Y3kJN31efzsjfJwxUhpBxS-bgU21DCfGbn_LgEbzyvI,1586
+mcp_use/managers/tools/connect_server.py,sha256=-PlqgJDSMzairK90aDg1WTDjpqrFMoTiyekwoPDWNrw,2964
+mcp_use/managers/tools/disconnect_server.py,sha256=dLa5PH-QZ30Dw3n5lzqilyHA8PuQ6xvMkXd-T5EwpU8,1622
 mcp_use/managers/tools/get_active_server.py,sha256=tCaib76gYU3L5G82tEOTq4Io2cuCXWjOjPselb-92i8,964
-mcp_use/managers/tools/list_servers_tool.py,sha256=OPDSMNe-VuAhlUyhDnR4CiuZFpoMhnhWpAablwO5S0k,1897
+mcp_use/managers/tools/list_servers_tool.py,sha256=P_Z96Ab8ELLyo3GQfTMfyemTPJwt0VR1s_iMnWE1GCg,2037
 mcp_use/managers/tools/search_tools.py,sha256=4vso7ln-AfG6lQAMq9FA_CyeVtSEDYEWlHtdHtfnLps,12911
 mcp_use/observability/__init__.py,sha256=kTUcP0d6L5_3ktfldhdAk-3AWckzVHs7ztG-R6cye64,186
 mcp_use/observability/laminar.py,sha256=WWjmVXP55yCfAlqlayeuJmym1gdrv8is7UyrIp4Tbn0,839
@@ -40,10 +42,10 @@ mcp_use/task_managers/streamable_http.py,sha256=Zky821Ston5CX0DQVyeRxc2uUqALD8so
 mcp_use/task_managers/websocket.py,sha256=9JTw705rhYbP6x2xAPF6PwtNgF5yEWTQhx-dYSPMoaI,2154
 mcp_use/telemetry/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mcp_use/telemetry/events.py,sha256=K5xqbmkum30r4gM2PWtTiUWGF8oZzGZw2DYwco1RfOQ,3113
-mcp_use/telemetry/telemetry.py,sha256=ck2MDFMtooafriR1W_zi41dWq-0O-ucF89pCkdkyc9E,11724
+mcp_use/telemetry/telemetry.py,sha256=oM_QAbZwOStKkeccvEfKmJLKhL2neFkPn5yM5rL2qHc,11711
 mcp_use/telemetry/utils.py,sha256=kDVTqt2oSeWNJbnTOlXOehr2yFO0PMyx2UGkrWkfJiw,1769
 mcp_use/types/sandbox.py,sha256=opJ9r56F1FvaqVvPovfAj5jZbsOexgwYx5wLgSlN8_U,712
-mcp_use-1.3.8.dist-info/METADATA,sha256=nqKWqFTWM-XqfsPrXXyn5Q6opaMyWz_oe3qfSZEfM3M,30356
-mcp_use-1.3.8.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-mcp_use-1.3.8.dist-info/licenses/LICENSE,sha256=7Pw7dbwJSBw8zH-WE03JnR5uXvitRtaGTP9QWPcexcs,1068
-mcp_use-1.3.8.dist-info/RECORD,,
+mcp_use-1.3.9.dist-info/METADATA,sha256=U-uwkjLkdcK1IkliQ6UGY_jKRUJEgN1K_2xQEHTB9Yk,34122
+mcp_use-1.3.9.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+mcp_use-1.3.9.dist-info/licenses/LICENSE,sha256=7Pw7dbwJSBw8zH-WE03JnR5uXvitRtaGTP9QWPcexcs,1068
+mcp_use-1.3.9.dist-info/RECORD,,