@cyanheads/brapi-mcp-server 0.7.9 → 0.7.11

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

@@ -25,13 +25,13 @@ export declare const readOnlyToolDefinitions: (import("@cyanheads/mcp-ts-core").
     filters: import("zod").ZodArray<import("zod").ZodObject<{
         name: import("zod").ZodString;
         type: import("zod").ZodEnum<{
-            string: "string";
-            number: "number";
             boolean: "boolean";
             date: "date";
             integer: "integer";
-            "string[]": "string[]";
             "integer[]": "integer[]";
+            number: "number";
+            string: "string";
+            "string[]": "string[]";
         }>;
         description: import("zod").ZodString;
         example: import("zod").ZodString;
@@ -39,128 +39,10 @@ export declare const readOnlyToolDefinitions: (import("@cyanheads/mcp-ts-core").
     specReference: import("zod").ZodOptional<import("zod").ZodString>;
     availableEndpoints: import("zod").ZodArray<import("zod").ZodString>;
 }, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: "unknown_endpoint";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "No filter catalog is registered for the requested endpoint";
-    readonly recovery: "Pick an endpoint from data.availableEndpoints — same set as the input enum (studies, germplasm, observations, variables, images, variants, locations).";
-}], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
-    germplasmDbId: import("zod").ZodString;
-    alias: import("zod").ZodOptional<import("zod").ZodString>;
-}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-    alias: import("zod").ZodString;
-    germplasm: import("zod").ZodObject<{
-        germplasmDbId: import("zod").ZodString;
-        germplasmName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        germplasmPUI: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        commonCropName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        accessionNumber: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        genus: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        species: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        subtaxa: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        defaultDisplayName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        pedigree: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        biologicalStatusOfAccessionDescription: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        germplasmOrigin: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodObject<{}, import("zod/v4/core").$loose>>>>;
-        countryOfOriginCode: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        collection: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        instituteCode: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        instituteName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        synonyms: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodObject<{
-            synonym: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-            type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        }, import("zod/v4/core").$loose>>>>;
-    }, import("zod/v4/core").$loose>;
-    parents: import("zod").ZodArray<import("zod").ZodObject<{
-        germplasmDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        germplasmName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        parentType: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-    }, import("zod/v4/core").$loose>>;
-    attributes: import("zod").ZodArray<import("zod").ZodObject<{
-        attributeDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        attributeName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        attributeValue: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        determinedDate: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-    }, import("zod/v4/core").$loose>>;
-    studyCount: import("zod").ZodOptional<import("zod").ZodNumber>;
-    directParentCount: import("zod").ZodNumber;
-    directDescendantCount: import("zod").ZodOptional<import("zod").ZodNumber>;
-    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_get_germplasm.";
-}, {
-    readonly reason: "germplasm_not_found";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "Upstream returned no germplasm record for the requested DbId";
-    readonly recovery: "Verify the germplasmDbId on the target server, or run brapi_find_germplasm to discover valid IDs.";
-}], 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<{
-    alias: import("zod").ZodString;
-    baseUrl: import("zod").ZodString;
-    server: import("zod").ZodObject<{
-        name: import("zod").ZodOptional<import("zod").ZodString>;
-        description: import("zod").ZodOptional<import("zod").ZodString>;
-        organizationName: import("zod").ZodOptional<import("zod").ZodString>;
-        organizationURL: import("zod").ZodOptional<import("zod").ZodString>;
-        documentationURL: import("zod").ZodOptional<import("zod").ZodString>;
-        contactEmail: import("zod").ZodOptional<import("zod").ZodString>;
-        brapiVersion: import("zod").ZodOptional<import("zod").ZodString>;
-    }, import("zod/v4/core").$strip>;
-    auth: import("zod").ZodObject<{
-        mode: import("zod").ZodEnum<{
-            none: "none";
-            sgn: "sgn";
-            oauth2: "oauth2";
-            api_key: "api_key";
-            bearer: "bearer";
-        }>;
-        headerName: import("zod").ZodOptional<import("zod").ZodString>;
-        expiresAt: import("zod").ZodOptional<import("zod").ZodString>;
-    }, import("zod/v4/core").$strip>;
-    capabilities: import("zod").ZodObject<{
-        supportedCount: import("zod").ZodNumber;
-        supported: import("zod").ZodArray<import("zod").ZodString>;
-        notableGaps: import("zod").ZodArray<import("zod").ZodString>;
-    }, import("zod/v4/core").$strip>;
-    dialect: import("zod").ZodObject<{
-        id: import("zod").ZodString;
-        source: import("zod").ZodEnum<{
-            "env-override": "env-override";
-            "url-pattern": "url-pattern";
-            "server-name": "server-name";
-            "organization-name": "organization-name";
-            fallback: "fallback";
-        }>;
-        envVar: import("zod").ZodString;
-        disabledSearchEndpoints: import("zod").ZodArray<import("zod").ZodString>;
-        notes: import("zod").ZodArray<import("zod").ZodString>;
-        verifiedMappingCount: import("zod").ZodOptional<import("zod").ZodNumber>;
-        inferredMappingCount: import("zod").ZodOptional<import("zod").ZodNumber>;
-    }, import("zod/v4/core").$strip>;
-    content: import("zod").ZodObject<{
-        crops: import("zod").ZodArray<import("zod").ZodString>;
-        studyCount: import("zod").ZodOptional<import("zod").ZodNumber>;
-        germplasmCount: import("zod").ZodOptional<import("zod").ZodNumber>;
-        programCount: import("zod").ZodOptional<import("zod").ZodNumber>;
-        locationCount: import("zod").ZodOptional<import("zod").ZodNumber>;
-    }, import("zod/v4/core").$strip>;
-    attribution: import("zod").ZodOptional<import("zod").ZodObject<{
-        homepage: import("zod").ZodString;
-        license: import("zod").ZodString;
-        citation: import("zod").ZodString;
-        isDemo: import("zod").ZodOptional<import("zod").ZodBoolean>;
-    }, import("zod/v4/core").$strip>>;
-    notes: import("zod").ZodArray<import("zod").ZodString>;
-    fetchedAt: import("zod").ZodString;
-}, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: "unknown_alias";
+    readonly reason: 'unknown_endpoint';
     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_server_info.";
+    readonly when: 'No filter catalog is registered for the requested endpoint';
+    readonly recovery: 'Pick an endpoint from data.availableEndpoints — same set as the input enum (studies, germplasm, observations, variables, images, variants, locations).';
 }], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
     studyDbId: import("zod").ZodString;
     alias: import("zod").ZodOptional<import("zod").ZodString>;
@@ -221,50 +103,43 @@ export declare const readOnlyToolDefinitions: (import("@cyanheads/mcp-ts-core").
     variableCount: import("zod").ZodOptional<import("zod").ZodNumber>;
     warnings: import("zod").ZodArray<import("zod").ZodString>;
 }, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: "unknown_alias";
+    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_get_study.";
+    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_get_study.';
 }, {
-    readonly reason: "study_not_found";
+    readonly reason: 'study_not_found';
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    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.";
+    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<{
-        wide: "wide";
-        long: "long";
-    }>>;
-    aggregate: import("zod").ZodDefault<import("zod").ZodEnum<{
-        all: "all";
-        mean: "mean";
-        median: "median";
-        first: "first";
-    }>>;
-    loadLimit: import("zod").ZodOptional<import("zod").ZodNumber>;
-    extraFilters: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+    germplasmDbIds: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    variantSetDbId: import("zod").ZodString;
+    format: import("zod").ZodEnum<{
+        "matrix-json": "matrix-json";
+        plink: "plink";
+        "vcf-lite": "vcf-lite";
+    }>;
+    maxCalls: import("zod").ZodOptional<import("zod").ZodNumber>;
+    maxColumns: import("zod").ZodOptional<import("zod").ZodNumber>;
 }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
     alias: import("zod").ZodString;
-    studies: import("zod").ZodArray<import("zod").ZodString>;
-    shape: import("zod").ZodEnum<{
-        wide: "wide";
-        long: "long";
-    }>;
-    aggregate: import("zod").ZodEnum<{
-        all: "all";
-        mean: "mean";
-        median: "median";
-        first: "first";
+    format: import("zod").ZodEnum<{
+        "matrix-json": "matrix-json";
+        plink: "plink";
+        "vcf-lite": "vcf-lite";
     }>;
-    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<{
+    rowCount: import("zod").ZodNumber;
+    columnCount: import("zod").ZodNumber;
+    variantColumnLegend: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>;
+    callFormatting: import("zod").ZodObject<{
+        expandHomozygotes: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodBoolean>>;
+        unknownString: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        sepPhased: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        sepUnphased: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    }, import("zod/v4/core").$strip>;
+    dataframe: import("zod").ZodObject<{
         tableName: import("zod").ZodString;
         rowCount: import("zod").ZodNumber;
         columns: import("zod").ZodArray<import("zod").ZodString>;
@@ -274,184 +149,66 @@ export declare const readOnlyToolDefinitions: (import("@cyanheads/mcp-ts-core").
         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>>;
+    }, import("zod/v4/core").$strip>;
+    vcf: import("zod").ZodOptional<import("zod").ZodString>;
+    ped: import("zod").ZodOptional<import("zod").ZodString>;
+    map: import("zod").ZodOptional<import("zod").ZodString>;
+    truncated: import("zod").ZodBoolean;
     warnings: import("zod").ZodArray<import("zod").ZodString>;
 }, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: "unknown_alias";
+    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 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_export_genotype_matrix.';
 }, {
-    readonly reason: "all_filters_dropped";
+    readonly reason: 'no_filters';
     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 when: 'No variantSetDbId was provided';
+    readonly recovery: 'Provide variantSetDbId before retrying — unfiltered genotype-call pulls are too expensive.';
 }, {
-    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 reason: 'search_endpoint_disabled';
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: 'The active dialect declares POST /search/calls as known-dead on this server';
+    readonly recovery: 'Connect to a different BrAPI server that exposes a working /search/calls route — genotype-call workflows are not viable here.';
 }], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
