feat: CLI - agentstack self version should show remote server version when connected (#1728)

* docs: better description of connectors

Signed-off-by: Tomas Weiss <tomas.weiss2@gmail.com>

* feat: fetch server version in the CLI

Signed-off-by: Tomas Weiss <tomas.weiss2@gmail.com>

* feat: add active server to version command

Signed-off-by: Tomas Weiss <tomas.weiss2@gmail.com>

---------

Signed-off-by: Tomas Weiss <tomas.weiss2@gmail.com>
Signed-off-by: Tomáš Weiss <tomas.weiss2@gmail.com>

Author: tomkis

apps/agentstack-cli/src/agentstack_cli/api.py

@@ -1,6 +1,7 @@
 # Copyright 2025 © BeeAI a Series of LF Projects, LLC
 # SPDX-License-Identifier: Apache-2.0
 import json
+import logging
 import re
 import urllib
 import urllib.parse
@@ -12,6 +13,7 @@
 
 import httpx
 import openai
+import pydantic
 from a2a.client import A2AClientHTTPError, Client, ClientConfig, ClientFactory
 from a2a.types import AgentCard
 from httpx import HTTPStatusError
@@ -20,6 +22,8 @@
 from agentstack_cli import configuration
 from agentstack_cli.configuration import Configuration
 
+logger = logging.getLogger(__name__)
+
 config = Configuration()
 
 API_BASE_URL = "api/v1/"
@@ -102,6 +106,26 @@ async def api_stream(
                 yield jsonlib.loads(re.sub("^data:", "", line).strip())
 
 
+async def fetch_server_version() -> str | None:
+    """Fetch server version from OpenAPI schema."""
+
+    class OpenAPIInfo(pydantic.BaseModel):
+        version: str
+
+    class OpenAPISchema(pydantic.BaseModel):
+        info: OpenAPIInfo
+
+    try:
+        response = await api_request("GET", "openapi.json", use_auth=False)
+        if not response:
+            return None
+        schema = OpenAPISchema.model_validate(response)
+        return schema.info.version
+    except Exception as e:
+        logger.warning("Failed to fetch server version: %s", e)
+        return None
+
+
 @asynccontextmanager
 async def a2a_client(agent_card: AgentCard, use_auth: bool = True) -> AsyncIterator[Client]:
     try:

apps/agentstack-cli/src/agentstack_cli/commands/platform/base_driver.py

@@ -10,7 +10,6 @@
 from textwrap import dedent
 
 import anyio
-import pydantic
 import yaml
 from tenacity import AsyncRetrying, stop_after_attempt
 
@@ -193,27 +192,3 @@ async def deploy(
                 ["k3s", "kubectl", "rollout", "restart", "deployment"],
                 "Restarting deployments to load imported images",
             )
-
-    async def version(self) -> str | None:
-        if (await self.status()) != "running":
-            return None
-        HelmStatus = typing.TypedDict("HelmStatus", {"status": str, "app_version": str})
-        helm_status = pydantic.TypeAdapter(list[HelmStatus]).validate_json(
-            (
-                await self.run_in_vm(
-                    [
-                        "/usr/local/bin/helm",
-                        "--kubeconfig=/etc/rancher/k3s/k3s.yaml",
-                        "ls",
-                        "--namespace=default",
-                        "--filter=^agentstack$",
-                        "-o",
-                        "json",
-                    ],
-                    "Getting Agent Stack platform version",
-                )
-            ).stdout
-        )
-        if helm_status[0]["status"] != "deployed":
-            return None
-        return helm_status[0]["app_version"]

apps/agentstack-cli/src/agentstack_cli/commands/self.py

@@ -15,6 +15,7 @@
 from InquirerPy import inquirer
 
 import agentstack_cli.commands.platform
+from agentstack_cli.api import fetch_server_version
 from agentstack_cli.async_typer import AsyncTyper
 from agentstack_cli.commands.model import setup as model_setup
 from agentstack_cli.configuration import Configuration
@@ -46,7 +47,8 @@ async def version(
     """Print version of the Agent Stack CLI."""
     with verbosity(verbose=verbose):
         cli_version = importlib.metadata.version("agentstack-cli")
-        platform_version = await agentstack_cli.commands.platform.get_driver().version()
+        platform_version = await fetch_server_version()
+        active_server = configuration.auth_manager.active_server
 
         latest_cli_version: str | None = None
         with console.status("Checking for newer version...", spinner="dots"):
@@ -64,6 +66,7 @@ async def version(
         console.print(
             f"agentstack-platform version: [bold]{platform_version.replace('-', '') if platform_version is not None else 'not running'}[/bold]"
         )
+        console.print(f"          agentstack server: [bold]{active_server if active_server else 'none'}[/bold]")
         console.print()
 
         if latest_cli_version and packaging.version.parse(latest_cli_version) > packaging.version.parse(cli_version):

docs/development/agent-integration/mcp.mdx

@@ -7,6 +7,7 @@ description: "Learn how Agent Stack helps with authentication when using MCP."
 
 A connector is an MCP endpoint exposed by the Agent Stack that forwards MCP requests to a remote MCP server, acting as a proxy and handling authentication.
 
+
 It allows users to set up a connection to a third-party service (like GitHub, Box etc.) and then exposes a local MCP server that can be consumed by agents. This architecture eliminates the need for user authentication in your agent code. The connector handles authentication with the third-party service on behalf of the authenticated user, and the MCP interface is properly scoped to that user's permissions and data.
 
 Users can work with connectors in two ways via the Agent Stack UI: