mcp-use 1.3.12__py3-none-any.whl → 1.4.0__py3-none-any.whl

mcp_use/task_managers/websocket.py

@@ -1,68 +1,18 @@
-"""
-WebSocket connection management for MCP implementations.
+# mcp_use/task_managers/websocket.py
+import warnings
 
-This module provides a connection manager for WebSocket-based MCP connections.
-"""
+from typing_extensions import deprecated
 
-from typing import Any
+from mcp_use.client.task_managers.websocket import WebSocketConnectionManager as _WebSocketConnectionManager
 
-from mcp.client.websocket import websocket_client
+warnings.warn(
+    "mcp_use.task_managers.websocket is deprecated. "
+    "Use mcp_use.client.task_managers.websocket. "
+    "This import will be removed in version 1.4.0",
+    DeprecationWarning,
+    stacklevel=2,
+)
 
-from ..logging import logger
-from .base import ConnectionManager
 
-
-class WebSocketConnectionManager(ConnectionManager[tuple[Any, Any]]):
-    """Connection manager for WebSocket-based MCP connections.
-
-    This class handles the lifecycle of WebSocket connections, ensuring proper
-    connection establishment and cleanup.
-    """
-
-    def __init__(
-        self,
-        url: str,
-        headers: dict[str, str] | None = None,
-    ):
-        """Initialize a new WebSocket connection manager.
-
-        Args:
-            url: The WebSocket URL to connect to
-            headers: Optional HTTP headers
-        """
-        super().__init__()
-        self.url = url
-        self.headers = headers or {}
-
-    async def _establish_connection(self) -> tuple[Any, Any]:
-        """Establish a WebSocket connection.
-
-        Returns:
-            The established WebSocket connection
-
-        Raises:
-            Exception: If connection cannot be established
-        """
-        logger.debug(f"Connecting to WebSocket: {self.url}")
-        # Create the context manager
-        # Note: The current MCP websocket_client implementation doesn't support headers
-        # If headers need to be passed, this would need to be updated when MCP supports it
-        self._ws_ctx = websocket_client(self.url)
-
-        # Enter the context manager
-        read_stream, write_stream = await self._ws_ctx.__aenter__()
-
-        # Return the streams
-        return (read_stream, write_stream)
-
-    async def _close_connection(self) -> None:
-        """Close the WebSocket connection."""
-        if self._ws_ctx:
-            # Exit the context manager
-            try:
-                logger.debug("Closing WebSocket connection")
-                await self._ws_ctx.__aexit__(None, None, None)
-            except Exception as e:
-                logger.warning(f"Error closing WebSocket connection: {e}")
-            finally:
-                self._ws_ctx = None
+@deprecated("Use mcp_use.client.task_managers.websocket.WebSocketConnectionManager")
+class WebSocketConnectionManager(_WebSocketConnectionManager): ...

mcp_use/telemetry/events.py

@@ -91,3 +91,61 @@ class MCPAgentExecutionEvent(BaseTelemetryEvent):
             "error_type": self.error_type,
             "conversation_history_length": self.conversation_history_length,
         }
+
+
+@dataclass
+class FeatureUsageEvent(BaseTelemetryEvent):
+    """Event for tracking feature usage across the library"""
+
+    feature_name: str
+    class_name: str
+    method_name: str
+    success: bool
+    execution_time_ms: int | None = None
+    error_type: str | None = None
+    additional_properties: dict[str, Any] | None = None
+
+    @property
+    def name(self) -> str:
+        return "feature_usage"
+
+    @property
+    def properties(self) -> dict[str, Any]:
+        props = {
+            "feature_name": self.feature_name,
+            "class_name": self.class_name,
+            "method_name": self.method_name,
+            "success": self.success,
+            "execution_time_ms": self.execution_time_ms,
+            "error_type": self.error_type,
+        }
+        if self.additional_properties:
+            props.update(self.additional_properties)
+        return props
+
+
+@dataclass
+class CLICommandEvent(BaseTelemetryEvent):
+    """Event for tracking CLI command usage"""
+
+    command: str
+    success: bool
+    execution_time_ms: int | None = None
+    error_type: str | None = None
+    additional_properties: dict[str, Any] | None = None
+
+    @property
+    def name(self) -> str:
+        return "cli_command"
+
+    @property
+    def properties(self) -> dict[str, Any]:
+        props = {
+            "command": self.command,
+            "success": self.success,
+            "execution_time_ms": self.execution_time_ms,
+            "error_type": self.error_type,
+        }
+        if self.additional_properties:
+            props.update(self.additional_properties)
+        return props