-    baseUrl: import("zod").ZodOptional<import("zod").ZodString>;
-    auth: import("zod").ZodOptional<import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
-        mode: import("zod").ZodLiteral<"none">;
-    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-        mode: import("zod").ZodLiteral<"bearer">;
-        token: import("zod").ZodString;
-    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-        mode: import("zod").ZodLiteral<"api_key">;
-        apiKey: import("zod").ZodString;
-        headerName: import("zod").ZodOptional<import("zod").ZodString>;
-    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-        mode: import("zod").ZodLiteral<"sgn">;
-        username: import("zod").ZodString;
-        password: import("zod").ZodString;
-    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-        mode: import("zod").ZodLiteral<"oauth2">;
-        clientId: import("zod").ZodString;
-        clientSecret: import("zod").ZodString;
-        tokenUrl: import("zod").ZodOptional<import("zod").ZodString>;
-    }, import("zod/v4/core").$strip>], "mode">>;
-    alias: import("zod").ZodDefault<import("zod").ZodString>;
+    alias: import("zod").ZodOptional<import("zod").ZodString>;
+    locations: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    locationNames: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    countryCodes: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    countryNames: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    locationTypes: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    abbreviations: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    bbox: import("zod").ZodOptional<import("zod").ZodObject<{
+        minLat: import("zod").ZodOptional<import("zod").ZodNumber>;
+        maxLat: import("zod").ZodOptional<import("zod").ZodNumber>;
+        minLon: import("zod").ZodOptional<import("zod").ZodNumber>;
+        maxLon: import("zod").ZodOptional<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>>;
+    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;
-    baseUrl: import("zod").ZodString;
-    server: import("zod").ZodObject<{
-        name: import("zod").ZodOptional<import("zod").ZodString>;
-        description: import("zod").ZodOptional<import("zod").ZodString>;
-        organizationName: import("zod").ZodOptional<import("zod").ZodString>;
-        organizationURL: import("zod").ZodOptional<import("zod").ZodString>;
-        documentationURL: import("zod").ZodOptional<import("zod").ZodString>;
-        contactEmail: import("zod").ZodOptional<import("zod").ZodString>;
-        brapiVersion: import("zod").ZodOptional<import("zod").ZodString>;
-    }, import("zod/v4/core").$strip>;
-    auth: import("zod").ZodObject<{
-        mode: import("zod").ZodEnum<{
-            none: "none";
-            sgn: "sgn";
-            oauth2: "oauth2";
-            api_key: "api_key";
-            bearer: "bearer";
-        }>;
-        headerName: import("zod").ZodOptional<import("zod").ZodString>;
-        expiresAt: import("zod").ZodOptional<import("zod").ZodString>;
-    }, import("zod/v4/core").$strip>;
-    capabilities: import("zod").ZodObject<{
-        supportedCount: import("zod").ZodNumber;
-        supported: import("zod").ZodArray<import("zod").ZodString>;
-        notableGaps: import("zod").ZodArray<import("zod").ZodString>;
+    results: import("zod").ZodArray<import("zod").ZodObject<{
+        locationDbId: import("zod").ZodString;
+        locationName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        abbreviation: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        countryCode: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        countryName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        locationType: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        latitude: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodNumber>>;
+        longitude: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodNumber>>;
+        altitude: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodNumber>>;
+        coordinates: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodObject<{}, import("zod/v4/core").$loose>>>;
+        instituteName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        instituteAddress: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        documentationURL: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    }, import("zod/v4/core").$loose>>;
+    hasMore: import("zod").ZodBoolean;
+    distributions: import("zod").ZodObject<{
+        countryCode: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        locationType: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
     }, import("zod/v4/core").$strip>;
-    dialect: import("zod").ZodObject<{
-        id: import("zod").ZodString;
-        source: import("zod").ZodEnum<{
-            "env-override": "env-override";
-            "url-pattern": "url-pattern";
-            "server-name": "server-name";
-            "organization-name": "organization-name";
-            fallback: "fallback";
-        }>;
-        envVar: import("zod").ZodString;
-        disabledSearchEndpoints: import("zod").ZodArray<import("zod").ZodString>;
-        notes: import("zod").ZodArray<import("zod").ZodString>;
-        verifiedMappingCount: import("zod").ZodOptional<import("zod").ZodNumber>;
-        inferredMappingCount: import("zod").ZodOptional<import("zod").ZodNumber>;
-    }, import("zod/v4/core").$strip>;
-    content: import("zod").ZodObject<{
-        crops: import("zod").ZodArray<import("zod").ZodString>;
-        studyCount: import("zod").ZodOptional<import("zod").ZodNumber>;
-        germplasmCount: import("zod").ZodOptional<import("zod").ZodNumber>;
-        programCount: import("zod").ZodOptional<import("zod").ZodNumber>;
-        locationCount: import("zod").ZodOptional<import("zod").ZodNumber>;
-    }, import("zod/v4/core").$strip>;
-    attribution: import("zod").ZodOptional<import("zod").ZodObject<{
-        homepage: import("zod").ZodString;
-        license: import("zod").ZodString;
-        citation: import("zod").ZodString;
-        isDemo: import("zod").ZodOptional<import("zod").ZodBoolean>;
-    }, 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_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 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<{
-    dataframe: import("zod").ZodOptional<import("zod").ZodString>;
-}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-    tables: import("zod").ZodArray<import("zod").ZodObject<{
-        name: import("zod").ZodString;
-        rowCount: import("zod").ZodNumber;
-        columns: import("zod").ZodArray<import("zod").ZodObject<{
-            name: import("zod").ZodString;
-            type: import("zod").ZodString;
-            nullable: import("zod").ZodOptional<import("zod").ZodBoolean>;
-        }, import("zod/v4/core").$strip>>;
-        approxSizeBytes: import("zod").ZodOptional<import("zod").ZodNumber>;
-        provenance: import("zod").ZodOptional<import("zod").ZodObject<{
-            source: import("zod").ZodString;
-            baseUrl: import("zod").ZodString;
-            query: import("zod").ZodUnknown;
-            createdAt: import("zod").ZodString;
-            expiresAt: import("zod").ZodString;
-        }, import("zod/v4/core").$strip>>;
-    }, import("zod/v4/core").$strip>>;
-}, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: "list_all_disabled_on_shared_http";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
-    readonly when: "This server is running as a shared HTTP endpoint without per-caller auth — listing every dataframe would expose other concurrent clients' workspaces, since all callers resolve to one shared tenant.";
-    readonly recovery: "Pass `dataframe` with a specific name — either from a prior find_* spillover result (`result.dataframe.tableName`) or one you registered via `brapi_dataframe_query` with `registerAs`. Listing all dataframes is not available on this deployment.";
-}], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
-    sql: import("zod").ZodString;
-    registerAs: import("zod").ZodOptional<import("zod").ZodString>;
-    preview: import("zod").ZodOptional<import("zod").ZodNumber>;
-    rowLimit: import("zod").ZodOptional<import("zod").ZodNumber>;
-}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-    rowCount: import("zod").ZodNumber;
-    columns: import("zod").ZodArray<import("zod").ZodObject<{
-        name: import("zod").ZodString;
-        type: import("zod").ZodString;
-    }, import("zod/v4/core").$strip>>;
-    rows: import("zod").ZodArray<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
-    dataframe: import("zod").ZodOptional<import("zod").ZodString>;
-}, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: "sql_rejected";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "SQL violated read-only rules (multi-statement, non-SELECT, or disallowed operation)";
-    readonly recovery: "Submit a single SELECT statement using only registered dataframes. For changes, use `registerAs` in this tool to materialize a result, or brapi_dataframe_drop to remove a dataframe.";
-}], undefined> | 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;
-    format: import("zod").ZodEnum<{
-        plink: "plink";
-        "vcf-lite": "vcf-lite";
-        "matrix-json": "matrix-json";
-    }>;
-    maxCalls: import("zod").ZodOptional<import("zod").ZodNumber>;
-    maxColumns: import("zod").ZodOptional<import("zod").ZodNumber>;
-}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-    alias: import("zod").ZodString;
-    format: import("zod").ZodEnum<{
-        plink: "plink";
-        "vcf-lite": "vcf-lite";
-        "matrix-json": "matrix-json";
-    }>;
-    rowCount: import("zod").ZodNumber;
-    columnCount: import("zod").ZodNumber;
-    variantColumnLegend: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>;
-    callFormatting: import("zod").ZodObject<{
-        expandHomozygotes: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodBoolean>>;
-        unknownString: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        sepPhased: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        sepUnphased: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-    }, import("zod/v4/core").$strip>;
-    dataframe: import("zod").ZodObject<{
+    dataframe: import("zod").ZodOptional<import("zod").ZodObject<{
         tableName: import("zod").ZodString;
         rowCount: import("zod").ZodNumber;
         columns: import("zod").ZodArray<import("zod").ZodString>;
@@ -461,65 +218,59 @@ export declare const readOnlyToolDefinitions: (import("@cyanheads/mcp-ts-core").
         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>;
-    vcf: import("zod").ZodOptional<import("zod").ZodString>;
-    ped: import("zod").ZodOptional<import("zod").ZodString>;
-    map: import("zod").ZodOptional<import("zod").ZodString>;
-    truncated: import("zod").ZodBoolean;
-    warnings: import("zod").ZodArray<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
+    coordinateAxisOrder: import("zod").ZodEnum<{
+        spec: "spec";
+        swapped: "swapped";
+    }>;
 }, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: "unknown_alias";
+    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_export_genotype_matrix.";
+    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_find_locations.';
 }, {
-    readonly reason: "no_filters";
+    readonly reason: 'all_filters_dropped';
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "No variantSetDbId was provided";
-    readonly recovery: "Provide variantSetDbId before retrying — unfiltered genotype-call pulls are too expensive.";
-}, {
-    readonly reason: "search_endpoint_disabled";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "The active dialect declares POST /search/calls as known-dead on this server";
-    readonly recovery: "Connect to a different BrAPI server that exposes a working /search/calls route — genotype-call workflows are not viable here.";
-}], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    readonly when: 'The active dialect dropped every filter the agent supplied — the upstream server does not honor any of the requested scope filters on this endpoint, so the call would silently widen to the unfiltered baseline.';
+    readonly recovery: 'Drop the unsupported filters and rescope by locations, locationNames, countryCodes, locationTypes, abbreviations, or bbox — these filter paths are honored on the active dialect.';
+}], {
+    readonly totalCount: import("zod").ZodNumber;
+    readonly returnedCount: import("zod").ZodNumber;
+    readonly appliedFilters: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+    readonly refinementHint: import("zod").ZodOptional<import("zod").ZodString>;
+    readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
+    readonly warnings: import("zod").ZodArray<import("zod").ZodString>;
+}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
     alias: import("zod").ZodOptional<import("zod").ZodString>;
-    variantSetDbId: import("zod").ZodOptional<import("zod").ZodString>;
-    variantSetDbIds: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    germplasmDbIds: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    callSetDbIds: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    variantDbIds: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    callFormat: import("zod").ZodOptional<import("zod").ZodEnum<{
-        JSON: "JSON";
-        VCF: "VCF";
-        FLAPJACK: "FLAPJACK";
-        DARTSEQ: "DARTSEQ";
-    }>>;
+    variantSets: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    variants: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    references: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    referenceName: import("zod").ZodOptional<import("zod").ZodString>;
+    start: import("zod").ZodOptional<import("zod").ZodNumber>;
+    end: import("zod").ZodOptional<import("zod").ZodNumber>;
     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;
     results: import("zod").ZodArray<import("zod").ZodObject<{
-        callSetDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        callSetName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        variantDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        variantName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        variantSetDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        genotype: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodObject<{
-            values: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodString>>>;
-        }, import("zod/v4/core").$loose>>>;
-        genotypeValue: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        phaseSet: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        variantDbId: import("zod").ZodString;
+        variantNames: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodString>>>;
+        variantSetDbId: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodArray<import("zod").ZodString>, import("zod").ZodNull]>>;
+        variantSetDbIds: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodString>>>;
+        variantType: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        referenceBases: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        alternateBases: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodString>>>;
+        referenceName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        start: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodNumber>>;
+        end: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodNumber>>;
+        filtersPassed: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodBoolean>>;
+        filtersApplied: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodBoolean>>;
+        filtersFailed: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodString>>>;
     }, import("zod/v4/core").$loose>>;
     hasMore: import("zod").ZodBoolean;
-    callFormatting: import("zod").ZodObject<{
-        expandHomozygotes: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodBoolean>>;
-        unknownString: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        sepPhased: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        sepUnphased: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-    }, import("zod/v4/core").$strip>;
     distributions: import("zod").ZodObject<{
-        callSetName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
-        variantName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        variantType: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        referenceName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
         variantSetDbId: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
     }, import("zod/v4/core").$strip>;
     dataframe: import("zod").ZodOptional<import("zod").ZodObject<{
@@ -533,74 +284,42 @@ export declare const readOnlyToolDefinitions: (import("@cyanheads/mcp-ts-core").
         maxRows: import("zod").ZodOptional<import("zod").ZodNumber>;
         totalCount: import("zod").ZodOptional<import("zod").ZodNumber>;
     }, import("zod/v4/core").$strip>>;
-    truncated: import("zod").ZodBoolean;
 }, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: "unknown_alias";
+    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_find_genotype_calls.";
+    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_find_variants.';
 }, {
-    readonly reason: "no_filters";
+    readonly reason: 'all_filters_dropped';
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "No variant set, germplasm, call set, or variant filter was provided";
-    readonly recovery: "Provide variantSetDbId or germplasmDbIds before retrying — unfiltered pulls are too expensive.";
-}, {
-    readonly reason: "search_endpoint_disabled";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "The active dialect declares POST /search/calls as known-dead on this server";
-    readonly recovery: "Connect to a different BrAPI server that exposes a working /search/calls route — genotype-call workflows are not viable here.";
+    readonly when: 'The active dialect dropped every filter the agent supplied — the upstream server does not honor any of the requested scope filters on this endpoint, so the call would silently widen to the unfiltered baseline.';
+    readonly recovery: 'Drop the unsupported filters and rescope by variants, variantSets, references, or referenceName + start/end — these filter paths are honored on the active dialect.';
 }], {
     readonly totalCount: import("zod").ZodNumber;
     readonly returnedCount: import("zod").ZodNumber;
     readonly appliedFilters: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+    readonly refinementHint: import("zod").ZodOptional<import("zod").ZodString>;
     readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
     readonly warnings: import("zod").ZodArray<import("zod").ZodString>;
 }> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
     alias: import("zod").ZodOptional<import("zod").ZodString>;
-    names: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    germplasmDbIds: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    germplasmPUIs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    accessionNumbers: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    crops: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    synonyms: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    collections: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    genus: import("zod").ZodOptional<import("zod").ZodString>;
-    species: import("zod").ZodOptional<import("zod").ZodString>;
-    text: import("zod").ZodOptional<import("zod").ZodString>;
+    path: import("zod").ZodString;
+    params: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodNumber, import("zod").ZodBoolean, import("zod").ZodArray<import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodNumber]>>]>>>;
     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;
-    results: import("zod").ZodArray<import("zod").ZodObject<{
-        germplasmDbId: import("zod").ZodString;
-        germplasmName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        germplasmPUI: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        commonCropName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        accessionNumber: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        genus: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        species: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        subtaxa: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        defaultDisplayName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        pedigree: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        biologicalStatusOfAccessionDescription: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        germplasmOrigin: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodObject<{}, import("zod/v4/core").$loose>>>>;
-        countryOfOriginCode: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        collection: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        instituteCode: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        instituteName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        synonyms: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodObject<{
-            synonym: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-            type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        }, import("zod/v4/core").$loose>>>>;
-    }, import("zod/v4/core").$loose>>;
-    hasMore: import("zod").ZodBoolean;
-    distributions: import("zod").ZodObject<{
-        commonCropName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
-        genus: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
-        species: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
-        collection: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
-        countryOfOriginCode: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
-    }, import("zod/v4/core").$strip>;
+    url: import("zod").ZodString;
+    path: import("zod").ZodString;
+    metadata: import("zod").ZodObject<{
+        pagination: import("zod").ZodOptional<import("zod").ZodObject<{
+            currentPage: import("zod").ZodNumber;
+            pageSize: import("zod").ZodNumber;
+            totalCount: import("zod").ZodNumber;
+            totalPages: import("zod").ZodNumber;
+        }, import("zod/v4/core").$loose>>;
+    }, import("zod/v4/core").$loose>;
+    result: import("zod").ZodUnknown;
+    suggestion: import("zod").ZodOptional<import("zod").ZodString>;
     dataframe: import("zod").ZodOptional<import("zod").ZodObject<{
         tableName: import("zod").ZodString;
         rowCount: import("zod").ZodNumber;
@@ -613,61 +332,139 @@ export declare const readOnlyToolDefinitions: (import("@cyanheads/mcp-ts-core").
         totalCount: import("zod").ZodOptional<import("zod").ZodNumber>;
     }, import("zod/v4/core").$strip>>;
 }, 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_find_germplasm.";
