add cloud open

Author: jtcorbett

src/mcp_agent/cli/cloud/commands/open/__init__.py

@@ -0,0 +1,5 @@
+"""Cloud open command exports."""
+
+from .main import open_portal
+
+__all__ = ["open_portal"]

src/mcp_agent/cli/cloud/commands/open/main.py

@@ -0,0 +1,48 @@
+"""Open MCP Agent Cloud portal in browser."""
+
+import webbrowser
+from typing import Optional
+
+import typer
+
+from mcp_agent.cli.core.constants import DEFAULT_BASE_URL
+from mcp_agent.cli.utils.ux import print_info, print_warning
+
+
+def open_portal(
+    server: Optional[str] = typer.Option(
+        None,
+        "--server",
+        help="Server ID or URL to open deployment details page",
+    ),
+) -> None:
+    """Open the MCP Agent Cloud portal in browser.
+
+    Opens the portal home page by default, or the deployment details page
+    if a server ID or URL is provided.
+
+    Args:
+        server: Optional server ID or URL to open deployment details for
+    """
+    # Use the base URL directly for portal access
+    base_url = DEFAULT_BASE_URL.rstrip("/")
+
+    if server:
+        if server.startswith("http"):
+            # If it's a URL, try to extract server ID
+            url = f"{base_url}/deployments/{server.split('/')[-1]}"
+            print_info(f"Opening deployment details for server: {server}")
+        else:
+            # If it's an ID, construct the deployment page URL
+            url = f"{base_url}/deployments/{server}"
+            print_info(f"Opening deployment details for server ID: {server}")
+    else:
+        url = f"{base_url}/dashboard"
+        print_info("Opening MCP Agent Cloud portal")
+
+    try:
+        webbrowser.open(url)
+        print_info(f"Portal opened at: {url}")
+    except Exception as e:
+        print_warning(f"Could not open browser automatically: {str(e)}")
+        print_info(f"Please open this URL manually: {url}")

src/mcp_agent/cli/cloud/main.py

@@ -20,6 +20,7 @@
     list_app_workflows,
 )
 from mcp_agent.cli.cloud.commands.apps import list_apps
+from mcp_agent.cli.cloud.commands.open import open_portal
 from mcp_agent.cli.cloud.commands.workflow import get_workflow_status
 from mcp_agent.cli.exceptions import CLIError
 from mcp_agent.cli.utils.ux import print_error
@@ -160,7 +161,12 @@ def invoke(self, ctx):
 app_cmd_cloud_auth.command(name="logout", help="Clear credentials.")(logout)
 # Add auth sub-typer to cloud
 app_cmd_cloud.add_typer(app_cmd_cloud_auth, name="auth", help="Authentication commands")
-# Register cloud commands (only containing auth for now)
+
+# Add open command to cloud
+app_cmd_cloud.command(name="open", help="Open the MCP Agent Cloud portal in browser")(
+    open_portal
+)
+
 app.add_typer(app_cmd_cloud, name="cloud", help="Cloud operations and management")
 # Top-level auth commands that map to cloud auth commands
 app.command(

src/mcp_agent/cli/core/constants.py

@@ -23,8 +23,9 @@
 ENV_API_KEY = "MCP_API_KEY"
 ENV_VERBOSE = "MCP_VERBOSE"
 
-# API defaults
-DEFAULT_API_BASE_URL = "https://mcp-agent.com/api"
+# Base URL defaults
+DEFAULT_BASE_URL = "https://mcp-agent.com"  # Base URL for web portal and API
+DEFAULT_API_BASE_URL = f"{DEFAULT_BASE_URL}/api"  # API endpoint derived from base URL
 
 # Secret types (string constants)
 SECRET_TYPE_DEVELOPER = "dev"