mcp_use/telemetry/telemetry.py

@@ -1,6 +1,7 @@
 import logging
 import os
 import platform
+import time
 import uuid
 from collections.abc import Callable
 from functools import wraps
@@ -11,7 +12,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, FeatureUsageEvent, MCPAgentExecutionEvent
 from mcp_use.telemetry.utils import get_package_version
 from mcp_use.utils import singleton
 
@@ -30,6 +31,52 @@ def requires_telemetry(func: Callable) -> Callable:
     return wrapper
 
 
+def telemetry(feature_name: str, additional_properties: dict[str, Any] | None = None):
+    """Decorator to automatically track feature usage"""
+
+    def decorator(func: Callable) -> Callable:
+        @wraps(func)
+        def wrapper(self, *args, **kwargs):
+            start_time = time.time()
+            success = True
+            error_type = None
+
+            try:
+                result = func(self, *args, **kwargs)
+                return result
+            except Exception as e:
+                success = False
+                error_type = type(e).__name__
+                raise
+            finally:
+                execution_time_ms = int((time.time() - start_time) * 1000)
+
+                # Get telemetry instance (try common patterns)
+                telemetry = None
+                if hasattr(self, "telemetry"):
+                    telemetry = self.telemetry
+                elif hasattr(self, "_telemetry"):
+                    telemetry = self._telemetry
+                else:
+                    # Fallback to singleton instance
+                    telemetry = Telemetry()
+
+                if telemetry:
+                    telemetry.telemetry(
+                        feature_name=feature_name,
+                        class_name=self.__class__.__name__,
+                        method_name=func.__name__,
+                        success=success,
+                        execution_time_ms=execution_time_ms,
+                        error_type=error_type,
+                        additional_properties=additional_properties,
+                    )
+
+        return wrapper
+
+    return decorator
+
+
 def get_cache_home() -> Path:
     """Get platform-appropriate cache directory."""
     # XDG_CACHE_HOME for Linux and manually set envs
@@ -272,6 +319,29 @@ class Telemetry:
         )
         self.capture(event)
 
+    @requires_telemetry
+    def telemetry(
+        self,
+        feature_name: str,
+        class_name: str,
+        method_name: str,
+        success: bool,
+        execution_time_ms: int | None = None,
+        error_type: str | None = None,
+        additional_properties: dict[str, Any] | None = None,
+    ) -> None:
+        """Track feature usage across the library"""
+        event = FeatureUsageEvent(
+            feature_name=feature_name,
+            class_name=class_name,
+            method_name=method_name,
+            success=success,
+            execution_time_ms=execution_time_ms,
+            error_type=error_type,
+            additional_properties=additional_properties,
+        )
+        self.capture(event)
+
     @requires_telemetry
     def flush(self) -> None:
         """Flush any queued telemetry events"""

mcp_use/telemetry/utils.py

@@ -7,7 +7,7 @@ from LangChain language models for telemetry purposes.
 
 import importlib.metadata
 
-from langchain_core.language_models.base import BaseLanguageModel
+from langchain_core.language_models import BaseLanguageModel
 
 
 def get_package_version() -> str:

mcp_use/types/sandbox.py

@@ -1,23 +1,18 @@
-"""Type definitions for sandbox-related configurations."""
+# mcp_use/types/sandbox.py
+import warnings
 
-from typing import NotRequired, TypedDict
+from typing_extensions import deprecated
 
+from mcp_use.client.connectors.sandbox import SandboxOptions as _SandboxOptions
 
-class SandboxOptions(TypedDict):
-    """Configuration options for sandbox execution.
+warnings.warn(
+    "mcp_use.types.sandbox is deprecated. "
+    "Use mcp_use.client.connectors.sandbox. "
+    "This import will be removed in version 1.4.0",
+    DeprecationWarning,
+    stacklevel=2,
+)
 
-    This type defines the configuration options available when running
-    MCP servers in a sandboxed environment (e.g., using E2B).
-    """
 
-    api_key: str
-    """Direct API key for sandbox provider (e.g., E2B API key).
-    If not provided, will use E2B_API_KEY environment variable."""
-
-    sandbox_template_id: NotRequired[str]
-    """Template ID for the sandbox environment.
-    Default: 'base'"""
-
-    supergateway_command: NotRequired[str]
-    """Command to run supergateway.
-    Default: 'npx -y supergateway'"""
+@deprecated("Use mcp_use.client.connectors.sandbox.SandboxOptions")
+class SandboxOptions(_SandboxOptions): ...

{mcp_use-1.3.12.dist-info → mcp_use-1.4.0.dist-info}/METADATA