+    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_raw_get.';
+}, {
+    readonly reason: 'cross_origin_path';
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: 'path argument was a full URL instead of a relative BrAPI route';
+    readonly recovery: 'Pass a path like "/samples" or "/methods" — the connection alias supplies the baseUrl.';
+}], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    baseUrl: import("zod").ZodOptional<import("zod").ZodString>;
+    auth: import("zod").ZodOptional<import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
+        mode: import("zod").ZodLiteral<"none">;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+        mode: import("zod").ZodLiteral<"bearer">;
+        token: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+        mode: import("zod").ZodLiteral<"api_key">;
+        apiKey: import("zod").ZodString;
+        headerName: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+        mode: import("zod").ZodLiteral<"sgn">;
+        username: import("zod").ZodString;
+        password: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+        mode: import("zod").ZodLiteral<"oauth2">;
+        clientId: import("zod").ZodString;
+        clientSecret: import("zod").ZodString;
+        tokenUrl: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>], "mode">>;
+    alias: import("zod").ZodDefault<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    alias: import("zod").ZodString;
+    baseUrl: import("zod").ZodString;
+    server: import("zod").ZodObject<{
+        name: import("zod").ZodOptional<import("zod").ZodString>;
+        description: import("zod").ZodOptional<import("zod").ZodString>;
+        organizationName: import("zod").ZodOptional<import("zod").ZodString>;
+        organizationURL: import("zod").ZodOptional<import("zod").ZodString>;
+        documentationURL: import("zod").ZodOptional<import("zod").ZodString>;
+        contactEmail: import("zod").ZodOptional<import("zod").ZodString>;
+        brapiVersion: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>;
+    auth: import("zod").ZodObject<{
+        mode: import("zod").ZodEnum<{
+            api_key: "api_key";
+            bearer: "bearer";
+            none: "none";
+            oauth2: "oauth2";
+            sgn: "sgn";
+        }>;
+        headerName: import("zod").ZodOptional<import("zod").ZodString>;
+        expiresAt: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>;
+    capabilities: import("zod").ZodObject<{
+        supportedCount: import("zod").ZodNumber;
+        supported: import("zod").ZodArray<import("zod").ZodString>;
+        notableGaps: import("zod").ZodArray<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>;
+    dialect: import("zod").ZodObject<{
+        id: import("zod").ZodString;
+        source: import("zod").ZodEnum<{
+            "env-override": "env-override";
+            fallback: "fallback";
+            "organization-name": "organization-name";
+            "server-name": "server-name";
+            "url-pattern": "url-pattern";
+        }>;
+        envVar: import("zod").ZodString;
+        disabledSearchEndpoints: import("zod").ZodArray<import("zod").ZodString>;
+        notes: import("zod").ZodArray<import("zod").ZodString>;
+        verifiedMappingCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+        inferredMappingCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>;
+    content: import("zod").ZodObject<{
+        crops: import("zod").ZodArray<import("zod").ZodString>;
+        studyCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+        germplasmCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+        programCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+        locationCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>;
+    attribution: import("zod").ZodOptional<import("zod").ZodObject<{
+        homepage: import("zod").ZodString;
+        license: import("zod").ZodString;
+        citation: import("zod").ZodString;
+        isDemo: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    }, 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_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 reason: "all_filters_dropped";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "The active dialect dropped every filter the agent supplied — the upstream server does not honor any of the requested scope filters on this endpoint, so the call would silently widen to the unfiltered baseline.";
-    readonly recovery: "Drop the unsupported filters and rescope by names, germplasmDbIds, germplasmPUIs, accessionNumbers, crops, synonyms, genus, or species — these filter paths are honored on the active dialect.";
-}], {
-    readonly totalCount: import("zod").ZodNumber;
-    readonly returnedCount: import("zod").ZodNumber;
-    readonly appliedFilters: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
-    readonly refinementHint: import("zod").ZodOptional<import("zod").ZodString>;
-    readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
-    readonly warnings: import("zod").ZodArray<import("zod").ZodString>;
-}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    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>;
-    images: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    observationUnits: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    observations: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    studies: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    imageFileNames: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    mimeTypes: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    descriptiveOntologyTerms: import("zod").ZodOptional<import("zod").ZodArray<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;
-    results: import("zod").ZodArray<import("zod").ZodObject<{
-        imageDbId: import("zod").ZodString;
-        imageName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        imageFileName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        imageFileSize: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodCoercedNumber<unknown>>>;
-        imageHeight: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodCoercedNumber<unknown>>>;
-        imageWidth: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodCoercedNumber<unknown>>>;
-        mimeType: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        imageTimeStamp: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        imageURL: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        observationUnitDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        observationUnitName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        observationDbIds: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodString>>>;
-        studyDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        studyName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        descriptiveOntologyTerms: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodString>>>;
-        copyright: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        description: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-    }, import("zod/v4/core").$loose>>;
-    hasMore: import("zod").ZodBoolean;
-    distributions: import("zod").ZodObject<{
-        mimeType: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
-        studyName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
-        observationUnitName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
-        descriptiveOntologyTerms: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
-    }, import("zod/v4/core").$strip>;
+    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;
@@ -679,60 +476,133 @@ export declare const readOnlyToolDefinitions: (import("@cyanheads/mcp-ts-core").
         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 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_find_images.";
+    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 reason: "all_filters_dropped";
+    readonly reason: 'all_filters_dropped';
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "The active dialect dropped every filter the agent supplied — the upstream server does not honor any of the requested scope filters on this endpoint, so the call would silently widen to the unfiltered baseline.";
-    readonly recovery: "Drop the unsupported filters and rescope by images, observationUnits, observations, studies, descriptiveOntologyTerms, imageFileNames, or mimeTypes — these filter paths are honored on the active dialect.";
+    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: '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 totalCount: import("zod").ZodNumber;
-    readonly returnedCount: import("zod").ZodNumber;
-    readonly appliedFilters: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
-    readonly refinementHint: import("zod").ZodOptional<import("zod").ZodString>;
+    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>;
-    readonly warnings: import("zod").ZodArray<import("zod").ZodString>;
 }> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
     alias: import("zod").ZodOptional<import("zod").ZodString>;
-    locations: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    locationNames: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    countryCodes: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    countryNames: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    locationTypes: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    abbreviations: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    bbox: import("zod").ZodOptional<import("zod").ZodObject<{
-        minLat: import("zod").ZodOptional<import("zod").ZodNumber>;
-        maxLat: import("zod").ZodOptional<import("zod").ZodNumber>;
-        minLon: import("zod").ZodOptional<import("zod").ZodNumber>;
-        maxLon: import("zod").ZodOptional<import("zod").ZodNumber>;
+    forceRefresh: import("zod").ZodDefault<import("zod").ZodBoolean>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    alias: import("zod").ZodString;
+    baseUrl: import("zod").ZodString;
+    server: import("zod").ZodObject<{
+        name: import("zod").ZodOptional<import("zod").ZodString>;
+        description: import("zod").ZodOptional<import("zod").ZodString>;
+        organizationName: import("zod").ZodOptional<import("zod").ZodString>;
+        organizationURL: import("zod").ZodOptional<import("zod").ZodString>;
+        documentationURL: import("zod").ZodOptional<import("zod").ZodString>;
+        contactEmail: import("zod").ZodOptional<import("zod").ZodString>;
+        brapiVersion: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>;
+    auth: import("zod").ZodObject<{
+        mode: import("zod").ZodEnum<{
+            api_key: "api_key";
+            bearer: "bearer";
+            none: "none";
+            oauth2: "oauth2";
+            sgn: "sgn";
+        }>;
+        headerName: import("zod").ZodOptional<import("zod").ZodString>;
+        expiresAt: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>;
+    capabilities: import("zod").ZodObject<{
+        supportedCount: import("zod").ZodNumber;
+        supported: import("zod").ZodArray<import("zod").ZodString>;
+        notableGaps: import("zod").ZodArray<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>;
+    dialect: import("zod").ZodObject<{
+        id: import("zod").ZodString;
+        source: import("zod").ZodEnum<{
+            "env-override": "env-override";
+            fallback: "fallback";
+            "organization-name": "organization-name";
+            "server-name": "server-name";
+            "url-pattern": "url-pattern";
+        }>;
+        envVar: import("zod").ZodString;
+        disabledSearchEndpoints: import("zod").ZodArray<import("zod").ZodString>;
+        notes: import("zod").ZodArray<import("zod").ZodString>;
+        verifiedMappingCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+        inferredMappingCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>;
+    content: import("zod").ZodObject<{
+        crops: import("zod").ZodArray<import("zod").ZodString>;
+        studyCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+        germplasmCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+        programCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+        locationCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>;
+    attribution: import("zod").ZodOptional<import("zod").ZodObject<{
+        homepage: import("zod").ZodString;
+        license: import("zod").ZodString;
+        citation: import("zod").ZodString;
+        isDemo: import("zod").ZodOptional<import("zod").ZodBoolean>;
     }, import("zod/v4/core").$strip>>;
+    notes: import("zod").ZodArray<import("zod").ZodString>;
+    fetchedAt: 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_server_info.';
+}], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    alias: import("zod").ZodOptional<import("zod").ZodString>;
+    crop: import("zod").ZodOptional<import("zod").ZodString>;
+    trialTypes: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    seasons: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    locations: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    programs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    trials: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    studyNames: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    active: import("zod").ZodOptional<import("zod").ZodBoolean>;
     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;
     results: import("zod").ZodArray<import("zod").ZodObject<{
-        locationDbId: import("zod").ZodString;
+        studyDbId: import("zod").ZodString;
+        studyName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        studyType: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        studyDescription: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        programDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        programName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        trialDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        trialName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        locationDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         locationName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        abbreviation: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        countryCode: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        countryName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        locationType: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        latitude: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodNumber>>;
-        longitude: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodNumber>>;
-        altitude: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodNumber>>;
-        coordinates: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodObject<{}, import("zod/v4/core").$loose>>>;
-        instituteName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        instituteAddress: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        documentationURL: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        commonCropName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        seasons: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodNullable<import("zod").ZodString>>>>;
+        active: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodBoolean>>;
+        startDate: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        endDate: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        studyCode: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        studyPUI: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     }, import("zod/v4/core").$loose>>;
     hasMore: import("zod").ZodBoolean;
     distributions: import("zod").ZodObject<{
-        countryCode: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
-        locationType: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        programName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        studyType: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        seasons: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        locationName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        commonCropName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
     }, import("zod/v4/core").$strip>;
     dataframe: import("zod").ZodOptional<import("zod").ZodObject<{
         tableName: import("zod").ZodString;
@@ -745,20 +615,16 @@ export declare const readOnlyToolDefinitions: (import("@cyanheads/mcp-ts-core").
         maxRows: import("zod").ZodOptional<import("zod").ZodNumber>;
         totalCount: import("zod").ZodOptional<import("zod").ZodNumber>;
     }, import("zod/v4/core").$strip>>;
-    coordinateAxisOrder: import("zod").ZodEnum<{
-        spec: "spec";
-        swapped: "swapped";
-    }>;
 }, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: "unknown_alias";
+    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_find_locations.";
+    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_find_studies.';
 }, {
-    readonly reason: "all_filters_dropped";
+    readonly reason: 'all_filters_dropped';
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "The active dialect dropped every filter the agent supplied — the upstream server does not honor any of the requested scope filters on this endpoint, so the call would silently widen to the unfiltered baseline.";
-    readonly recovery: "Drop the unsupported filters and rescope by locations, locationNames, countryCodes, locationTypes, abbreviations, or bbox — these filter paths are honored on the active dialect.";
+    readonly when: 'The active dialect dropped every filter the agent supplied — the upstream server does not honor any of the requested scope filters on this endpoint, so the call would silently widen to the unfiltered baseline.';
+    readonly recovery: 'Drop the unsupported filters and rescope by crop, trialTypes, seasons, programs, trials, studyNames, or active — these filter paths are honored on the active dialect.';
 }], {
     readonly totalCount: import("zod").ZodNumber;
     readonly returnedCount: import("zod").ZodNumber;
@@ -768,45 +634,49 @@ export declare const readOnlyToolDefinitions: (import("@cyanheads/mcp-ts-core").
     readonly warnings: import("zod").ZodArray<import("zod").ZodString>;
 }> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
     alias: import("zod").ZodOptional<import("zod").ZodString>;
-    studies: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    germplasm: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    variables: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    observationUnits: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    observations: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    seasons: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    programs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    trials: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    observationLevels: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    timestampFrom: import("zod").ZodOptional<import("zod").ZodString>;
-    timestampTo: import("zod").ZodOptional<import("zod").ZodString>;
+    names: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    germplasmDbIds: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    germplasmPUIs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    accessionNumbers: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    crops: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    synonyms: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    collections: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    genus: import("zod").ZodOptional<import("zod").ZodString>;
+    species: import("zod").ZodOptional<import("zod").ZodString>;
+    text: import("zod").ZodOptional<import("zod").ZodString>;
     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;
     results: import("zod").ZodArray<import("zod").ZodObject<{
-        observationDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        observationUnitDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        observationUnitName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        observationVariableDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        observationVariableName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        studyDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        studyName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        germplasmDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        germplasmDbId: import("zod").ZodString;
         germplasmName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        observationLevel: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        season: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodObject<{}, import("zod/v4/core").$loose>, import("zod").ZodNull]>>;
-        value: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        observationTimeStamp: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        collector: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        uploadedBy: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        germplasmPUI: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        commonCropName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        accessionNumber: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        genus: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        species: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        subtaxa: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        defaultDisplayName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        pedigree: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        biologicalStatusOfAccessionDescription: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        germplasmOrigin: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodObject<{}, import("zod/v4/core").$loose>>>>;
+        countryOfOriginCode: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        collection: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        instituteCode: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        instituteName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        synonyms: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodObject<{
+            synonym: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+            type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        }, import("zod/v4/core").$loose>>>>;
     }, import("zod/v4/core").$loose>>;
     hasMore: import("zod").ZodBoolean;
     distributions: import("zod").ZodObject<{
-        observationVariableName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
-        studyName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
-        germplasmName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
-        observationLevel: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
-        season: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        commonCropName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        genus: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        species: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        collection: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        countryOfOriginCode: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
     }, import("zod/v4/core").$strip>;
     dataframe: import("zod").ZodOptional<import("zod").ZodObject<{
         tableName: import("zod").ZodString;
@@ -820,15 +690,15 @@ export declare const readOnlyToolDefinitions: (import("@cyanheads/mcp-ts-core").
         totalCount: import("zod").ZodOptional<import("zod").ZodNumber>;
     }, import("zod/v4/core").$strip>>;
 }, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: "unknown_alias";
+    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_find_observations.";
+    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_find_germplasm.';
 }, {
-    readonly reason: "all_filters_dropped";
+    readonly reason: 'all_filters_dropped';
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "The active dialect dropped every filter the agent supplied — the upstream server does not honor any of the requested scope filters on this endpoint, so the call would silently widen to the unfiltered baseline.";
-    readonly recovery: "Drop the unsupported filters and rescope by germplasm, variables, observationUnits, observations, seasons, programs, or trials — these filter paths are honored on the active dialect.";
+    readonly when: 'The active dialect dropped every filter the agent supplied — the upstream server does not honor any of the requested scope filters on this endpoint, so the call would silently widen to the unfiltered baseline.';
+    readonly recovery: 'Drop the unsupported filters and rescope by names, germplasmDbIds, germplasmPUIs, accessionNumbers, crops, synonyms, genus, or species — these filter paths are honored on the active dialect.';
 }], {
     readonly totalCount: import("zod").ZodNumber;
     readonly returnedCount: import("zod").ZodNumber;
@@ -837,47 +707,115 @@ export declare const readOnlyToolDefinitions: (import("@cyanheads/mcp-ts-core").
     readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
     readonly warnings: import("zod").ZodArray<import("zod").ZodString>;
 }> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    germplasmDbId: import("zod").ZodString;
     alias: import("zod").ZodOptional<import("zod").ZodString>;
-    crop: import("zod").ZodOptional<import("zod").ZodString>;
-    trialTypes: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    seasons: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    locations: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    programs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    trials: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    studyNames: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    active: import("zod").ZodOptional<import("zod").ZodBoolean>;
-    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;
-    results: import("zod").ZodArray<import("zod").ZodObject<{
-        studyDbId: import("zod").ZodString;
-        studyName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        studyType: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        studyDescription: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        programDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        programName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        trialDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        trialName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        locationDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        locationName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    germplasm: import("zod").ZodObject<{
+        germplasmDbId: import("zod").ZodString;
+        germplasmName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        germplasmPUI: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         commonCropName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        seasons: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodNullable<import("zod").ZodString>>>>;
-        active: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodBoolean>>;
-        startDate: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        endDate: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        studyCode: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        studyPUI: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        accessionNumber: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        genus: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        species: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        subtaxa: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        defaultDisplayName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        pedigree: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        biologicalStatusOfAccessionDescription: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        germplasmOrigin: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodObject<{}, import("zod/v4/core").$loose>>>>;
+        countryOfOriginCode: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        collection: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        instituteCode: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        instituteName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        synonyms: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodObject<{
+            synonym: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+            type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        }, import("zod/v4/core").$loose>>>>;
+    }, import("zod/v4/core").$loose>;
+    parents: import("zod").ZodArray<import("zod").ZodObject<{
+        germplasmDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        germplasmName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        parentType: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     }, import("zod/v4/core").$loose>>;
-    hasMore: import("zod").ZodBoolean;
-    distributions: import("zod").ZodObject<{
-        programName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
-        studyType: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
-        seasons: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
-        locationName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
-        commonCropName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
-    }, import("zod/v4/core").$strip>;
-    dataframe: import("zod").ZodOptional<import("zod").ZodObject<{
+    attributes: import("zod").ZodArray<import("zod").ZodObject<{
+        attributeDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        attributeName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        attributeValue: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        determinedDate: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    }, import("zod/v4/core").$loose>>;
+    studyCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+    directParentCount: import("zod").ZodNumber;
+    directDescendantCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+    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_get_germplasm.';
+}, {
+    readonly reason: 'germplasm_not_found';
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: 'Upstream returned no germplasm record for the requested DbId';
+    readonly recovery: 'Verify the germplasmDbId on the target server, or run brapi_find_germplasm to discover valid IDs.';
+}], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    germplasmDbIds: import("zod").ZodArray<import("zod").ZodString>;
+    direction: import("zod").ZodDefault<import("zod").ZodEnum<{
+        ancestors: "ancestors";
+        both: "both";
+        descendants: "descendants";
+    }>>;
+    maxDepth: import("zod").ZodDefault<import("zod").ZodNumber>;
+    loadLimit: import("zod").ZodOptional<import("zod").ZodNumber>;
+    alias: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    alias: import("zod").ZodString;
+    direction: import("zod").ZodEnum<{
+        ancestors: "ancestors";
+        both: "both";
+        descendants: "descendants";
+    }>;
+    maxDepth: import("zod").ZodNumber;
+    nodes: import("zod").ZodArray<import("zod").ZodObject<{
+        germplasmDbId: import("zod").ZodString;
+        germplasmName: import("zod").ZodOptional<import("zod").ZodString>;
+        depth: import("zod").ZodNumber;
+        isRoot: import("zod").ZodBoolean;
+        direction: import("zod").ZodEnum<{
+            ancestor: "ancestor";
+            both: "both";
+            descendant: "descendant";
+            root: "root";
+        }>;
+    }, import("zod/v4/core").$strip>>;
+    edges: import("zod").ZodArray<import("zod").ZodObject<{
+        from: import("zod").ZodString;
+        to: import("zod").ZodString;
+        relationship: import("zod").ZodEnum<{
+            child: "child";
+            parent: "parent";
+        }>;
+        parentType: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
+    depthReached: import("zod").ZodNumber;
+    rootCount: import("zod").ZodNumber;
+    leafCount: import("zod").ZodNumber;
+    cycleCount: import("zod").ZodNumber;
+    deadEndCount: import("zod").ZodNumber;
+    truncated: import("zod").ZodBoolean;
+    warnings: import("zod").ZodArray<import("zod").ZodString>;
+    nodesDataframe: 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>>;
+    edgesDataframe: import("zod").ZodOptional<import("zod").ZodObject<{
         tableName: import("zod").ZodString;
         rowCount: import("zod").ZodNumber;
         columns: import("zod").ZodArray<import("zod").ZodString>;
@@ -889,23 +827,46 @@ export declare const readOnlyToolDefinitions: (import("@cyanheads/mcp-ts-core").
         totalCount: import("zod").ZodOptional<import("zod").ZodNumber>;
     }, import("zod/v4/core").$strip>>;
 }, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: "unknown_alias";
+    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_walk_pedigree.';
+}], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    alias: import("zod").ZodOptional<import("zod").ZodString>;
+    germplasmDbId: import("zod").ZodString;
+    studyDbIds: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    variables: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    alias: import("zod").ZodString;
+    germplasmDbId: import("zod").ZodString;
+    germplasmName: import("zod").ZodOptional<import("zod").ZodString>;
+    studyCount: import("zod").ZodNumber;
+    studyDbIds: import("zod").ZodArray<import("zod").ZodString>;
+    perVariable: import("zod").ZodArray<import("zod").ZodObject<{
+        observationVariableDbId: import("zod").ZodString;
+        observationVariableName: import("zod").ZodOptional<import("zod").ZodString>;
+        n: import("zod").ZodNumber;
+        mean: import("zod").ZodOptional<import("zod").ZodNumber>;
+        median: import("zod").ZodOptional<import("zod").ZodNumber>;
+        sd: import("zod").ZodOptional<import("zod").ZodNumber>;
+        min: import("zod").ZodOptional<import("zod").ZodString>;
+        max: import("zod").ZodOptional<import("zod").ZodString>;
+        studyCount: import("zod").ZodNumber;
+        studyDbIds: import("zod").ZodArray<import("zod").ZodString>;
+        seasons: import("zod").ZodArray<import("zod").ZodString>;
+    }, 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_find_studies.";
+    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_germplasm_performance.';
 }, {
-    readonly reason: "all_filters_dropped";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "The active dialect dropped every filter the agent supplied — the upstream server does not honor any of the requested scope filters on this endpoint, so the call would silently widen to the unfiltered baseline.";
-    readonly recovery: "Drop the unsupported filters and rescope by crop, trialTypes, seasons, programs, trials, studyNames, or active — these filter paths are honored on the active dialect.";
-}], {
-    readonly totalCount: import("zod").ZodNumber;
-    readonly returnedCount: import("zod").ZodNumber;
-    readonly appliedFilters: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
-    readonly refinementHint: import("zod").ZodOptional<import("zod").ZodString>;
-    readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
-    readonly warnings: import("zod").ZodArray<import("zod").ZodString>;
-}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    readonly reason: 'germplasm_not_found';
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: 'Upstream returned no germplasm record for the requested germplasmDbId';
+    readonly recovery: 'Verify the germplasmDbId on the target server, or run brapi_find_germplasm to discover valid IDs.';
+}], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
     alias: import("zod").ZodOptional<import("zod").ZodString>;
     variables: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
     variableNames: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
