@cyanheads/brapi-mcp-server 0.7.13 → 0.8.0

package/dist/mcp-server/tools/definitions/brapi-connect.tool.d.ts

@@ -87,17 +87,63 @@ export declare const brapiConnect: import("@cyanheads/mcp-ts-core").ToolDefiniti
         citation: z.ZodString;
         isDemo: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
+    nextToolSuggestions: z.ZodArray<z.ZodObject<{
+        toolName: z.ZodEnum<{
+            brapi_find_germplasm: "brapi_find_germplasm";
+            brapi_find_locations: "brapi_find_locations";
+            brapi_find_studies: "brapi_find_studies";
+            brapi_find_variables: "brapi_find_variables";
+        }>;
+        reason: z.ZodString;
+        args: z.ZodObject<{
+            alias: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
     notes: z.ZodArray<z.ZodString>;
     fetchedAt: z.ZodString;
 }, z.core.$strip>, readonly [{
+    readonly reason: 'auth_session_required';
+    readonly code: JsonRpcErrorCode.Forbidden;
+    readonly when: 'Caller-supplied credentials on an HTTP deployment without per-user auth, from a request that carries no MCP session';
+    readonly recovery: 'Connect from a client that keeps an MCP session (2025-era Streamable HTTP) or over stdio, use a deployment with MCP_AUTH_MODE=jwt or oauth, or omit `auth` to use server-configured credentials or none.';
+    readonly retryable: false;
+}, {
+    readonly reason: 'auth_base_url_mismatch';
+    readonly code: JsonRpcErrorCode.Forbidden;
+    readonly when: 'The alias has server-configured credentials and the supplied baseUrl differs from the server configured for it';
+    readonly recovery: "Omit `baseUrl` to connect to the server configured for this alias, or register the other server under a different alias.";
+    readonly retryable: false;
+    readonly thrownBy: 'service';
+}, {
+    readonly reason: 'alias_base_url_unset';
+    readonly code: JsonRpcErrorCode.ConfigurationError;
+    readonly when: 'The alias has server-configured credentials but no base URL of its own (no BRAPI_<ALIAS>_BASE_URL and no enabled built-in), so they pair with no server';
+    readonly recovery: 'Set BRAPI_<ALIAS>_BASE_URL on the server for this alias, or remove its credential variables, before retrying.';
+    readonly retryable: false;
+    readonly thrownBy: 'service';
+}, {
     readonly reason: 'auth_token_exchange_failed';
     readonly code: JsonRpcErrorCode.Forbidden;
     readonly when: 'SGN or OAuth token exchange against the BrAPI /token endpoint failed';
     readonly recovery: 'Verify the credentials and that the server exposes /token before retrying.';
+    readonly thrownBy: 'service';
 }, {
     readonly reason: 'auth_no_access_token';
     readonly code: JsonRpcErrorCode.Forbidden;
     readonly when: 'Token endpoint responded but did not return an access_token';
     readonly recovery: 'Confirm the credentials are valid and the upstream IdP issues access tokens for this grant.';
+    readonly thrownBy: 'service';
+}, {
+    readonly reason: 'upstream_unauthorized';
+    readonly code: JsonRpcErrorCode.Unauthorized;
+    readonly when: 'The server answered HTTP 401 on /serverinfo or /calls — it requires login for capability discovery';
+    readonly recovery: 'Retry brapi_connect with credentials in `auth` (sgn, bearer, api_key, or oauth2), or ask the operator to configure credentials for this alias server-side.';
+    readonly thrownBy: 'service';
+}, {
+    readonly reason: 'upstream_forbidden';
+    readonly code: JsonRpcErrorCode.Forbidden;
+    readonly when: 'The server answered HTTP 403 on /serverinfo or /calls — the request (anonymous or credentialed) lacks read access';
+    readonly recovery: 'Retry brapi_connect with credentials that have read access to this server, or ask the operator to configure such credentials for this alias server-side.';
+    readonly thrownBy: 'service';
 }], undefined>;
 //# sourceMappingURL=brapi-connect.tool.d.ts.map

package/dist/mcp-server/tools/definitions/brapi-connect.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brapi-connect.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/brapi-connect.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAqBjE,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAWX,4BAA4B;;mBAE9B,sEAAsE;uBAClE,4EAA4E;;qBAG9E,sBAAsB;;mBAExB,6DAA6D;uBAEjE,6FAA6F;cAoEnG,CAAC"}
+{"version":3,"file":"brapi-connect.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/brapi-connect.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAyBjE,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAWX,uBAAuB;;mBAEzB,qHAAqH;uBAEzH,0MAA0M;;;qBAIpM,wBAAwB;;mBAE1B,gHAAgH;;;uBAG5G,SAAS;;qBAGX,sBAAsB;;mBAExB,yJAAyJ;uBAE7J,+GAA+G;;uBAEvG,SAAS;;qBAGX,4BAA4B;;mBAE9B,sEAAsE;uBAClE,4EAA4E;uBAC5E,SAAS;;qBAGX,sBAAsB;;mBAExB,6DAA6D;uBAEjE,6FAA6F;uBACrF,SAAS;;qBAGX,uBAAuB;;mBAEzB,oGAAoG;uBAExG,4JAA4J;uBACpJ,SAAS;;qBAGX,oBAAoB;;mBAEtB,mHAAmH;uBAEvH,0JAA0J;uBAClJ,SAAS;cAwFvB,CAAC"}

package/dist/mcp-server/tools/definitions/brapi-connect.tool.js

@@ -8,14 +8,15 @@
  * @module mcp-server/tools/definitions/brapi-connect.tool
  */
 import { tool, z } from '@cyanheads/mcp-ts-core';
+import { config } from '@cyanheads/mcp-ts-core/config';
 import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
-import { discoverConfiguredAliases, formatConfiguredAliasesHint, resolveConnectInput, } from '../../../config/alias-credentials.js';
+import { AUTH_BASE_URL_MISMATCH_RECOVERY, discoverConfiguredAliases, formatConfiguredAliasesHint, resolveConnectInput, } from '../../../config/alias-credentials.js';
 import { getBrapiClient } from '../../../services/brapi-client/index.js';
-import { getCapabilityRegistry } from '../../../services/capability-registry/index.js';
+import { getCapabilityRegistry, } from '../../../services/capability-registry/index.js';
 import { getServerRegistry } from '../../../services/server-registry/index.js';
 import { ConnectAuthSchema } from '../shared/connect-auth-schema.js';
 import { buildOrientationEnvelope, formatOrientationEnvelope, OrientationEnvelopeSchema, } from '../shared/orientation-envelope.js';
-const BASE_DESCRIPTION = 'Open a connection to a BrAPI v2 server, authenticate, and return the full orientation envelope (server identity, capability profile, content summary). Required handshake before other BrAPI tools. Supports multiple concurrent connections via named aliases. Credentials can be configured server-side and omitted from this call.';
+const BASE_DESCRIPTION = 'Open a connection to a BrAPI v2 server, authenticate, and return the full orientation envelope (server identity, capability profile, content summary, suggested next tools). Required handshake before other BrAPI tools. Supports multiple concurrent connections via named aliases. Credentials can be configured server-side and omitted from this call. When a request carries no MCP session on a deployment without per-user auth, aliases live in one namespace shared by every such caller: re-registering an alias re-points their later calls to it.';
 const CONFIGURED_ALIASES_HINT = formatConfiguredAliasesHint(discoverConfiguredAliases());
 export const brapiConnect = tool('brapi_connect', {
     description: CONFIGURED_ALIASES_HINT
@@ -27,17 +28,56 @@ export const brapiConnect = tool('brapi_connect', {
         idempotentHint: true,
     },
     errors: [
+        {
+            reason: 'auth_session_required',
+            code: JsonRpcErrorCode.Forbidden,
+            when: 'Caller-supplied credentials on an HTTP deployment without per-user auth, from a request that carries no MCP session',
+            recovery: 'Connect from a client that keeps an MCP session (2025-era Streamable HTTP) or over stdio, use a deployment with MCP_AUTH_MODE=jwt or oauth, or omit `auth` to use server-configured credentials or none.',
+            retryable: false,
+        },
+        {
+            reason: 'auth_base_url_mismatch',
+            code: JsonRpcErrorCode.Forbidden,
+            when: 'The alias has server-configured credentials and the supplied baseUrl differs from the server configured for it',
+            recovery: AUTH_BASE_URL_MISMATCH_RECOVERY,
+            retryable: false,
+            thrownBy: 'service',
+        },
+        {
+            reason: 'alias_base_url_unset',
+            code: JsonRpcErrorCode.ConfigurationError,
+            when: 'The alias has server-configured credentials but no base URL of its own (no BRAPI_<ALIAS>_BASE_URL and no enabled built-in), so they pair with no server',
+            recovery: 'Set BRAPI_<ALIAS>_BASE_URL on the server for this alias, or remove its credential variables, before retrying.',
+            retryable: false,
+            thrownBy: 'service',
+        },
         {
             reason: 'auth_token_exchange_failed',
             code: JsonRpcErrorCode.Forbidden,
             when: 'SGN or OAuth token exchange against the BrAPI /token endpoint failed',
             recovery: 'Verify the credentials and that the server exposes /token before retrying.',
+            thrownBy: 'service',
         },
         {
             reason: 'auth_no_access_token',
             code: JsonRpcErrorCode.Forbidden,
             when: 'Token endpoint responded but did not return an access_token',
             recovery: 'Confirm the credentials are valid and the upstream IdP issues access tokens for this grant.',
+            thrownBy: 'service',
+        },
+        {
+            reason: 'upstream_unauthorized',
+            code: JsonRpcErrorCode.Unauthorized,
+            when: 'The server answered HTTP 401 on /serverinfo or /calls — it requires login for capability discovery',
+            recovery: 'Retry brapi_connect with credentials in `auth` (sgn, bearer, api_key, or oauth2), or ask the operator to configure credentials for this alias server-side.',
+            thrownBy: 'service',
+        },
+        {
+            reason: 'upstream_forbidden',
+            code: JsonRpcErrorCode.Forbidden,
+            when: 'The server answered HTTP 403 on /serverinfo or /calls — the request (anonymous or credentialed) lacks read access',
+            recovery: 'Retry brapi_connect with credentials that have read access to this server, or ask the operator to configure such credentials for this alias server-side.',
+            thrownBy: 'service',
         },
     ],
     input: z.object({
@@ -57,32 +97,46 @@ export const brapiConnect = tool('brapi_connect', {
         const registry = getServerRegistry();
         const capabilities = getCapabilityRegistry();
         const client = getBrapiClient();
+        // Credentialed state fails closed: without a session or per-user auth the
+        // exchanged header would sit where every other session-less caller reads it.
+        if (input.auth &&
+            input.auth.mode !== 'none' &&
+            isSharedTenantHttp() &&
+            registry.isolationFallsBackToShared(ctx)) {
+            throw ctx.fail('auth_session_required', 'Caller-supplied credentials are refused: this HTTP deployment has no per-user auth and the request carries no MCP session, so the connection would be shared with every other session-less caller.', { ...ctx.recoveryFor('auth_session_required') });
+        }
         const resolved = resolveConnectInput(input.alias, {
             baseUrl: input.baseUrl,
             auth: input.auth,
         });
-        const connection = await registry.register(ctx, {
+        // Nothing persists until the connection has proven itself: token exchange
+        // and a fresh capability fetch run first, so any failure leaves the previous
+        // registration under this alias (and its cached profile) as it was.
+        const connection = await registry.resolve(ctx, {
             alias: input.alias,
             baseUrl: resolved.baseUrl,
             auth: resolved.auth,
         });
+        const profileLookup = { forceRefresh: true };
+        if (connection.resolvedAuth)
+            profileLookup.auth = connection.resolvedAuth;
+        await capabilities.profile(connection.baseUrl, ctx, profileLookup);
+        await registry.save(ctx, connection);
         ctx.log.info('BrAPI connection registered', {
             alias: connection.alias,
             baseUrl: connection.baseUrl,
             authMode: connection.authMode,
             authSource: input.auth ? 'agent' : 'env',
         });
-        if (isMultiTenantHttpDeployment() && connection.authMode !== 'none') {
+        if (isSharedTenantHttp() && connection.authMode !== 'none') {
             ctx.log.notice('Connection credentials persisted under shared `default` tenant — set MCP_AUTH_MODE=jwt|oauth for per-client isolation.', {
                 alias: connection.alias,
                 baseUrl: connection.baseUrl,
                 authMode: connection.authMode,
-                mcpTransport: process.env.MCP_TRANSPORT_TYPE,
-                mcpAuthMode: process.env.MCP_AUTH_MODE ?? 'none',
+                mcpTransport: config.mcpTransportType,
+                mcpAuthMode: config.mcpAuthMode,
             });
         }
-        // Force a fresh capability load on connect — the agent expects current state.
-        await capabilities.invalidate(connection.baseUrl, ctx);
         return buildOrientationEnvelope(ctx, connection, {
             registry: capabilities,
             client,
@@ -95,11 +149,7 @@ export const brapiConnect = tool('brapi_connect', {
  * case `ctx.state` collapses every caller into the shared `default` tenant —
  * including the bearer token resolved by SGN/OAuth at connection time.
  */
-function isMultiTenantHttpDeployment() {
-    const transport = (process.env.MCP_TRANSPORT_TYPE ?? 'stdio').toLowerCase();
-    if (transport !== 'http')
-        return false;
-    const authMode = (process.env.MCP_AUTH_MODE ?? 'none').toLowerCase();
-    return authMode !== 'jwt' && authMode !== 'oauth';
+function isSharedTenantHttp() {
+    return config.mcpTransportType === 'http' && config.mcpAuthMode === 'none';
 }
 //# sourceMappingURL=brapi-connect.tool.js.map

package/dist/mcp-server/tools/definitions/brapi-connect.tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"brapi-connect.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/brapi-connect.tool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"brapi-connect.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/brapi-connect.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/brapi-describe-filters.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brapi-describe-filters.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/brapi-describe-filters.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAgBjE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;qBAMnB,kBAAkB;;mBAEpB,4DAA4D;uBAEhE,wJAAwJ;cAiE9J,CAAC"}
+{"version":3,"file":"brapi-describe-filters.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/brapi-describe-filters.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAgBjE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;qBAMnB,kBAAkB;;mBAEpB,4DAA4D;uBAEhE,wJAAwJ;cAoE9J,CAAC"}

package/dist/mcp-server/tools/definitions/brapi-describe-filters.tool.js

@@ -77,8 +77,13 @@ export const brapiDescribeFilters = tool('brapi_describe_filters', {
         lines.push('| Name | Type | Description | Example |');
         lines.push('|:-----|:-----|:------------|:--------|');
         for (const filter of result.filters) {
-            const description = filter.description.replace(/\|/g, '\\|');
-            lines.push(`| \`${filter.name}\` | \`${filter.type}\` | ${description} | \`${filter.example}\` |`);
+            // Backslashes first, so the `\` added before each pipe is not doubled.
+            const description = filter.description.replace(/\\/g, '\\\\').replace(/\|/g, '\\|');
+            // A backslash is already literal inside a code span, but a bare `|` still
+            // splits the row there: code-span cells escape pipes only.
+            const name = filter.name.replace(/\|/g, '\\|');
+            const example = filter.example.replace(/\|/g, '\\|');
+            lines.push(`| \`${name}\` | \`${filter.type}\` | ${description} | \`${example}\` |`);
         }
         lines.push('');
         lines.push(`_Available endpoints: ${result.availableEndpoints.map((e) => `\`${e}\``).join(', ')}._`);

package/dist/mcp-server/tools/definitions/brapi-describe-filters.tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"brapi-describe-filters.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/brapi-describe-filters.tool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"brapi-describe-filters.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/brapi-describe-filters.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAE1F,MAAM,eAAe,GAAG,mBAAmB,EAAE,CAAC;AAE9C,MAAM,sBAAsB,GAAG,CAAC;KAC7B,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;IACvF,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;SACjF,QAAQ,CAAC,sBAAsB,CAAC;IACnC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IAC9E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;CAC7D,CAAC;KACD,QAAQ,CAAC,mEAAmE,CAAC,CAAC;AAEjF,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC,wBAAwB,EAAE;IACjE,WAAW,EACT,wRAAwR;IAC1R,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE;IACzD,MAAM,EAAE;QACN;YACE,MAAM,EAAE,kBAAkB;YAC1B,IAAI,EAAE,gBAAgB,CAAC,QAAQ;YAC/B,IAAI,EAAE,4DAA4D;YAClE,QAAQ,EACN,wJAAwJ;SAC3J;KACO;IACV,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,QAAQ,EAAE,CAAC;aACR,IAAI,CAAC,eAAwC,CAAC;aAC9C,QAAQ,CAAC,yCAAyC,CAAC;KACvD,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;QACnE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;QACzF,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QAC5E,aAAa,EAAE,CAAC;aACb,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,yDAAyD,CAAC;QACtE,kBAAkB,EAAE,CAAC;aAClB,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,QAAQ,CAAC,+DAA+D,CAAC;KAC7E,CAAC;IAEF,OAAO,CAAC,KAAK,EAAE,GAAG;QAChB,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACjD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,GAAG,CAAC,IAAI,CACZ,kBAAkB,EAClB,mCAAmC,KAAK,CAAC,QAAQ,iBAAiB,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAC/F;gBACE,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,kBAAkB,EAAE,eAAe;gBACnC,GAAG,GAAG,CAAC,WAAW,CAAC,kBAAkB,CAAC;aACvC,CACF,CAAC;QACJ,CAAC;QACD,OAAO;YACL,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM;YACnC,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,GAAG,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxF,kBAAkB,EAAE,eAAe;SACpC,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QACjB,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,mBAAmB,MAAM,CAAC,QAAQ,OAAO,MAAM,CAAC,WAAW,SAAS,CAAC,CAAC;QACjF,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC;QAClD,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;QACtD,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACpC,uEAAuE;YACvE,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YACpF,0EAA0E;YAC1E,2DAA2D;YAC3D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAC/C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YACrD,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,UAAU,MAAM,CAAC,IAAI,QAAQ,WAAW,QAAQ,OAAO,MAAM,CAAC,CAAC;QACvF,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CACR,yBAAyB,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CACzF,CAAC;QACF,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/tools/definitions/brapi-server-info.tool.d.ts

@@ -67,6 +67,18 @@ export declare const brapiServerInfo: import("@cyanheads/mcp-ts-core").ToolDefin
         citation: z.ZodString;
         isDemo: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
+    nextToolSuggestions: z.ZodArray<z.ZodObject<{
+        toolName: z.ZodEnum<{
+            brapi_find_germplasm: "brapi_find_germplasm";
+            brapi_find_locations: "brapi_find_locations";
+            brapi_find_studies: "brapi_find_studies";
+            brapi_find_variables: "brapi_find_variables";
+        }>;
+        reason: z.ZodString;
+        args: z.ZodObject<{
+            alias: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
     notes: z.ZodArray<z.ZodString>;
     fetchedAt: z.ZodString;
 }, z.core.$strip>, readonly [{

package/dist/mcp-server/tools/definitions/brapi-server-info.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brapi-server-info.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/brapi-server-info.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAUjE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAMd,eAAe;;mBAEjB,6DAA6D;uBAEjE,qHAAqH;uBAC7G,SAAS;cAgCvB,CAAC"}
+{"version":3,"file":"brapi-server-info.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/brapi-server-info.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAUjE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAMd,eAAe;;mBAEjB,6DAA6D;uBAEjE,qHAAqH;uBAC7G,SAAS;cAgCvB,CAAC"}

package/dist/mcp-server/tools/definitions/brapi-server-info.tool.js

@@ -13,7 +13,7 @@ import { getCapabilityRegistry } from '../../../services/capability-registry/ind
 import { requireRegisteredConnection } from '../shared/find-helpers.js';
 import { buildOrientationEnvelope, formatOrientationEnvelope, OrientationEnvelopeSchema, } from '../shared/orientation-envelope.js';
 export const brapiServerInfo = tool('brapi_server_info', {
-    description: 'Return the full orientation envelope for a registered BrAPI connection — server identity, capabilities, content counts, and notes. Re-running refreshes the cached capability scan; pass an alias to read a non-default connection.',
+    description: 'Return the full orientation envelope for a registered BrAPI connection — server identity, capabilities, content counts, suggested finders, and notes. Re-running refreshes the cached capability scan; pass an alias to read a non-default connection.',
     annotations: { readOnlyHint: true, idempotentHint: true },
     errors: [
         {

package/dist/mcp-server/tools/definitions/brapi-server-info.tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"brapi-server-info.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/brapi-server-info.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,mCAAmC,CAAC;AAE3C,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,mBAAmB,EAAE;IACvD,WAAW,EACT,qOAAqO;IACvO,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE;IACzD,MAAM,EAAE;QACN;YACE,MAAM,EAAE,eAAe;YACvB,IAAI,EAAE,gBAAgB,CAAC,QAAQ;YAC/B,IAAI,EAAE,6DAA6D;YACnE,QAAQ,EACN,qHAAqH;YACvH,QAAQ,EAAE,SAAS;SACpB;KACO;IACV,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,KAAK,CAAC,kBAAkB,CAAC;aACzB,QAAQ,EAAE;aACV,QAAQ,CACP,uNAAuN,CACxN;QACH,YAAY,EAAE,CAAC;aACZ,OAAO,EAAE;aACT,OAAO,CAAC,KAAK,CAAC;aACd,QAAQ,CAAC,mEAAmE,CAAC;KACjF,CAAC;IACF,MAAM,EAAE,yBAAyB;IAEjC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,MAAM,YAAY,GAAG,qBAAqB,EAAE,CAAC;QAC7C,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;QAEhC,MAAM,UAAU,GAAG,MAAM,2BAA2B,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QAEvE,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;YACvB,MAAM,YAAY,CAAC,UAAU,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACzD,CAAC;QAED,OAAO,wBAAwB,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,yBAAyB,CAAC,MAAM,CAAC,EAAE,CAAC;CAChF,CAAC,CAAC"}
+{"version":3,"file":"brapi-server-info.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/brapi-server-info.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,mCAAmC,CAAC;AAE3C,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,mBAAmB,EAAE;IACvD,WAAW,EACT,wPAAwP;IAC1P,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE;IACzD,MAAM,EAAE;QACN;YACE,MAAM,EAAE,eAAe;YACvB,IAAI,EAAE,gBAAgB,CAAC,QAAQ;YAC/B,IAAI,EAAE,6DAA6D;YACnE,QAAQ,EACN,qHAAqH;YACvH,QAAQ,EAAE,SAAS;SACpB;KACO;IACV,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,KAAK,CAAC,kBAAkB,CAAC;aACzB,QAAQ,EAAE;aACV,QAAQ,CACP,uNAAuN,CACxN;QACH,YAAY,EAAE,CAAC;aACZ,OAAO,EAAE;aACT,OAAO,CAAC,KAAK,CAAC;aACd,QAAQ,CAAC,mEAAmE,CAAC;KACjF,CAAC;IACF,MAAM,EAAE,yBAAyB;IAEjC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,MAAM,YAAY,GAAG,qBAAqB,EAAE,CAAC;QAC7C,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;QAEhC,MAAM,UAAU,GAAG,MAAM,2BAA2B,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QAEvE,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;YACvB,MAAM,YAAY,CAAC,UAAU,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACzD,CAAC;QAED,OAAO,wBAAwB,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,yBAAyB,CAAC,MAAM,CAAC,EAAE,CAAC;CAChF,CAAC,CAAC"}

package/dist/mcp-server/tools/definitions/index.d.ts

@@ -114,6 +114,74 @@ export declare const readOnlyToolDefinitions: (import("@cyanheads/mcp-ts-core").
     readonly when: 'Upstream returned no study record for the requested DbId';
     readonly recovery: 'Verify the studyDbId on the target server, or run brapi_find_studies to discover valid IDs.';
 }], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    alias: import("zod").ZodOptional<import("zod").ZodString>;
+    studies: import("zod").ZodArray<import("zod").ZodString>;
+    variables: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    germplasm: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    shape: import("zod").ZodDefault<import("zod").ZodEnum<{
+        long: "long";
+        wide: "wide";
+    }>>;
+    aggregate: import("zod").ZodDefault<import("zod").ZodEnum<{
+        all: "all";
+        first: "first";
+        mean: "mean";
+        median: "median";
+    }>>;
+    loadLimit: import("zod").ZodOptional<import("zod").ZodNumber>;
+    extraFilters: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    alias: import("zod").ZodString;
+    studies: import("zod").ZodArray<import("zod").ZodString>;
+    shape: import("zod").ZodEnum<{
+        long: "long";
+        wide: "wide";
+    }>;
+    aggregate: import("zod").ZodEnum<{
+        all: "all";
+        first: "first";
+        mean: "mean";
+        median: "median";
+    }>;
+    observationCount: import("zod").ZodNumber;
+    germplasmCount: import("zod").ZodNumber;
+    variableCount: import("zod").ZodNumber;
+    variableLegend: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>;
+    dataframe: import("zod").ZodOptional<import("zod").ZodObject<{
+        tableName: import("zod").ZodString;
+        rowCount: import("zod").ZodNumber;
+        columns: import("zod").ZodArray<import("zod").ZodString>;
+        columnLegend: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+        createdAt: import("zod").ZodString;
+        expiresAt: import("zod").ZodString;
+        truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        maxRows: import("zod").ZodOptional<import("zod").ZodNumber>;
+        totalCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>>;
+    warnings: import("zod").ZodArray<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: 'unknown_alias';
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: 'No connection has been registered under the requested alias';
+    readonly recovery: 'Run brapi_connect with this alias (or omit `alias` to use the default connection) before calling brapi_build_phenotype_matrix.';
+    readonly thrownBy: 'service';
+}, {
+    readonly reason: 'all_filters_dropped';
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: 'The active dialect dropped every filter supplied — the call would silently widen to the unfiltered baseline';
+    readonly recovery: 'Drop unsupported filters or use studies / germplasm / variables to scope the query to supported filter paths on the active dialect.';
+    readonly thrownBy: 'service';
+}, {
+    readonly reason: 'no_observation_path';
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: 'Neither /observations nor /observationunits returned data for any requested study after probing both paths';
+    readonly recovery: 'Verify the studyDbIds exist and the BrAPI server exposes /observations or /observationunits. Use brapi_server_info to inspect the capability list.';
+}], {
+    readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
+    readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
+    readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
+}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
     alias: import("zod").ZodOptional<import("zod").ZodString>;
     germplasmDbIds: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
     variantSetDbId: import("zod").ZodString;
@@ -426,87 +494,65 @@ export declare const readOnlyToolDefinitions: (import("@cyanheads/mcp-ts-core").
         citation: import("zod").ZodString;
         isDemo: import("zod").ZodOptional<import("zod").ZodBoolean>;
     }, import("zod/v4/core").$strip>>;
+    nextToolSuggestions: import("zod").ZodArray<import("zod").ZodObject<{
+        toolName: import("zod").ZodEnum<{
+            brapi_find_germplasm: "brapi_find_germplasm";
+            brapi_find_locations: "brapi_find_locations";
+            brapi_find_studies: "brapi_find_studies";
+            brapi_find_variables: "brapi_find_variables";
+        }>;
+        reason: import("zod").ZodString;
+        args: import("zod").ZodObject<{
+            alias: import("zod").ZodString;
+        }, import("zod/v4/core").$strip>;
+    }, import("zod/v4/core").$strip>>;
     notes: import("zod").ZodArray<import("zod").ZodString>;
     fetchedAt: import("zod").ZodString;
 }, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: 'auth_session_required';
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
+    readonly when: 'Caller-supplied credentials on an HTTP deployment without per-user auth, from a request that carries no MCP session';
+    readonly recovery: 'Connect from a client that keeps an MCP session (2025-era Streamable HTTP) or over stdio, use a deployment with MCP_AUTH_MODE=jwt or oauth, or omit `auth` to use server-configured credentials or none.';
+    readonly retryable: false;
+}, {
+    readonly reason: 'auth_base_url_mismatch';
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
+    readonly when: 'The alias has server-configured credentials and the supplied baseUrl differs from the server configured for it';
+    readonly recovery: "Omit `baseUrl` to connect to the server configured for this alias, or register the other server under a different alias.";
+    readonly retryable: false;
+    readonly thrownBy: 'service';
+}, {
+    readonly reason: 'alias_base_url_unset';
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ConfigurationError;
+    readonly when: 'The alias has server-configured credentials but no base URL of its own (no BRAPI_<ALIAS>_BASE_URL and no enabled built-in), so they pair with no server';
+    readonly recovery: 'Set BRAPI_<ALIAS>_BASE_URL on the server for this alias, or remove its credential variables, before retrying.';
+    readonly retryable: false;
+    readonly thrownBy: 'service';
+}, {
     readonly reason: 'auth_token_exchange_failed';
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
     readonly when: 'SGN or OAuth token exchange against the BrAPI /token endpoint failed';
     readonly recovery: 'Verify the credentials and that the server exposes /token before retrying.';
+    readonly thrownBy: 'service';
 }, {
     readonly reason: 'auth_no_access_token';
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
     readonly when: 'Token endpoint responded but did not return an access_token';
     readonly recovery: 'Confirm the credentials are valid and the upstream IdP issues access tokens for this grant.';
-}], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
-    alias: import("zod").ZodOptional<import("zod").ZodString>;
-    studies: import("zod").ZodArray<import("zod").ZodString>;
-    variables: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    germplasm: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    shape: import("zod").ZodDefault<import("zod").ZodEnum<{
-        long: "long";
-        wide: "wide";
-    }>>;
-    aggregate: import("zod").ZodDefault<import("zod").ZodEnum<{
-        all: "all";
-        first: "first";
-        mean: "mean";
-        median: "median";
-    }>>;
-    loadLimit: import("zod").ZodOptional<import("zod").ZodNumber>;
-    extraFilters: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
-}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-    alias: import("zod").ZodString;
-    studies: import("zod").ZodArray<import("zod").ZodString>;
-    shape: import("zod").ZodEnum<{
-        long: "long";
-        wide: "wide";
-    }>;
-    aggregate: import("zod").ZodEnum<{
-        all: "all";
-        first: "first";
-        mean: "mean";
-        median: "median";
-    }>;
-    observationCount: import("zod").ZodNumber;
-    germplasmCount: import("zod").ZodNumber;
-    variableCount: import("zod").ZodNumber;
-    variableLegend: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>;
-    dataframe: import("zod").ZodOptional<import("zod").ZodObject<{
-        tableName: import("zod").ZodString;
-        rowCount: import("zod").ZodNumber;
-        columns: import("zod").ZodArray<import("zod").ZodString>;
-        columnLegend: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
-        createdAt: import("zod").ZodString;
-        expiresAt: import("zod").ZodString;
-        truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
-        maxRows: import("zod").ZodOptional<import("zod").ZodNumber>;
-        totalCount: import("zod").ZodOptional<import("zod").ZodNumber>;
-    }, import("zod/v4/core").$strip>>;
-    warnings: import("zod").ZodArray<import("zod").ZodString>;
-}, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: 'unknown_alias';
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: 'No connection has been registered under the requested alias';
-    readonly recovery: 'Run brapi_connect with this alias (or omit `alias` to use the default connection) before calling brapi_build_phenotype_matrix.';
     readonly thrownBy: 'service';
 }, {
-    readonly reason: 'all_filters_dropped';
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: 'The active dialect dropped every filter supplied — the call would silently widen to the unfiltered baseline';
-    readonly recovery: 'Drop unsupported filters or use studies / germplasm / variables to scope the query to supported filter paths on the active dialect.';
+    readonly reason: 'upstream_unauthorized';
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Unauthorized;
+    readonly when: 'The server answered HTTP 401 on /serverinfo or /calls — it requires login for capability discovery';
+    readonly recovery: 'Retry brapi_connect with credentials in `auth` (sgn, bearer, api_key, or oauth2), or ask the operator to configure credentials for this alias server-side.';
     readonly thrownBy: 'service';
 }, {
-    readonly reason: 'no_observation_path';
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
-    readonly when: 'Neither /observations nor /observationunits returned data for any requested study after probing both paths';
-    readonly recovery: 'Verify the studyDbIds exist and the BrAPI server exposes /observations or /observationunits. Use brapi_server_info to inspect the capability list.';
-}], {
-    readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
-    readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
-    readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
-    readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
-}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    readonly reason: 'upstream_forbidden';
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
+    readonly when: 'The server answered HTTP 403 on /serverinfo or /calls — the request (anonymous or credentialed) lacks read access';
+    readonly recovery: 'Retry brapi_connect with credentials that have read access to this server, or ask the operator to configure such credentials for this alias server-side.';
+    readonly thrownBy: 'service';
+}], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
     alias: import("zod").ZodOptional<import("zod").ZodString>;
     forceRefresh: import("zod").ZodDefault<import("zod").ZodBoolean>;
 }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
@@ -565,6 +611,18 @@ export declare const readOnlyToolDefinitions: (import("@cyanheads/mcp-ts-core").
         citation: import("zod").ZodString;
         isDemo: import("zod").ZodOptional<import("zod").ZodBoolean>;
     }, import("zod/v4/core").$strip>>;
+    nextToolSuggestions: import("zod").ZodArray<import("zod").ZodObject<{
+        toolName: import("zod").ZodEnum<{
+            brapi_find_germplasm: "brapi_find_germplasm";
+            brapi_find_locations: "brapi_find_locations";
+            brapi_find_studies: "brapi_find_studies";
+            brapi_find_variables: "brapi_find_variables";
+        }>;
+        reason: import("zod").ZodString;
+        args: import("zod").ZodObject<{
+            alias: import("zod").ZodString;
+        }, import("zod/v4/core").$strip>;
+    }, import("zod/v4/core").$strip>>;
     notes: import("zod").ZodArray<import("zod").ZodString>;
     fetchedAt: import("zod").ZodString;
 }, import("zod/v4/core").$strip>, readonly [{

package/dist/mcp-server/tools/definitions/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA4BH;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuBnC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB;;;;;yDAAuB,CAAC;AAExD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBAAyB,CAAC;AAE5D,qEAAqE;AACrE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA4BH;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuBnC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB;;;;;yDAAuB,CAAC;AAExD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBAAyB,CAAC;AAE5D,qEAAqE;AACrE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBAA4B,CAAC"}

package/dist/mcp-server/tools/shared/find-helpers.d.ts

@@ -99,6 +99,12 @@ export interface ResolveFindRouteInput {
  * preserves the multi-value semantics the GET wire shape would have lost.
  */
 export declare function resolveFindRoute(input: ResolveFindRouteInput): FindRoute;
+/**
+ * True when {@link resolveFindRoute} picks a route for `noun` on this server
+ * instead of throwing: GET `/{noun}` is advertised, or POST `/search/{noun}`
+ * is advertised and the active dialect does not mark it known-dead.
+ */
+export declare function hasFindRoute(profile: CapabilityProfile, dialect: Pick<BrapiDialect, 'disabledSearchEndpoints'>, noun: string): boolean;
 /** Build request options with optional auth. */
 export declare function buildRequestOptions(connection: RegisteredServer, params?: BrapiRequestOptions['params'], overrides?: BrapiRequestOptions): BrapiRequestOptions;
 /**