@@ -1,10 +1,9 @@
 Metadata-Version: 2.4
 Name: mcp-use
-Version: 1.3.12
+Version: 1.4.0
 Summary: MCP Library for LLMs
-Author-email: Pietro Zullo <pietro.zullo@gmail.com>
+Author-email: "mcp-use, Inc." <dev@mcp-use.io>, Pietro Zullo <pietro.zullo@gmail.com>
 License: MIT
-License-File: LICENSE
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -17,7 +16,8 @@ Requires-Python: >=3.11
 Requires-Dist: aiohttp>=3.9.0
 Requires-Dist: authlib>=1.6.3
 Requires-Dist: jsonschema-pydantic>=0.1.0
-Requires-Dist: langchain>=0.1.0
+Requires-Dist: langchain-core>=1.0.0
+Requires-Dist: langchain>=1.0.0
 Requires-Dist: mcp>=1.10.0
 Requires-Dist: posthog>=4.8.0
 Requires-Dist: pydantic-core==2.33.2
@@ -54,8 +54,7 @@ Description-Content-Type: text/markdown
   </picture>
 </div>
 
-
-<h1 align="center">🚀 Create MCP Clients and Agents</h1>
+<h1 align="center">🚀 mcp-use for Python</h1>
 <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>
@@ -63,37 +62,42 @@ Description-Content-Type: text/markdown
         <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://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">
-        <img src="https://img.shields.io/badge/website-mcp--use.com-blue" /></a>
-    </p>
-    <p align="center">
-    <a href="https://x.com/pietrozullo" alt="Twitter Follow - Pietro">
-        <img src="https://img.shields.io/twitter/follow/Pietro?style=social" /></a>
-    <a href="https://x.com/pederzh" alt="Twitter Follow - Luigi">
-        <img src="https://img.shields.io/twitter/follow/Luigi?style=social" /></a>
     <a href="https://discord.gg/XkNkSkMz3V" alt="Discord">
         <img src="https://dcbadge.limes.pink/api/server/XkNkSkMz3V?style=flat" /></a>
 </p>
 </div>
 