@@ -959,8 +920,8 @@ export declare const readOnlyToolDefinitions: (import("@cyanheads/mcp-ts-core").
         synonyms: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
         ontologyDbId: import("zod").ZodOptional<import("zod").ZodString>;
         source: import("zod").ZodEnum<{
-            puiMatch: "puiMatch";
             nameMatch: "nameMatch";
+            puiMatch: "puiMatch";
             synonymMatch: "synonymMatch";
             traitClassMatch: "traitClassMatch";
         }>;
@@ -977,15 +938,15 @@ export declare const readOnlyToolDefinitions: (import("@cyanheads/mcp-ts-core").
         totalCount: import("zod").ZodOptional<import("zod").ZodNumber>;
     }, import("zod/v4/core").$strip>>;
 }, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: "unknown_alias";
+    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_find_variables.";
+    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_find_variables.';
 }, {
-    readonly reason: "all_filters_dropped";
+    readonly reason: 'all_filters_dropped';
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "The active dialect dropped every filter the agent supplied — the upstream server does not honor any of the requested scope filters on this endpoint, so the call would silently widen to the unfiltered baseline.";
-    readonly recovery: "Drop the unsupported filters and rescope by variables, traitClasses, ontologyDbIds, methodDbIds, scaleDbIds, or text — these filter paths are honored on the active dialect.";
+    readonly when: 'The active dialect dropped every filter the agent supplied — the upstream server does not honor any of the requested scope filters on this endpoint, so the call would silently widen to the unfiltered baseline.';
+    readonly recovery: 'Drop the unsupported filters and rescope by variables, traitClasses, ontologyDbIds, methodDbIds, scaleDbIds, or text — these filter paths are honored on the active dialect.';
 }], {
     readonly totalCount: import("zod").ZodNumber;
     readonly returnedCount: import("zod").ZodNumber;
@@ -995,36 +956,112 @@ export declare const readOnlyToolDefinitions: (import("@cyanheads/mcp-ts-core").
     readonly warnings: import("zod").ZodArray<import("zod").ZodString>;
 }> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
     alias: import("zod").ZodOptional<import("zod").ZodString>;
-    variantSets: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    variants: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    references: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    referenceName: import("zod").ZodOptional<import("zod").ZodString>;
-    start: import("zod").ZodOptional<import("zod").ZodNumber>;
-    end: import("zod").ZodOptional<import("zod").ZodNumber>;
+    studies: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    germplasm: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    variables: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    observationUnits: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    observations: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    seasons: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    programs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    trials: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    observationLevels: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    timestampFrom: import("zod").ZodOptional<import("zod").ZodString>;
+    timestampTo: import("zod").ZodOptional<import("zod").ZodString>;
+    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;
+    results: import("zod").ZodArray<import("zod").ZodObject<{
+        observationDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        observationUnitDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        observationUnitName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        observationVariableDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        observationVariableName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        studyDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        studyName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        germplasmDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        germplasmName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        observationLevel: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        season: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodObject<{}, import("zod/v4/core").$loose>, import("zod").ZodNull]>>;
+        value: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        observationTimeStamp: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        collector: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        uploadedBy: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    }, import("zod/v4/core").$loose>>;
+    hasMore: import("zod").ZodBoolean;
+    distributions: import("zod").ZodObject<{
+        observationVariableName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        studyName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        germplasmName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        observationLevel: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        season: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>;
+    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>>;
+}, 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_find_observations.';
+}, {
+    readonly reason: 'all_filters_dropped';
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: 'The active dialect dropped every filter the agent supplied — the upstream server does not honor any of the requested scope filters on this endpoint, so the call would silently widen to the unfiltered baseline.';
+    readonly recovery: 'Drop the unsupported filters and rescope by germplasm, variables, observationUnits, observations, seasons, programs, or trials — these filter paths are honored on the active dialect.';
+}], {
+    readonly totalCount: import("zod").ZodNumber;
+    readonly returnedCount: import("zod").ZodNumber;
+    readonly appliedFilters: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+    readonly refinementHint: import("zod").ZodOptional<import("zod").ZodString>;
+    readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
+    readonly warnings: import("zod").ZodArray<import("zod").ZodString>;
+}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    alias: import("zod").ZodOptional<import("zod").ZodString>;
+    images: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    observationUnits: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    observations: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    studies: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    imageFileNames: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    mimeTypes: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    descriptiveOntologyTerms: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
     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;
     results: import("zod").ZodArray<import("zod").ZodObject<{
-        variantDbId: import("zod").ZodString;
-        variantNames: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodString>>>;
-        variantSetDbId: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodArray<import("zod").ZodString>, import("zod").ZodNull]>>;
-        variantSetDbIds: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodString>>>;
-        variantType: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        referenceBases: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        alternateBases: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodString>>>;
-        referenceName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
-        start: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodNumber>>;
-        end: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodNumber>>;
-        filtersPassed: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodBoolean>>;
-        filtersApplied: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodBoolean>>;
-        filtersFailed: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodString>>>;
+        imageDbId: import("zod").ZodString;
+        imageName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        imageFileName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        imageFileSize: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodCoercedNumber<unknown>>>;
+        imageHeight: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodCoercedNumber<unknown>>>;
+        imageWidth: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodCoercedNumber<unknown>>>;
+        mimeType: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        imageTimeStamp: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        imageURL: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        observationUnitDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        observationUnitName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        observationDbIds: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodString>>>;
+        studyDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        studyName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        descriptiveOntologyTerms: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodString>>>;
+        copyright: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        description: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
     }, import("zod/v4/core").$loose>>;
     hasMore: import("zod").ZodBoolean;
     distributions: import("zod").ZodObject<{
-        variantType: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
-        referenceName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
-        variantSetDbId: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        mimeType: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        studyName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        observationUnitName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        descriptiveOntologyTerms: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
     }, import("zod/v4/core").$strip>;
     dataframe: import("zod").ZodOptional<import("zod").ZodObject<{
         tableName: import("zod").ZodString;
@@ -1038,15 +1075,15 @@ export declare const readOnlyToolDefinitions: (import("@cyanheads/mcp-ts-core").
         totalCount: import("zod").ZodOptional<import("zod").ZodNumber>;
     }, import("zod/v4/core").$strip>>;
 }, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: "unknown_alias";
