Previous value: -"Connection alias. Omit to read the connection registered under alias `default` — i.e. a prior `brapi_connect` call that did not specify an alias. Calls that used a non-default alias must pass that same alias here."New value: +"Connection alias. Omit to use alias `default`. An alias registered via `brapi_connect` works, and so does one the server has a URL configured for (a built-in alias, an operator-configured alias, or `default` on a deployment with a default server), which connects on first use. Calls that used a non-default alias must pass that same alias here."

Previous value: -"Attribution metadata for built-in known-server connections. Absent for custom (env-only) connections."New value: +"Attribution metadata for built-in known-server connections. Absent when the alias is not built-in or points away from its built-in base URL."

Previous value: -"Capability profile derived from /serverinfo."New value: +"Capability profile derived from /serverinfo or /calls."

Previous value: -"Total distinct services the server advertises in /calls."New value: +"Total distinct services the server advertises in /serverinfo or /calls."

Previous value: -"Active dialect id (e.g. \"spec\", \"cassavabase\"). Names a registered adapter that translates outbound filters and declares known-dead routes."New value: +"Active dialect id (e.g. \"spec\", \"cassavabase\")."

Previous value: -"Number of filter translations inferred from naming conventions but not independently verified. A non-zero count means some result narrowing on this server may not fire as expected."New value: +"Filter translations inferred from naming conventions, unverified; when non-zero, some narrowing on this server may not fire."

Previous value: -"Number of filter translations the dialect has empirically verified against a live server. Higher means more confidence in the translation table."New value: +"Filter translations verified against a live server. Absent when the dialect publishes no mapping summary."

Previous value: -"Machine-readable failure mode. Declared by this tool: `unknown_alias`: No connection has been registered under the requested alias. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `unknown_alias`: No connection is registered under the requested alias, and the server has no base URL configured for it to connect on first use. `auth_token_exchange_failed`: Connecting the alias on first use, the SGN or OAuth token exchange against the BrAPI /token endpoint failed. `auth_no_access_token`: Connecting the alias on first use, the token endpoint answered without returning an access token. `capability_discovery_unavailable`: Neither /serverinfo nor /calls listed any call, and at least one of them timed out, was unreachable, or answered 429 or a 5xx other than 501, so nothing was cached. `upstream_unauthorized`: The BrAPI server answered HTTP 401: it requires credentials, or rejected the ones sent. `upstream_forbidden`: The BrAPI server answered HTTP 403: the credentials sent, or their absence, lack access. `alias_base_url_invalid`: The base URL configured on the server for this alias is not an absolute http(s) URL, or carries credentials. `private_address_blocked`: The base URL configured for this alias, or its token URL, is on a private or reserved address this server may not reach. Other values are possible when a failure originates below the handler."

Previous value: -[
-  "unknown_alias"
-]New value: +[
+  "unknown_alias",
+  "auth_token_exchange_failed",
+  "auth_no_access_token",
+  "capability_discovery_unavailable",
+  "upstream_unauthorized",
+  "upstream_forbidden",
+  "alias_base_url_invalid",
+  "private_address_blocked"
+]

Previous value: -"Arguments to call the tool with. Alias only — narrow further with the tool filters."New value: +"Arguments to start the tool with (alias only)."

Previous value: -[
-  {
-    "not": {
-      "required": [
-        "error"
-      ]
-    },
-    "required": [
-      "alias",
-      "baseUrl",
-      "server",
-      "auth",
-      "capabilities",
-      "dialect",
-      "content",
-      "notes",
-      "fetchedAt"
-    ]
-  },
-  {
-    "required": [
-      "error"
-    ]
-  }
-]New value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "alias",
+      "baseUrl",
+      "server",
+      "auth",
+      "capabilities",
+      "dialect",
+      "content",
+      "nextToolSuggestions",
+      "notes",
+      "fetchedAt"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Added value: +{
+  "description": "Entry-point finders (studies, germplasm, variables, locations — in that order) whose GET or POST /search route this server exposes under the active dialect. Empty when none apply.",
+  "items": {
+    "additionalProperties": false,
+    "description": "A finder the connected server supports, with the arguments to start it.",
+    "properties": {
+      "args": {
+        "additionalProperties": false,
+        "description": "Arguments to call the tool with. Alias only — narrow further with the tool filters.",
+        "properties": {
+          "alias": {
+            "description": "Connection alias to pass to the suggested tool.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "alias"
+        ],
+        "type": "object"
+      },
+      "reason": {
+        "description": "Why this tool applies to the connected server.",
+        "type": "string"
+      },
+      "toolName": {
+        "description": "Entry-point finder tool this server can serve.",
+        "enum": [
+          "brapi_find_studies",
+          "brapi_find_germplasm",
+          "brapi_find_variables",
+          "brapi_find_locations"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "toolName",
+      "reason",
+      "args"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}