-🌐 MCP-Use is the open source way to connect **any LLM to any MCP server** and build custom MCP agents that have tool access, without using closed source or application clients.
+> **📦 Part of the [mcp-use Monorepo](../../README.md)** - This is the Python implementation. Also available in [TypeScript](../typescript/README.md).
+
+🌐 **mcp-use for Python** is the complete way to connect **any LLM to any MCP server** and build custom MCP agents with tool access.
+
+💡 Let your Python applications leverage the power of the Model Context Protocol with support for agents, clients, and advanced features.
+
+## 🏗️ What's Included
+
+mcp-use for Python provides three main capabilities:
+
+- **🤖 MCP Agent** - Build AI agents that can use tools and reason across multiple steps
+- **🔌 MCP Client** - Connect directly to MCP servers for programmatic tool access
+- **🛠️ MCP Server** - _Coming soon!_ For now, use the [TypeScript version](../typescript/README.md#%EF%B8%8F-mcp-server-framework)
 
-💡 Let developers easily connect any LLM to tools like web browsing, file operations, and more.
+---
 
-- If you want to get started quickly check out [mcp-use.com website](https://mcp-use.com/) to build and deploy agents with your favorite MCP servers.
-- 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)
+## 📖 Quick Links
 
-| 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) [![Authentication](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-authentication&label=Authentication&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)                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+- **[Main Repository](../../README.md)** - Overview of the entire mcp-use ecosystem
+- **[TypeScript Version](../typescript/README.md)** - TypeScript implementation with server framework
+- **[Documentation](https://docs.mcp-use.com)** - Complete online documentation
+- **[Examples](./examples/)** - Python code examples
+
+| Supports       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| :------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Primitives** | [![Tools](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/ci.yml?job=python-primitive/tools&label=Tools&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/ci.yml) [![Resources](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/ci.yml?job=python-primitive/resources&label=Resources&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/ci.yml) [![Prompts](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/ci.yml?job=python-primitive/prompts&label=Prompts&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/ci.yml) [![Sampling](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/ci.yml?job=python-primitive/sampling&label=Sampling&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/ci.yml) [![Elicitation](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/ci.yml?job=python-primitive/elicitation&label=Elicitation&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/ci.yml) [![Authentication](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/ci.yml?job=python-primitive/authentication&label=Authentication&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/ci.yml) |
+| **Transports** | [![Stdio](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/ci.yml?job=python-transport/stdio&label=Stdio&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/ci.yml) [![SSE](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/ci.yml?job=python-transport/sse&label=SSE&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/ci.yml) [![Streamable HTTP](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/ci.yml?job=python-transport/streamable_http&label=Streamable%20HTTP&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/ci.yml)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
 
 ## Features
 
@@ -140,7 +144,13 @@ Description-Content-Type: text/markdown
   </tr>
 </table>
 
-# Quick start
+---
+
+# 🤖 MCP Agent
+
+The **MCP Agent** is an AI-powered agent that can use tools from MCP servers to accomplish complex tasks. It reasons across multiple steps, selecting and executing tools as needed.
+
+## Quick Start
 
 With pip:
 
@@ -250,7 +260,7 @@ For other settings, models, and more, check out the documentation.
 
 ## Streaming Agent Output
 
-MCP-Use supports asynchronous streaming of agent output using the `stream` method on `MCPAgent`. This allows you to receive incremental results, tool actions, and intermediate steps as they are generated by the agent, enabling real-time feedback and progress reporting.
+mcp-use supports asynchronous streaming of agent output using the `stream` method on `MCPAgent`. This allows you to receive incremental results, tool actions, and intermediate steps as they are generated by the agent, enabling real-time feedback and progress reporting.
 
 ### How to use
 
@@ -423,7 +433,7 @@ if __name__ == "__main__":
 
 ## HTTP Connection Example
 
-MCP-Use supports HTTP connections, allowing you to connect to MCP servers running on specific HTTP ports. This feature is particularly useful for integrating with web-based MCP servers.
+mcp-use supports HTTP connections, allowing you to connect to MCP servers running on specific HTTP ports. This feature is particularly useful for integrating with web-based MCP servers.
 
 Here's an example of how to use the HTTP connection feature:
 
@@ -472,7 +482,7 @@ This example demonstrates how to connect to an MCP server running on a specific
 
 # Multi-Server Support
 
-MCP-Use allows configuring and connecting to multiple MCP servers simultaneously using the `MCPClient`. This enables complex workflows that require tools from different servers, such as web browsing combined with file operations or 3D modeling.
+mcp-use allows configuring and connecting to multiple MCP servers simultaneously using the `MCPClient`. This enables complex workflows that require tools from different servers, such as web browsing combined with file operations or 3D modeling.
 
 ## Configuration
 
@@ -554,7 +564,7 @@ if __name__ == "__main__":
 
 # Tool Access Control
 
-MCP-Use allows you to restrict which tools are available to the agent, providing better security and control over agent capabilities:
+mcp-use allows you to restrict which tools are available to the agent, providing better security and control over agent capabilities:
 
 ```python
 import asyncio
@@ -587,7 +597,7 @@ if __name__ == "__main__":
 
 # Sandboxed Execution
 
-MCP-Use supports running MCP servers in a sandboxed environment using E2B's cloud infrastructure. This allows you to run MCP servers without having to install dependencies locally, making it easier to use tools that might have complex setups or system requirements.
+mcp-use supports running MCP servers in a sandboxed environment using E2B's cloud infrastructure. This allows you to run MCP servers without having to install dependencies locally, making it easier to use tools that might have complex setups or system requirements.
 
 ## Installation
 
@@ -675,7 +685,13 @@ 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)
+---
+
+# 🔌 MCP Client
+
+The **MCP Client** allows you to connect directly to MCP servers and call tools programmatically without an AI agent. This is useful when you know exactly which tools to call and don't need AI reasoning.
+
+## Direct Tool Calls (Without LLM)
 
 You can call MCP server tools directly without an LLM when you need programmatic control:
 
@@ -752,9 +768,26 @@ if __name__ == "__main__":
 
 ```
 
+---
+
+# 🛠️ MCP Server
+
+**Coming Soon!** Python support for creating MCP servers is under development.
+
+In the meantime, you can create MCP servers using our [TypeScript implementation](../typescript/README.md#%EF%B8%8F-mcp-server-framework), which offers:
+
+- Complete server framework with tools, resources, and prompts
+- Built-in inspector for debugging
+- React-based UI widgets for interactive experiences
+- Hot reload development workflow
+
+Python agents and clients can connect to TypeScript servers seamlessly - the MCP protocol is language-agnostic.
+
+---
+
 # Debugging
 
-MCP-Use provides a built-in debug mode that increases log verbosity and helps diagnose issues in your agent implementation.
+mcp-use provides a built-in debug mode that increases log verbosity and helps diagnose issues in your agent implementation.
 
 ## Enabling Debug Mode
 
@@ -815,14 +848,6 @@ This is useful when you only need to see the agent's steps and decision-making p
 
 We love contributions! Feel free to open issues for bugs or feature requests. Look at [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
 
-## Contributors
-
-Thanks to all our amazing contributors!
-
-<a href="https://github.com/mcp-use/mcp-use/graphs/contributors">
-  <img src="https://contrib.rocks/image?repo=mcp-use/mcp-use" />
-</a>
-
 ## Top Starred Dependents
 
 <!-- gh-dependents-info-used-by-start -->
@@ -888,12 +913,12 @@ MIT
 
 # Citation
 
-If you use MCP-Use in your research or project, please cite:
+If you use mcp-use in your research or project, please cite:
 
 ```bibtex
 @software{mcp_use2025,
   author = {Zullo, Pietro},
-  title = {MCP-Use: MCP Library for Python},
+  title = {mcp-use: MCP Library for Python},
   year = {2025},
   publisher = {GitHub},
   url = {https://github.com/pietrozullo/mcp-use}

mcp_use-1.4.0.dist-info/RECORD

@@ -0,0 +1,111 @@
+mcp_use/__init__.py,sha256=0LfDNKkzNXXOx9B4-SsMIuwkj9Cm-8JVPmC9yb5cFnw,1277
+mcp_use/client.py,sha256=m-nwSnO147tBXji0KmXULJ2B1Uy7cGidnutRTnASmjU,426
+mcp_use/config.py,sha256=RNYKUJPEpLGZQFg-ahwsYf1B7xXZM1gUA-_57FngAJc,760
+mcp_use/exceptions.py,sha256=YAbLz1S_4aQiNGWgh80lk0lwgF3L109P-cjbV_QW-WQ,1260
+mcp_use/logging.py,sha256=y0BEx1bofSehRqGIe6oTRtHDqTb_KnmAxcH6V1oR6Do,4976
+mcp_use/session.py,sha256=2exxHhIfXcf6UFndiwmi-db3Wvh_Dqeh89iiSIcFtYY,438
+mcp_use/utils.py,sha256=QavJcVq2WxUUUCCpPCUeOB5bqIS0FFmpK-RAZkGc6aA,720
+mcp_use/adapters/.deprecated,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mcp_use/adapters/__init__.py,sha256=p0J4T9vTeNPXVEcNJUV7WQJB8Bd8lWwbxZ9KT4kDxjQ,604
+mcp_use/adapters/base.py,sha256=Cc-stCnM6j0JtQeR1j1sqQX0ZtHjWUFdRNKsHiQv6mQ,444
+mcp_use/adapters/langchain_adapter.py,sha256=LDlCvqnWDNmY1YxNKYX9PafNZl9o8LMXwp3W4XQaJLY,541
+mcp_use/agents/__init__.py,sha256=FzkntihbAqzixWdWe99zIrrcIfd4N3YWltNniutG9VA,267
+mcp_use/agents/base.py,sha256=3hlKEnSq89yMdd6tBN_FPfx-aPj7En0yNqE7EqTQpVQ,1604
+mcp_use/agents/mcpagent.py,sha256=tiPFeN5oFwch3ULD8Ggcn4cl3v5tFknC4VtgJebDkzU,49586
+mcp_use/agents/remote.py,sha256=wBzkU7rgkA1EBMSfedyLsA01Rz4I2AXPwo-z607Uy2Q,16511
+mcp_use/agents/adapters/__init__.py,sha256=VIxigHnP0ZBUTFV3bQlxnYNgXhawkuoY7OtYe6dZiqw,582
+mcp_use/agents/adapters/anthropic.py,sha256=EZ8XEArYaXacmqCKC4aEhiHNI-rfEBP3Y9GPHt08Uow,3753
+mcp_use/agents/adapters/base.py,sha256=37GjE3WiBfatoT5AnXXPkbxa18WROdP6-MQBKTLbv5k,12398
+mcp_use/agents/adapters/google.py,sha256=YCBrYJFbqnKBxMrzmk0tGUQcBT3knAH5zEzLQ7O2nTU,4284
+mcp_use/agents/adapters/langchain_adapter.py,sha256=eu4_71VE7cURj493FtZRGwiWBZFtWCPeC3AHlPSzys0,8865
+mcp_use/agents/adapters/openai.py,sha256=pItLuNbuzrGydmxEzxidNkTNITCleQInUwYxdmHD1C8,4236
+mcp_use/agents/managers/__init__.py,sha256=FRTuJw5kYtY1Eo7wN9Aeqeqo1euiR5slvrx5Fl_SGvk,383
+mcp_use/agents/managers/base.py,sha256=fJA4ct6GIcACOzmCSQGga1HoHYjsauaMHZsXehCPQNA,1138
+mcp_use/agents/managers/server_manager.py,sha256=MdsttZ3zl0sMUslZTfZ6xNZkDNTIK9_TggDKT-LY5mw,5485
+mcp_use/agents/managers/tools/__init__.py,sha256=zcpm4HXsp8NUMRJeyT6DdB8cgIMDs46pBfoTD-odhGU,437
+mcp_use/agents/managers/tools/base_tool.py,sha256=Jbbp7SwmHKDk8jT_6yVIv7iNsn6KaV_PljWuhhLcbXg,509
+mcp_use/agents/managers/tools/connect_server.py,sha256=Mf_1w4svnRXljzBMv_3p1dyQr_O53yn4cRuydqJ9fFQ,2992
+mcp_use/agents/managers/tools/disconnect_server.py,sha256=hhrMSxFnU3k1ByE7Uqbfkjuwo0o95xCz39mXjkvrI0Y,1650
+mcp_use/agents/managers/tools/get_active_server.py,sha256=_fWKq44EHBMu9eMV7exYw7L1SZZQf3L19fw4hAX594E,993
+mcp_use/agents/managers/tools/list_servers_tool.py,sha256=bi_naHOetXnn6ZhHqwU3NgWUebXwp2CaifZZfD3J0E0,2065
+mcp_use/agents/managers/tools/search_tools.py,sha256=Rht0NZJ9W8mi5PzXgs3mALuGscMDYB3ylpm9LoAMdkE,12945
+mcp_use/agents/observability/__init__.py,sha256=qJR51lpW6lVvhgNnUHBXYN6FKn4kDKbGVHUhPzrx324,348
+mcp_use/agents/observability/callbacks_manager.py,sha256=6jIcE6ofiLRxoi4fECaTlpnllTEFQdwB0IZ0ZkY0WAQ,5324
+mcp_use/agents/observability/laminar.py,sha256=eBY23B8rxQOW5ggHeGB0ZCpCSMnK4rC8fBOvDdbuoq4,1613
+mcp_use/agents/observability/langfuse.py,sha256=kOF05cbSEir7r3fibx_q6TfKzqmbjKLV7uNxBote9XY,2677
+mcp_use/agents/prompts/system_prompt_builder.py,sha256=1Nt4JA_WZFuTiA-cz5EA9_pUHBzLIO1yR2_pMvaa_-U,4123
+mcp_use/agents/prompts/templates.py,sha256=Yd-3NILgHXTrBUw9WE11gt0-QrlvN1pykeEpg3LY4HU,1545
+mcp_use/auth/.deprecated,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mcp_use/auth/__init__.py,sha256=5ZetbbZDfGI4vli6tgHt-XTAEZh7fqn_eHdF0Rirsf4,516
+mcp_use/auth/bearer.py,sha256=iZQgutjUS8GzarNQOFa_s3Wq-Rl71nzKG-FhYHWC2n4,422
+mcp_use/auth/oauth.py,sha256=ztdXsd7F5xMJiHOeJiCCUiZSV2cKW5k4s2rhxXUCIwo,392
+mcp_use/auth/oauth_callback.py,sha256=6kLYBL9M-CoOZ_HX6ezgcVCbRk1RBnBXpCNaamCFazk,726
+mcp_use/client/__init__.py,sha256=KJzHv7qafMFqE38TGAowled4Ka3dWvqq80GEQfx99JI,30
+mcp_use/client/client.py,sha256=TKDoKKusVkRqZzqh_B2xBMsHLOLbFgic3I4t2ZJEqJg,13072
+mcp_use/client/config.py,sha256=bnPXOno47VfEGGdDeOwyJZlr7gXw1KInABoRhiZ4_fw,3837
+mcp_use/client/exceptions.py,sha256=PuzPj_Ov4oYJ8ny8BC6S1b9RRy39gtRotDhIaMulxQE,468
+mcp_use/client/session.py,sha256=DPud5dMil3lJq9pUQq4z9IpWCy_xRmpzKeCVLVzNKp8,5031
+mcp_use/client/auth/__init__.py,sha256=TBNMvgRDp-lC3n2f0UB6kZUZlJ35SYRBVDt3hadpvXI,138
+mcp_use/client/auth/bearer.py,sha256=wgG3_TZDNoqo7hnezLHqOZpsWFOAXTxFbIg6t1qemQ8,678
+mcp_use/client/auth/oauth.py,sha256=HU1sxo74L-0Gf-VbK4FmSrZKoxkJg4bW50emUakYBoE,27801
+mcp_use/client/auth/oauth_callback.py,sha256=BRdVnbt1SENvsrudBFUB_XYhRb1G30Qjf8x5Vw1xZzo,7558
+mcp_use/client/connectors/__init__.py,sha256=cUF4yT0bNr8qeLkSzg28SHueiV5qDaHEB1l1GZ2K0dc,536
+mcp_use/client/connectors/base.py,sha256=R5NbN_NGuJnT82cGMweOaAdA5g6mZnsN4KyqG0_XffE,18687
+mcp_use/client/connectors/http.py,sha256=LFk8QLx4GBYWe7lYWHXfC8HH97lOSFAJRuhW7XlkLY8,13742
+mcp_use/client/connectors/sandbox.py,sha256=ukCGi50ZplmKViW8WagoyoznuugMETlgvilGGR9LcP0,12827
+mcp_use/client/connectors/stdio.py,sha256=Iy3mQ08T0DI-ufArM7F2kavy8rCsrk96P-UJiaUQjUM,4129
+mcp_use/client/connectors/utils.py,sha256=zQ8GdNQx0Twz3by90BoU1RsWPf9wODGof4K3-NxPXeA,366
+mcp_use/client/connectors/websocket.py,sha256=-fcXsLJtJ5xVa46AiXdpj_Echbzet_1XZoSbi8lwEf0,10169
+mcp_use/client/middleware/__init__.py,sha256=p9cTU5ZdeHys7RnhRh-y2-kc5OjPj3cL_Yk3kbl5Vqw,1354
+mcp_use/client/middleware/logging.py,sha256=Q-sDUFHZkmgxZxF8CWOal9CsOOs4EBlITxIQO3CkqHc,1184
+mcp_use/client/middleware/metrics.py,sha256=NnsP0n1Ta-hnCxPFvdlQAFi5D1BCGvkl1MepaGd5-Vo,13203
+mcp_use/client/middleware/middleware.py,sha256=08H79bufrA3pS0DN3SRbMbfUh6NO7iCdHokkSBvvrfg,9770
+mcp_use/client/task_managers/__init__.py,sha256=LkXOjiDq5JcyB2tNJuSzyjbxZTl1Ordr_NKKD77Nb7g,557
+mcp_use/client/task_managers/base.py,sha256=1Yu4QUWBdOqDzIS0QNh1l_sQpWvqMFPYPWmmHkq6d6Q,4654
+mcp_use/client/task_managers/sse.py,sha256=H2cqSXUjtUZ-_9bX-7lh_0wfuS03ZtxNrVtSZ2RMyGY,2597
+mcp_use/client/task_managers/stdio.py,sha256=qKKr1rqISrJLVbFLdVaYwovm5vUqBkpdCmebkrkueHw,2164
+mcp_use/client/task_managers/streamable_http.py,sha256=BxgFLAnRUPDKijjSMcqWVfWiBinUexBMb4SdzzyPBvM,2889
+mcp_use/client/task_managers/websocket.py,sha256=MCe_TS2xu42YK_RbSZLoEsKs7L1WpR7sdaBz5rXuc1M,2188
+mcp_use/connectors/.deprecated,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mcp_use/connectors/__init__.py,sha256=AILLEsQuwi1P9hjSn7Gbh6g-2ab3mXQEAZapbLXVmSE,1219
+mcp_use/connectors/base.py,sha256=n-d0yHA6trrADzaUHZA6zk_p5yauBpKqTDZ5-I1GJEA,471
+mcp_use/connectors/http.py,sha256=tfxHsuBZRu76HdMUQFrRiQpYug9bo5x77RM9iI08BOI,471
+mcp_use/connectors/sandbox.py,sha256=Rz8m6r3RCO-meJNhafGj7eD86SnLQQeVYgNtyfZB3nI,501
+mcp_use/connectors/stdio.py,sha256=ls5OBl3OUW0kkXag0_z-530LKgll6xt8uS8jvwqJ_vQ,481
+mcp_use/connectors/utils.py,sha256=mE5jRP3rV2KIt_LvBxg42zqihvcXpz_n2UJa4gV9eSk,567
+mcp_use/connectors/websocket.py,sha256=Q5B69AfXyA_mZc8s1kZZzCbTurjZLAaEutm1pMIYN2E,521
+mcp_use/errors/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+mcp_use/errors/error_formatting.py,sha256=17lhj5goGHuTbJ5oLCUXyJ2SuIbzsuSM1Wk8LPeqY9k,911
+mcp_use/managers/.deprecated,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mcp_use/managers/__init__.py,sha256=N5iDLaNOXEowp9Cp7YsuWtIoFoR2YhpKlpTXcptxD6I,1700
+mcp_use/managers/base.py,sha256=5oHTD29MHrgfbqC6b1Za6ndGf4cnOdboFfyr90QRo18,481
+mcp_use/managers/server_manager.py,sha256=TbWcxoOTV3IN8FPRBDyvpYYTJWR42acBQ1MpxS5a-wg,511
+mcp_use/managers/tools/__init__.py,sha256=AlBiKWRNkbf0neyMj95TSvC0zGO1ECncMdi6EahkWfY,1318
+mcp_use/managers/tools/base_tool.py,sha256=sohFFzlfKA9bUZ-CtuZytf7EW1z4GM7MoIUV9FxO32Y,280
+mcp_use/managers/tools/connect_server.py,sha256=OvKWKhgqotnTnmU2CcmzhTmc6CkbIfRCztV_zZsg218,315
+mcp_use/managers/tools/disconnect_server.py,sha256=f-ThxEhVvba8SnsFIxt4MeGCufBoB1Itidjhq53_nD0,339
+mcp_use/managers/tools/get_active_server.py,sha256=6msUfr-uabkFbB3lPKu8hcs_nO9EF6JIlLu-GnUQ0cE,334
+mcp_use/managers/tools/list_servers_tool.py,sha256=xFuDD5B4RgxuwRBuXVn0CoR6h6cx87wsU-acD8b1SrU,314
+mcp_use/managers/tools/search_tools.py,sha256=kYtRuUIawugATYuLXDS2sIpyv2bJrLiKLQO3U3L1AFA,763
+mcp_use/middleware/.deprecated,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mcp_use/middleware/__init__.py,sha256=imBkKYNUT5pZvt9AkU6JoUSREGxLhhU6wQleA5mTNiE,2668
+mcp_use/middleware/logging.py,sha256=T2B4WxEcnSfNQiG9s97swkfPAAUNsDbqcRhlmsKhdO8,589
+mcp_use/middleware/metrics.py,sha256=ky7jokRD30QM0Gl1IulFwzcsFPCXiSuRFs_8UGz1Vr8,1301
+mcp_use/middleware/middleware.py,sha256=5o-le09nko9nlhWGkNab_0OSVBn5jxVKf-NjrHrTTmA,1615
+mcp_use/task_managers/.deprecated,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mcp_use/task_managers/__init__.py,sha256=wLyZgkCRooIDTcX871cr-jHVm-e5kutIThxz17eSNf0,1482
+mcp_use/task_managers/base.py,sha256=cAP6PA_RMjA1rw-2-tnpya96HbKWkEkQibmgkeZfNUA,506
+mcp_use/task_managers/sse.py,sha256=2W3o737M96ZFVhB2pxd-SrJ4mrmTaKDm_OdklseEy3Y,516
+mcp_use/task_managers/stdio.py,sha256=JS6jAzsPEuzriuQ-Sib4WW1rsUgxMYZkUwN6BVhiFt4,536
+mcp_use/task_managers/streamable_http.py,sha256=NiyYHZ5fLgqYNvFEoWLzLQw9AByscnPWBG4k-whLfZ8,640
+mcp_use/task_managers/websocket.py,sha256=cis-KJFccCi55rvk-FVlKFtncGNnm8QiNcpwzuaBEM8,576
+mcp_use/telemetry/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mcp_use/telemetry/events.py,sha256=4u-PWeg03jozG9rLunDB7JHtFmmesgu3J8aRAq93qAU,4706
+mcp_use/telemetry/telemetry.py,sha256=uCOGRDNTyDfyvBGypGUpTk9-IGOe2P7CbUQjPlnkQ9Y,14082
+mcp_use/telemetry/utils.py,sha256=_nPJU7e1XZeUWcWKmumbhNcC2OEAU1wvNXJe3CNgHEY,1764
+mcp_use/types/.deprecated,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mcp_use/types/sandbox.py,sha256=gaZaLE-i6rftaIF-OYyMDc1W6Il-g4MpFbCD1IdyBPg,481
+mcp_use-1.4.0.dist-info/METADATA,sha256=pnimjYDLE5DteEtiB0eIH5QuyQTbILh7etAlnLrdOc4,35394
+mcp_use-1.4.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+mcp_use-1.4.0.dist-info/entry_points.txt,sha256=3jzEN6xbVsMErm_cxlHpCzvM97gFgjvtOEEspUp1vK8,45
+mcp_use-1.4.0.dist-info/RECORD,,