+    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_find_variants.";
+    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_find_images.';
 }, {
-    readonly reason: "all_filters_dropped";
+    readonly reason: 'all_filters_dropped';
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "The active dialect dropped every filter the agent supplied — the upstream server does not honor any of the requested scope filters on this endpoint, so the call would silently widen to the unfiltered baseline.";
-    readonly recovery: "Drop the unsupported filters and rescope by variants, variantSets, references, or referenceName + start/end — these filter paths are honored on the active dialect.";
+    readonly when: 'The active dialect dropped every filter the agent supplied — the upstream server does not honor any of the requested scope filters on this endpoint, so the call would silently widen to the unfiltered baseline.';
+    readonly recovery: 'Drop the unsupported filters and rescope by images, observationUnits, observations, studies, descriptiveOntologyTerms, imageFileNames, or mimeTypes — these filter paths are honored on the active dialect.';
 }], {
     readonly totalCount: import("zod").ZodNumber;
     readonly returnedCount: import("zod").ZodNumber;
@@ -1055,41 +1092,6 @@ export declare const readOnlyToolDefinitions: (import("@cyanheads/mcp-ts-core").
     readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
     readonly warnings: import("zod").ZodArray<import("zod").ZodString>;
 }> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
-    alias: import("zod").ZodOptional<import("zod").ZodString>;
-    germplasmDbId: import("zod").ZodString;
-    studyDbIds: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    variables: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-    alias: import("zod").ZodString;
-    germplasmDbId: import("zod").ZodString;
-    germplasmName: import("zod").ZodOptional<import("zod").ZodString>;
-    studyCount: import("zod").ZodNumber;
-    studyDbIds: import("zod").ZodArray<import("zod").ZodString>;
-    perVariable: import("zod").ZodArray<import("zod").ZodObject<{
-        observationVariableDbId: import("zod").ZodString;
-        observationVariableName: import("zod").ZodOptional<import("zod").ZodString>;
-        n: import("zod").ZodNumber;
-        mean: import("zod").ZodOptional<import("zod").ZodNumber>;
-        median: import("zod").ZodOptional<import("zod").ZodNumber>;
-        sd: import("zod").ZodOptional<import("zod").ZodNumber>;
-        min: import("zod").ZodOptional<import("zod").ZodString>;
-        max: import("zod").ZodOptional<import("zod").ZodString>;
-        studyCount: import("zod").ZodNumber;
-        studyDbIds: import("zod").ZodArray<import("zod").ZodString>;
-        seasons: import("zod").ZodArray<import("zod").ZodString>;
-    }, 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_germplasm_performance.";
-}, {
-    readonly reason: "germplasm_not_found";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "Upstream returned no germplasm record for the requested germplasmDbId";
-    readonly recovery: "Verify the germplasmDbId on the target server, or run brapi_find_germplasm to discover valid IDs.";
-}], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
     imageDbIds: import("zod").ZodArray<import("zod").ZodString>;
     alias: import("zod").ZodOptional<import("zod").ZodString>;
 }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
