Update app.py

app.py

@@ -260,10 +260,51 @@ def Fetch_Webpage(  # <-- MCP tool #1 (Fetch)
     max_links: int = 20,
 ) -> str:
     """
-    Fetch a web page and return a compact Markdown summary that includes title, key
+    Fetch a web page and return a compact Markdown summary containing title, key
     metadata, readable main text, and outbound links.
 
-    (Layman's terms: summarize a page with clean text + useful details.)
+    This function powers the MCP tool "Fetch_Webpage". Descriptions below are
+    provided explicitly for MCP clients that surface parameter help.
+
+    Args:
+        url (str):
+            The absolute URL to fetch. Must return HTML. Example:
+            "https://example.com/article".
+        verbosity (str, optional):
+            Controls how much body text to include. One of:
+            - "Brief" (about 800–1200 chars)
+            - "Standard" (about 3000 chars)
+            - "Full" (no practical cap apart from max_chars)
+            Default: "Standard".
+        include_metadata (bool, optional):
+            If True, include a Metadata section with description, site name,
+            canonical URL, language, and fetched URL. Default: True.
+        include_text (bool, optional):
+            If True, include the readable main text extracted with Readability.
+            Default: True.
+        include_links (bool, optional):
+            If True, include outbound links discovered in the readable section
+            of the page. Default: True.
+        max_chars (int, optional):
+            Hard maximum number of characters for the body text, applied after
+            the verbosity preset. Use 0 or a negative value to disable the cap
+            (the verbosity preset will still apply). Default: 3000.
+        max_links (int, optional):
+            Maximum number of links to include. Set 0 to omit links even if
+            include_links=True. Default: 20.
+
+    Returns:
+        str: Markdown that may contain the following sections:
+            - Title (H1)
+            - Metadata (optional)
+            - Text (optional, may be trimmed)
+            - Links (optional, deduped and absolute)
+
+    Notes:
+        - Only HTML content types are supported. Non-HTML responses return a
+          short message indicating the unsupported content type.
+        - Link text is shortened to keep tokens small; URLs are absolute and
+          fragments are removed.
     """
     if not url or not url.strip():
         return "Please enter a valid URL."
@@ -335,10 +376,35 @@ def Search_DuckDuckGo(  # <-- MCP tool #2 (DDG Search)
     title_chars: int = 80,
 ) -> str:
     """
-    Run a DuckDuckGo search and return ultra-compact JSONL lines with short keys to
+    Run a DuckDuckGo search and return ultra-compact JSONL with short keys to
     minimize tokens.
 
-    (Layman's terms: the tiniest useful search output possible.)
+    This function powers the MCP tool "Search_DuckDuckGo". Each line in the
+    output is a JSON object using short keys to reduce token usage.
+
+    Args:
+        query (str):
+            The search query. Examples: "langchain streaming" or
+            "vector database site:docs.pinecone.io".
+        max_results (int, optional):
+            Maximum number of results to return. Range: 1–20. Default: 5.
+        include_snippets (bool, optional):
+            If True, includes a short snippet for each result (key "s"). This
+            increases tokens. Default: False.
+        max_snippet_chars (int, optional):
+            Character cap applied to each snippet when include_snippets=True.
+            Default: 80.
+        dedupe_domains (bool, optional):
+            If True, only the first result from each domain is kept. Default: True.
+        title_chars (int, optional):
+            Character cap applied to titles. Default: 80.
+
+    Returns:
+        str: Newline-delimited JSON (JSONL). Each line has:
+            {"t": "title", "u": "url"[, "s": "snippet"]}
+
+    Error Handling:
+        On search errors, returns a single JSON object with an "error" key.
     """
     if not query or not query.strip():
         return ""
@@ -384,8 +450,23 @@ def Search_DuckDuckGo(  # <-- MCP tool #2 (DDG Search)
 
 def Execute_Python(code: str) -> str:
     """
-    Execute Python code and return the stdout or error message.
-    Mirrors the standalone code interpreter behavior.
+    Execute arbitrary Python code and return captured stdout or an error message.
+
+    This function powers the MCP tool "Execute_Python" and mirrors the
+    standalone code interpreter behavior used in the UI tab.
+
+    Args:
+        code (str):
+            The Python source code to run. The code executes in a single call
+            with a fresh global scope. Prints are captured and returned.
+
+    Returns:
+        str: Combined stdout produced by the code, or the exception text if
+        execution failed.
+
+    Security:
+        The code executes within the current Python process. Do not run
+        untrusted code in environments where it could access sensitive data.
     """
     if code is None:
         return "No code provided."