fixing mcp tools

app.py

@@ -251,7 +251,28 @@ def Fetch_Webpage(  # <-- MCP tool #1 (Fetch)
     max_links: int = 20,
 ) -> str:
     """
-    Given a URL, return a tight Markdown summary: title, key metadata, readable text, and links.
+    Fetch a web page and return a compact Markdown summary that includes title, key
+    metadata, readable main text, and outbound links.
+
+    Args:
+        url (str): The HTTP/HTTPS URL to fetch. Must be publicly reachable.
+        verbosity (str): Controls body length. One of: "Brief", "Standard", or "Full".
+            - Brief ≈ up to 1,200 chars
+            - Standard ≈ up to 3,000 chars
+            - Full = no cap (still limited by `max_chars` if smaller)
+        include_metadata (bool): If True, include a Metadata section with description,
+            site name, canonical URL, language, and fetched URL.
+        include_text (bool): If True, include the extracted readable body text.
+        include_links (bool): If True, include a list of outbound links found in the
+            readable section only (deduped and fragment-stripped).
+        max_chars (int): Hard cap for body text length. Numeric value between 400 and
+            12000. The effective cap is the smaller of this value and the preset based
+            on `verbosity`.
+        max_links (int): Maximum number of links to include. Numeric value between 0 and 100.
+
+    Returns:
+        str: Markdown string containing the extracted summary. If the page cannot be
+        fetched or parsed, a short error message is returned instead.
     """
     if not url or not url.strip():
         return "Please enter a valid URL."
@@ -314,7 +335,18 @@ def Search_Structured(  # <-- MCP tool #2 (Structured DDG)
     max_results: int = 5,
 ) -> List[Dict[Literal["snippet", "title", "link"], str]]:
     """
-    Run a DuckDuckGo search and return a list of {snippet, title, link}.
+    Run a DuckDuckGo search and return structured results as a list of dictionaries.
+
+    Args:
+        input_query (str): The search query. Supports operators like site:, quotes,
+            and boolean keywords.
+        max_results (int): Number of results to return (1–20).
+
+    Returns:
+        List[Dict[Literal["snippet","title","link"], str]]: Each item contains:
+            - snippet: Short text snippet
+            - title: Result title
+            - link: Result URL
     """
     if not input_query or not input_query.strip():
         return []
@@ -335,7 +367,15 @@ def Search_Raw(  # <-- MCP tool #3 (Unstructured DDG)
     query: str,
 ) -> list[dict]:
     """
-    Search using Native DDG client. Returns a plain list[dict] — exactly like your separate space.
+    Run a DuckDuckGo search using the native `duckduckgo_search` client and return the
+    raw Python list of dictionaries from the library.
+
+    Args:
+        query (str): The search query string.
+
+    Returns:
+        list[dict]: The unmodified objects returned by `DDGS().text(...)`, typically
+        containing keys like: title, href/link, body/snippet, source, etc.
     """
     if not query or not query.strip():
         return []
@@ -357,14 +397,26 @@ def Search_Concise(  # <-- MCP tool #4 (Concise DDG)
     title_chars: int = 80,
 ) -> str:
     """
-    Minimal-output DuckDuckGo search designed to reduce tokens:
-      - Returns newline-delimited JSON (JSONL) with short keys:
-            t=title, u=url, s=snippet
+    Run a DuckDuckGo search and return ultra-compact JSONL lines with short keys to
+    minimize tokens.
+
+    Args:
+        query (str): The search query string.
+        max_results (int): Maximum number of results to retrieve (1–20).
+        include_snippets (bool): If True, include a shortened snippet per result under
+            key "s".
+        max_snippet_chars (int): Hard cap for snippet length when `include_snippets`
+            is True. Range 20–200.
+        dedupe_domains (bool): If True, only keep the first result per domain.
+        title_chars (int): Hard cap for the title length. Range 20–120.
 
     Returns:
-      A compact string like:
-        {"t":"Example","u":"https://example.com/x"}
-        {"t":"Another…","u":"https://a.com/y","s":"Short snippet…"}
+        str: Newline-delimited JSON (JSONL). Each line is a compact JSON object with
+        short keys: "t" (title), "u" (URL), and optionally "s" (snippet).
+
+        Example lines:
+            {"t":"Example","u":"https://example.com/x"}
+            {"t":"Another…","u":"https://a.com/y","s":"Short snippet…"}
     """
     
     if not query or not query.strip():
@@ -425,6 +477,12 @@ fetch_interface = gr.Interface(
     outputs=gr.Markdown(label="Extracted Summary"),
     title="Fetch Webpage",
     description="Extract title, key metadata, readable text, and links. No noisy HTML.",
+    api_description=(
+        "Fetch a web page and return a compact Markdown summary with title, key "
+        "metadata, readable body text, and outbound links. Parameters let you "
+        "control verbosity, whether to include metadata/text/links, and limits "
+        "for characters and number of links."
+    ),
     allow_flagging="never",
     theme="Nymbo/Nymbo_Theme",
 )
@@ -439,6 +497,10 @@ websearch_interface = gr.Interface(
     outputs=gr.JSON(label="Search results"),
     title="DuckDuckGo Search (Structured)",
     description="Search the web using DuckDuckGo; returns snippet, title, and link.",
+    api_description=(
+        "Run a DuckDuckGo web search and return a list of objects with keys: "
+        "snippet, title, and link. Configure the number of results."
+    ),
     allow_flagging="never",
     theme="Nymbo/Nymbo_Theme",
 )
@@ -450,6 +512,10 @@ unstructured_interface = gr.Interface(
     outputs=gr.Textbox(label="Results", interactive=False),
     title="DuckDuckGo Search (Raw)",
     description="Returns the raw list of results (list[dict]) shown as text.",
+    api_description=(
+        "Run DuckDuckGo via the native client and return the raw list[dict] as "
+        "provided by duckduckgo_search (fields like title, href/link, body/snippet)."
+    ),
     allow_flagging="never",
     theme="Nymbo/Nymbo_Theme",
     submit_btn="Search",
@@ -469,6 +535,11 @@ concise_interface = gr.Interface(
     outputs=gr.Textbox(label="Results (JSONL)", interactive=False),
     title="DuckDuckGo Search (Concise)",
     description="Emits JSONL with short keys (t,u[,s]). Defaults avoid snippets and duplicate domains.",
+    api_description=(
+        "Run a DuckDuckGo search and return newline-delimited JSON with short keys: "
+        "t=title, u=url, optional s=snippet. Options control result count, "
+        "snippet inclusion and length, domain deduping, and title length."
+    ),
     allow_flagging="never",
     theme="Nymbo/Nymbo_Theme",
     submit_btn="Search",