@@ -1129,34 +1131,55 @@ export declare const readOnlyToolDefinitions: (import("@cyanheads/mcp-ts-core").
         warning: import("zod").ZodString;
     }, import("zod/v4/core").$strip>>;
 }, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: "unknown_alias";
+    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_get_image.";
+    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_get_image.';
 }, {
-    readonly reason: "images_unsupported";
+    readonly reason: 'images_unsupported';
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "BrAPI server does not advertise /images in /serverinfo";
-    readonly recovery: "Run brapi_server_info to inspect the advertised endpoints, or call brapi_connect with a different alias for a server that exposes /images.";
+    readonly when: 'BrAPI server does not advertise /images in /serverinfo';
+    readonly recovery: 'Run brapi_server_info to inspect the advertised endpoints, or call brapi_connect with a different alias for a server that exposes /images.';
 }], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
     alias: import("zod").ZodOptional<import("zod").ZodString>;
-    path: import("zod").ZodString;
-    params: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodNumber, import("zod").ZodBoolean, import("zod").ZodArray<import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodNumber]>>]>>>;
+    variantSetDbId: import("zod").ZodOptional<import("zod").ZodString>;
+    variantSetDbIds: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    germplasmDbIds: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    callSetDbIds: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    variantDbIds: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    callFormat: import("zod").ZodOptional<import("zod").ZodEnum<{
+        DARTSEQ: "DARTSEQ";
+        FLAPJACK: "FLAPJACK";
+        JSON: "JSON";
+        VCF: "VCF";
+    }>>;
     loadLimit: import("zod").ZodOptional<import("zod").ZodNumber>;
 }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
     alias: import("zod").ZodString;
-    url: import("zod").ZodString;
-    path: import("zod").ZodString;
-    metadata: import("zod").ZodObject<{
-        pagination: import("zod").ZodOptional<import("zod").ZodObject<{
-            currentPage: import("zod").ZodNumber;
-            pageSize: import("zod").ZodNumber;
-            totalCount: import("zod").ZodNumber;
-            totalPages: import("zod").ZodNumber;
-        }, import("zod/v4/core").$loose>>;
-    }, import("zod/v4/core").$loose>;
-    result: import("zod").ZodUnknown;
-    suggestion: import("zod").ZodOptional<import("zod").ZodString>;
+    results: import("zod").ZodArray<import("zod").ZodObject<{
+        callSetDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        callSetName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        variantDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        variantName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        variantSetDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        genotype: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodObject<{
+            values: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodString>>>;
+        }, import("zod/v4/core").$loose>>>;
+        genotypeValue: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        phaseSet: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    }, import("zod/v4/core").$loose>>;
+    hasMore: import("zod").ZodBoolean;
+    callFormatting: import("zod").ZodObject<{
+        expandHomozygotes: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodBoolean>>;
+        unknownString: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        sepPhased: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        sepUnphased: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    }, import("zod/v4/core").$strip>;
+    distributions: import("zod").ZodObject<{
+        callSetName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        variantName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        variantSetDbId: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>;
     dataframe: import("zod").ZodOptional<import("zod").ZodObject<{
         tableName: import("zod").ZodString;
         rowCount: import("zod").ZodNumber;
@@ -1168,17 +1191,77 @@ export declare const readOnlyToolDefinitions: (import("@cyanheads/mcp-ts-core").
         maxRows: import("zod").ZodOptional<import("zod").ZodNumber>;
         totalCount: import("zod").ZodOptional<import("zod").ZodNumber>;
     }, import("zod/v4/core").$strip>>;
+    truncated: import("zod").ZodBoolean;
 }, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: "unknown_alias";
+    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_raw_get.";
+    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_find_genotype_calls.';
 }, {
-    readonly reason: "cross_origin_path";
+    readonly reason: 'no_filters';
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "path argument was a full URL instead of a relative BrAPI route";
-    readonly recovery: "Pass a path like \"/samples\" or \"/methods\" — the connection alias supplies the baseUrl.";
+    readonly when: 'No variant set, germplasm, call set, or variant filter was provided';
+    readonly recovery: 'Provide variantSetDbId or germplasmDbIds before retrying — unfiltered pulls are too expensive.';
+}, {
+    readonly reason: 'search_endpoint_disabled';
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: 'The active dialect declares POST /search/calls as known-dead on this server';
+    readonly recovery: 'Connect to a different BrAPI server that exposes a working /search/calls route — genotype-call workflows are not viable here.';
+}], {
+    readonly totalCount: import("zod").ZodNumber;
+    readonly returnedCount: import("zod").ZodNumber;
+    readonly appliedFilters: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+    readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
+    readonly warnings: import("zod").ZodArray<import("zod").ZodString>;
+}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    dataframe: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    tables: import("zod").ZodArray<import("zod").ZodObject<{
+        name: import("zod").ZodString;
+        rowCount: import("zod").ZodNumber;
+        columns: import("zod").ZodArray<import("zod").ZodObject<{
+            name: import("zod").ZodString;
+            type: import("zod").ZodString;
+            nullable: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        }, import("zod/v4/core").$strip>>;
+        approxSizeBytes: import("zod").ZodOptional<import("zod").ZodNumber>;
+        provenance: import("zod").ZodOptional<import("zod").ZodObject<{
+            source: import("zod").ZodString;
+            baseUrl: import("zod").ZodString;
+            query: import("zod").ZodUnknown;
+            createdAt: import("zod").ZodString;
+            expiresAt: import("zod").ZodString;
+        }, import("zod/v4/core").$strip>>;
+    }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: 'list_all_disabled_on_shared_http';
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
+    readonly when: "This server is running as a shared HTTP endpoint without per-caller auth — listing every dataframe would expose other concurrent clients' workspaces, since all callers resolve to one shared tenant.";
+    readonly recovery: 'Pass `dataframe` with a specific name — either from a prior find_* spillover result (`result.dataframe.tableName`) or one you registered via `brapi_dataframe_query` with `registerAs`. Listing all dataframes is not available on this deployment.';
 }], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    sql: import("zod").ZodString;
