Add listed_apps_in_marketplace MCP tool (#6)

* listed apps mcp tool

* Improve listed_apps_in_marketplace tool for LLM discoverability

- Rewrite docstring with explicit trigger phrases (e.g. "any data on
  crypto/options/...") and clarify that OpenBB data comes from vendor
  apps, so the LLM reliably picks this tool for data-availability
  questions.
- Slim output to fields that help the LLM match user topics and cite a
  source: drop backendUrl, thumbnail, screenshots, contactEmail,
  apiKeyUrl, version, isBuiltIn, isDevelopment, averageRating. Keep
  widgets (full list — essential for keyword matching), vendor
  description, auth type, and documentation URL.
- Filter out E2E test apps and isDevelopment=True apps.
- Add 10s timeout on the HTTP call.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Minh Hoang <nminh.hoang1023@gmail.com>
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: 3 people

server.py

@@ -425,6 +425,80 @@ def _find_section_content(full_docs: str, title: str) -> Optional[str]:
     return None
 
 
+@mcp.tool()
+def listed_apps_in_marketplace() -> str:
+    """Search the OpenBB Marketplace for apps, datasets, and data vendors.
+
+    OpenBB Workspace does NOT ship its own datasets — data is provided by
+    third-party vendor apps published to the OpenBB Marketplace. Use this
+    tool whenever a user asks about data availability, coverage, vendors,
+    workflows, or apps for a specific asset class or domain.
+
+    Call this tool for questions like:
+      - "Do you have any data from the marketplace about crypto?"
+      - "What options data is available?"
+      - "Is there anything on institutional flow / futures / ETFs / macro?"
+      - "Which vendors offer fundamentals data?"
+      - "Any app for <topic>?"
+      - "What workflows / dashboards are available in OpenBB?"
+      - "Who provides <dataset>?"
+
+    Returns a markdown catalog of every published app with: app name,
+    vendor, description, the list of widgets (data views) the app exposes,
+    prompts, auth type, and documentation link. Search the widget names
+    and descriptions in the returned text to match the user's topic,
+    then recommend the relevant apps and vendors with their documentation
+    link.
+    """
+
+    try:
+        response = httpx.get(
+            "https://payments.openbb.dev/marketplace/apps", timeout=10.0
+        )
+        response.raise_for_status()
+        apps = response.json()
+
+        apps = [
+            a for a in apps
+            if not a.get("appName", "").startswith("E2E")
+            and not a.get("isDevelopment", False)
+        ]
+
+        result_lines = [f"# OpenBB Marketplace Apps ({len(apps)} apps available)\n"]
+
+        for app_item in apps:
+            result_lines.append(f"## {app_item.get('appName', 'N/A')}")
+            result_lines.append(f"- **Vendor:** {app_item.get('vendorName', 'N/A')}")
+            result_lines.append(f"- **Description:** {app_item.get('description', 'N/A')}")
+
+            if app_item.get("vendorDescription"):
+                result_lines.append(f"- **About the vendor:** {app_item['vendorDescription']}")
+
+            result_lines.append(f"- **Auth Type:** {app_item.get('authType', [])}")
+
+            if app_item.get("documentationUrl"):
+                result_lines.append(f"- **Documentation:** {app_item['documentationUrl']}")
+
+            widgets = app_item.get("widgets", [])
+            if widgets:
+                result_lines.append(
+                    f"- **Widgets ({len(widgets)}):** {', '.join(str(w) for w in widgets)}"
+                )
+
+            prompts = app_item.get("prompts", [])
+            if prompts:
+                result_lines.append(
+                    f"- **Prompts ({len(prompts)}):** {', '.join(str(p) for p in prompts)}"
+                )
+
+            result_lines.append("")
+
+        return "\n".join(result_lines)
+
+    except httpx.HTTPError as e:
+        return f"Error fetching marketplace apps: {str(e)}"
+
+
 if __name__ == "__main__":
     # Use PORT environment variable
     port = int(os.environ.get("PORT", 8000))