+    registerAs: import("zod").ZodOptional<import("zod").ZodString>;
+    preview: import("zod").ZodOptional<import("zod").ZodNumber>;
+    rowLimit: import("zod").ZodOptional<import("zod").ZodNumber>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    rowCount: import("zod").ZodNumber;
+    columns: import("zod").ZodArray<import("zod").ZodObject<{
+        name: import("zod").ZodString;
+        type: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>>;
+    rows: import("zod").ZodArray<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+    dataframe: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: 'sql_rejected';
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: 'SQL violated read-only rules (multi-statement, non-SELECT, or disallowed operation)';
+    readonly recovery: 'Submit a single SELECT statement using only registered dataframes. For changes, use `registerAs` in this tool to materialize a result, or brapi_dataframe_drop to remove a dataframe.';
+}], {
+    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>;
     noun: import("zod").ZodString;
     body: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
@@ -1187,8 +1270,8 @@ export declare const readOnlyToolDefinitions: (import("@cyanheads/mcp-ts-core").
     alias: import("zod").ZodString;
     noun: import("zod").ZodString;
     kind: import("zod").ZodEnum<{
-        sync: "sync";
         async: "async";
+        sync: "sync";
     }>;
     searchResultsDbId: import("zod").ZodOptional<import("zod").ZodString>;
     metadata: import("zod").ZodObject<{
@@ -1213,88 +1296,15 @@ export declare const readOnlyToolDefinitions: (import("@cyanheads/mcp-ts-core").
         totalCount: import("zod").ZodOptional<import("zod").ZodNumber>;
     }, import("zod/v4/core").$strip>>;
 }, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: "unknown_alias";
+    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_raw_search.";
+    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_raw_search.';
 }, {
-    readonly reason: "search_endpoint_disabled";
+    readonly reason: 'search_endpoint_disabled';
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "The active dialect declares this POST /search/{noun} route as known-dead on this server";
-    readonly recovery: "Use the curated find_* tool for this noun — it routes through GET filters instead and avoids the dead search route.";
-}], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
-    germplasmDbIds: import("zod").ZodArray<import("zod").ZodString>;
-    direction: import("zod").ZodDefault<import("zod").ZodEnum<{
-        both: "both";
-        ancestors: "ancestors";
-        descendants: "descendants";
-    }>>;
-    maxDepth: import("zod").ZodDefault<import("zod").ZodNumber>;
-    loadLimit: import("zod").ZodOptional<import("zod").ZodNumber>;
-    alias: import("zod").ZodOptional<import("zod").ZodString>;
-}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-    alias: import("zod").ZodString;
-    direction: import("zod").ZodEnum<{
-        both: "both";
-        ancestors: "ancestors";
-        descendants: "descendants";
-    }>;
-    maxDepth: import("zod").ZodNumber;
-    nodes: import("zod").ZodArray<import("zod").ZodObject<{
-        germplasmDbId: import("zod").ZodString;
-        germplasmName: import("zod").ZodOptional<import("zod").ZodString>;
-        depth: import("zod").ZodNumber;
-        isRoot: import("zod").ZodBoolean;
-        direction: import("zod").ZodEnum<{
-            root: "root";
-            ancestor: "ancestor";
-            descendant: "descendant";
-            both: "both";
-        }>;
-    }, import("zod/v4/core").$strip>>;
-    edges: import("zod").ZodArray<import("zod").ZodObject<{
-        from: import("zod").ZodString;
-        to: import("zod").ZodString;
-        relationship: import("zod").ZodEnum<{
-            parent: "parent";
-            child: "child";
-        }>;
-        parentType: import("zod").ZodOptional<import("zod").ZodString>;
-    }, import("zod/v4/core").$strip>>;
-    depthReached: import("zod").ZodNumber;
-    rootCount: import("zod").ZodNumber;
-    leafCount: import("zod").ZodNumber;
-    cycleCount: import("zod").ZodNumber;
-    deadEndCount: import("zod").ZodNumber;
-    truncated: import("zod").ZodBoolean;
-    warnings: import("zod").ZodArray<import("zod").ZodString>;
-    nodesDataframe: 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>>;
-    edgesDataframe: 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>>;
-}, 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_walk_pedigree.";
+    readonly when: 'The active dialect declares this POST /search/{noun} route as known-dead on this server';
+    readonly recovery: 'Use the curated find_* tool for this noun — it routes through GET filters instead and avoids the dead search route.';
 }], undefined>)[];
 /**
  * Drop tool — opt-in via `BRAPI_CANVAS_DROP_ENABLED`. Off by default; the
@@ -1317,8 +1327,8 @@ export declare const exportToolDefinitions: import("@cyanheads/mcp-ts-core").Too
     dataframe: import("zod").ZodString;
     format: import("zod").ZodEnum<{
         csv: "csv";
-        parquet: "parquet";
         json: "json";
+        parquet: "parquet";
     }>;
     filename: import("zod").ZodOptional<import("zod").ZodString>;
     columns: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
@@ -1327,8 +1337,8 @@ export declare const exportToolDefinitions: import("@cyanheads/mcp-ts-core").Too
     dataframe: import("zod").ZodString;
     format: import("zod").ZodEnum<{
         csv: "csv";
-        parquet: "parquet";
         json: "json";
+        parquet: "parquet";
     }>;
     path: import("zod").ZodString;
     filename: import("zod").ZodString;
@@ -1340,25 +1350,25 @@ export declare const exportToolDefinitions: import("@cyanheads/mcp-ts-core").Too
     }, import("zod/v4/core").$strip>>;
     expiresAt: import("zod").ZodString;
 }, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: "export_dir_unset";
+    readonly reason: 'export_dir_unset';
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ConfigurationError;
-    readonly when: "BRAPI_EXPORT_DIR is not configured (defensive — the registration gate normally hides the tool when this happens)";
-    readonly recovery: "Set BRAPI_EXPORT_DIR on the server before retrying.";
+    readonly when: 'BRAPI_EXPORT_DIR is not configured (defensive — the registration gate normally hides the tool when this happens)';
+    readonly recovery: 'Set BRAPI_EXPORT_DIR on the server before retrying.';
 }, {
-    readonly reason: "dataframe_not_found";
+    readonly reason: 'dataframe_not_found';
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "No dataframe with this name exists on the canvas (expired, dropped, or typo)";
-    readonly recovery: "Call brapi_dataframe_describe to list available dataframes.";
+    readonly when: 'No dataframe with this name exists on the canvas (expired, dropped, or typo)';
+    readonly recovery: 'Call brapi_dataframe_describe to list available dataframes.';
 }, {
-    readonly reason: "invalid_filename";
+    readonly reason: 'invalid_filename';
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "filename contains path separators or traversal segments";
-    readonly recovery: "Provide a filename without \"/\", \"\\\", or \"..\" — leave it unset to use the default.";
+    readonly when: 'filename contains path separators or traversal segments';
+    readonly recovery: 'Provide a filename without "/", "\\", or ".." — leave it unset to use the default.';
 }, {
-    readonly reason: "mutually_exclusive_projection";
+    readonly reason: 'mutually_exclusive_projection';
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "Both `columns` and `sql` were supplied";
-    readonly recovery: "Pass either `columns` for a thin projection or `sql` for filtering/aggregation, not both.";
+    readonly when: 'Both `columns` and `sql` were supplied';
+    readonly recovery: 'Pass either `columns` for a thin projection or `sql` for filtering/aggregation, not both.';
 }], undefined>[];
 /** Write tools — registered only when `BRAPI_ENABLE_WRITES=true`. */
 export declare const writeToolDefinitions: import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
@@ -1385,8 +1395,8 @@ export declare const writeToolDefinitions: import("@cyanheads/mcp-ts-core").Tool
         }, import("zod/v4/core").$strip>>;
     }, import("zod/v4/core").$strip>>;
     mode: import("zod").ZodDefault<import("zod").ZodEnum<{
-        preview: "preview";
         apply: "apply";
+        preview: "preview";
     }>>;
     force: import("zod").ZodDefault<import("zod").ZodBoolean>;
 }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
@@ -1435,39 +1445,34 @@ export declare const writeToolDefinitions: import("@cyanheads/mcp-ts-core").Tool
         warnings: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
     }, import("zod/v4/core").$strip>], "mode">;
 }, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: "unknown_alias";
+    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_submit_observations.";
+    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_submit_observations.';
 }, {
-    readonly reason: "observations_unsupported";
+    readonly reason: 'observations_unsupported';
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "BrAPI server does not advertise /observations";
-    readonly recovery: "Run brapi_server_info to inspect the advertised endpoints, or call brapi_connect with a different alias for a server that exposes /observations.";
+    readonly when: 'BrAPI server does not advertise /observations';
+    readonly recovery: 'Run brapi_server_info to inspect the advertised endpoints, or call brapi_connect with a different alias for a server that exposes /observations.';
 }, {
-    readonly reason: "study_not_found";
+    readonly reason: 'study_not_found';
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "Upstream returned no study record for the requested studyDbId";
-    readonly recovery: "Verify the studyDbId on the target server, or run brapi_find_studies to discover valid IDs before retrying.";
+    readonly when: 'Upstream returned no study record for the requested studyDbId';
+    readonly recovery: 'Verify the studyDbId on the target server, or run brapi_find_studies to discover valid IDs before retrying.';
 }, {
-    readonly reason: "post_unsupported";
+    readonly reason: 'post_unsupported';
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "Server does not advertise POST on /observations but new rows were submitted";
-    readonly recovery: "Remove the rows that lack observationDbId (those are the new rows) before retrying, or connect to a different server that supports POST on /observations.";
+    readonly when: 'Server does not advertise POST on /observations but new rows were submitted';
+    readonly recovery: 'Remove the rows that lack observationDbId (those are the new rows) before retrying, or connect to a different server that supports POST on /observations.';
 }, {
-    readonly reason: "put_unsupported";
+    readonly reason: 'put_unsupported';
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "Server does not advertise PUT on /observations but update rows were submitted";
-    readonly recovery: "Connect to a different server that supports PUT on /observations — dropping observationDbId would route as POST and create duplicates instead of updating the existing rows.";
-}, {
-    readonly reason: "elicit_unavailable";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
-    readonly when: "Apply mode invoked but client does not expose ctx.elicit and force was false";
-    readonly recovery: "Set force=true only with explicit user authorization, or use a client that supports elicitation.";
+    readonly when: 'Server does not advertise PUT on /observations but update rows were submitted';
+    readonly recovery: 'Connect to a different server that supports PUT on /observations — dropping observationDbId would route as POST and create duplicates instead of updating the existing rows.';
 }, {
-    readonly reason: "user_declined";
+    readonly reason: 'user_declined';
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
-    readonly when: "User declined the elicitation prompt for the apply write";
-    readonly recovery: "Re-run the tool when the user is ready to confirm the write.";
+    readonly when: 'The confirmation round came back declined, cancelled, or without a true `confirm` value';
+    readonly recovery: 'Re-run brapi_submit_observations when the user is ready to confirm, or pass force=true with explicit out-of-band authorization.';
 }], undefined>[];
 //# sourceMappingURL=index.d.ts.map