@cyanheads/brapi-mcp-server 0.3.5

package/dist/services/brapi-filters/catalog.js

@@ -0,0 +1,490 @@
+/**
+ * @fileoverview Static BrAPI v2.1 filter catalog. Covers the endpoints the
+ * goal-shaped tools target plus the common escape-hatch nouns. Agents use
+ * this via `brapi_describe_filters` to discover valid filter names before
+ * constructing `extraFilters` on `find_*` tools. Catalog entries reflect the
+ * BrAPI v2.1 spec — individual servers may implement subsets; filter failures
+ * surface through the upstream 400 body, not a static check.
+ *
+ * @module services/brapi-filters/catalog
+ */
+const PAGINATION_FILTERS = [
+    {
+        name: 'page',
+        type: 'integer',
+        description: 'Zero-indexed page number.',
+        example: '0',
+    },
+    {
+        name: 'pageSize',
+        type: 'integer',
+        description: 'Rows per page. Cap varies by server; 1000 is a safe upper bound.',
+        example: '100',
+    },
+];
+const STUDIES = [
+    {
+        name: 'commonCropNames',
+        type: 'string[]',
+        description: 'Common crop names (e.g. "Cassava", "Wheat"). Matches /commoncropnames.',
+        example: 'Cassava',
+    },
+    {
+        name: 'studyTypes',
+        type: 'string[]',
+        description: 'Study types — e.g. "Yield Trial", "Phenotyping".',
+        example: 'Yield Trial',
+    },
+    {
+        name: 'programDbIds',
+        type: 'string[]',
+        description: 'Filter to studies within specific breeding programs.',
+        example: 'program-1',
+    },
+    {
+        name: 'programNames',
+        type: 'string[]',
+        description: 'Filter by program display name.',
+        example: 'Cassava Breeding',
+    },
+    {
+        name: 'studyDbIds',
+        type: 'string[]',
+        description: 'Restrict to specific studies by DbId.',
+        example: 'study-42',
+    },
+    {
+        name: 'studyNames',
+        type: 'string[]',
+        description: 'Restrict by study display name.',
+        example: 'IBA-2022-YT',
+    },
+    {
+        name: 'trialDbIds',
+        type: 'string[]',
+        description: 'Restrict to studies inside specific trials.',
+        example: 'trial-1',
+    },
+    {
+        name: 'trialNames',
+        type: 'string[]',
+        description: 'Restrict by trial display name.',
+        example: 'West Africa Yield Trial',
+    },
+    {
+        name: 'locationDbIds',
+        type: 'string[]',
+        description: 'Restrict to studies at specific locations / research stations.',
+        example: 'loc-ibadan',
+    },
+    {
+        name: 'locationNames',
+        type: 'string[]',
+        description: 'Restrict by location display name.',
+        example: 'NCSU Station 1',
+    },
+    {
+        name: 'seasonDbIds',
+        type: 'string[]',
+        description: 'Restrict to specific seasons.',
+        example: '2022',
+    },
+    {
+        name: 'active',
+        type: 'boolean',
+        description: 'Only active (or only inactive) studies.',
+        example: 'true',
+    },
+    {
+        name: 'studyCodes',
+        type: 'string[]',
+        description: 'Short alphanumeric study codes.',
+        example: 'IBA-YT-22',
+    },
+    {
+        name: 'studyPUIs',
+        type: 'string[]',
+        description: 'Persistent unique identifiers (DOIs, URIs) for the studies.',
+        example: 'doi:10.25739/abc123',
+    },
+    {
+        name: 'externalReferenceIds',
+        type: 'string[]',
+        description: 'External reference identifier for cross-system joins.',
+        example: 'ext-ref-1',
+    },
+    {
+        name: 'externalReferenceSources',
+        type: 'string[]',
+        description: 'Source system name paired with externalReferenceIds.',
+        example: 'GRIN',
+    },
+];
+const GERMPLASM = [
+    {
+        name: 'germplasmDbIds',
+        type: 'string[]',
+        description: 'Restrict to specific germplasm by DbId.',
+        example: 'germplasm-1',
+    },
+    {
+        name: 'germplasmNames',
+        type: 'string[]',
+        description: 'Restrict by germplasm display name.',
+        example: 'TME419',
+    },
+    {
+        name: 'germplasmPUIs',
+        type: 'string[]',
+        description: 'Persistent unique identifiers (DOIs, URIs).',
+        example: 'doi:10.25739/germplasm-xyz',
+    },
+    {
+        name: 'commonCropNames',
+        type: 'string[]',
+        description: 'Crop names the germplasm belongs to.',
+        example: 'Cassava',
+    },
+    {
+        name: 'accessionNumbers',
+        type: 'string[]',
+        description: 'Accession numbers from a genebank or seed repository.',
+        example: 'TMe-419',
+    },
+    {
+        name: 'collections',
+        type: 'string[]',
+        description: 'Collection the germplasm is curated under.',
+        example: 'IITA Core',
+    },
+    {
+        name: 'genus',
+        type: 'string',
+        description: 'Botanical genus.',
+        example: 'Manihot',
+    },
+    {
+        name: 'species',
+        type: 'string',
+        description: 'Botanical species epithet.',
+        example: 'esculenta',
+    },
+    {
+        name: 'synonyms',
+        type: 'string[]',
+        description: 'Known synonyms / alternate names.',
+        example: 'TME419',
+    },
+    {
+        name: 'familyCode',
+        type: 'string',
+        description: 'Pedigree family identifier.',
+        example: 'TME-F1',
+    },
+    {
+        name: 'programDbIds',
+        type: 'string[]',
+        description: 'Programs the germplasm is associated with.',
+        example: 'program-1',
+    },
+    {
+        name: 'trialDbIds',
+        type: 'string[]',
+        description: 'Trials the germplasm has been tested in.',
+        example: 'trial-1',
+    },
+    {
+        name: 'studyDbIds',
+        type: 'string[]',
+        description: 'Studies the germplasm has been tested in.',
+        example: 'study-1',
+    },
+    {
+        name: 'externalReferenceIds',
+        type: 'string[]',
+        description: 'External reference identifier for cross-system joins.',
+        example: 'ext-ref-1',
+    },
+];
+const VARIABLES = [
+    {
+        name: 'observationVariableDbIds',
+        type: 'string[]',
+        description: 'Restrict to specific variables.',
+        example: 'var-dry-matter',
+    },
+    {
+        name: 'observationVariableNames',
+        type: 'string[]',
+        description: 'Restrict by variable display name.',
+        example: 'Dry Matter %',
+    },
+    {
+        name: 'observationVariablePUIs',
+        type: 'string[]',
+        description: 'Persistent ontology URIs.',
+        example: 'CO_334:0000013',
+    },
+    {
+        name: 'traitClasses',
+        type: 'string[]',
+        description: 'Trait class (e.g. "Agronomic", "Morphological").',
+        example: 'Agronomic',
+    },
+    {
+        name: 'methodDbIds',
+        type: 'string[]',
+        description: 'Measurement method identifiers.',
+        example: 'method-1',
+    },
+    {
+        name: 'scaleDbIds',
+        type: 'string[]',
+        description: 'Measurement scale identifiers.',
+        example: 'scale-percent',
+    },
+    {
+        name: 'ontologyDbIds',
+        type: 'string[]',
+        description: 'Ontology identifiers — scope the search to a specific ontology.',
+        example: 'CO_334',
+    },
+    {
+        name: 'commonCropName',
+        type: 'string',
+        description: 'Crop context for the variable.',
+        example: 'Cassava',
+    },
+    {
+        name: 'studyDbId',
+        type: 'string',
+        description: 'Return only variables exposed inside a specific study.',
+        example: 'study-42',
+    },
+];
+const OBSERVATIONS = [
+    {
+        name: 'observationDbIds',
+        type: 'string[]',
+        description: 'Restrict to specific observations.',
+        example: 'obs-1',
+    },
+    {
+        name: 'observationUnitDbIds',
+        type: 'string[]',
+        description: 'Restrict to specific observation units (plots, plants, samples).',
+        example: 'ou-1',
+    },
+    {
+        name: 'observationVariableDbIds',
+        type: 'string[]',
+        description: 'Restrict to specific variables (traits).',
+        example: 'var-dry-matter',
+    },
+    {
+        name: 'studyDbIds',
+        type: 'string[]',
+        description: 'Restrict to specific studies.',
+        example: 'study-1',
+    },
+    {
+        name: 'germplasmDbIds',
+        type: 'string[]',
+        description: 'Restrict to specific germplasm.',
+        example: 'germplasm-1',
+    },
+    {
+        name: 'seasonDbIds',
+        type: 'string[]',
+        description: 'Restrict by season.',
+        example: '2022',
+    },
+    {
+        name: 'observationLevels',
+        type: 'string[]',
+        description: 'Observation unit level — e.g. "plot", "plant", "field".',
+        example: 'plot',
+    },
+    {
+        name: 'programDbIds',
+        type: 'string[]',
+        description: 'Restrict by program.',
+        example: 'program-1',
+    },
+    {
+        name: 'trialDbIds',
+        type: 'string[]',
+        description: 'Restrict by trial.',
+        example: 'trial-1',
+    },
+    {
+        name: 'observationTimeStampRangeStart',
+        type: 'date',
+        description: 'ISO 8601 start of the observation-time window.',
+        example: '2022-01-01T00:00:00Z',
+    },
+    {
+        name: 'observationTimeStampRangeEnd',
+        type: 'date',
+        description: 'ISO 8601 end of the observation-time window.',
+        example: '2022-12-31T23:59:59Z',
+    },
+];
+const IMAGES = [
+    {
+        name: 'imageDbIds',
+        type: 'string[]',
+        description: 'Restrict to specific images.',
+        example: 'img-1',
+    },
+    {
+        name: 'imageFileNames',
+        type: 'string[]',
+        description: 'Filter by uploaded file name.',
+        example: 'plot-042.jpg',
+    },
+    {
+        name: 'observationUnitDbIds',
+        type: 'string[]',
+        description: 'Images associated with specific observation units.',
+        example: 'ou-1',
+    },
+    {
+        name: 'observationDbIds',
+        type: 'string[]',
+        description: 'Images attached to specific observations.',
+        example: 'obs-1',
+    },
+    {
+        name: 'studyDbIds',
+        type: 'string[]',
+        description: 'Restrict to specific studies.',
+        example: 'study-1',
+    },
+    {
+        name: 'mimeTypes',
+        type: 'string[]',
+        description: 'MIME filter — e.g. "image/jpeg", "image/png".',
+        example: 'image/jpeg',
+    },
+    {
+        name: 'descriptiveOntologyTerms',
+        type: 'string[]',
+        description: 'Ontology tags attached to the image.',
+        example: 'CO_334:plot',
+    },
+];
+const VARIANTS = [
+    {
+        name: 'variantSetDbIds',
+        type: 'string[]',
+        description: 'Restrict to specific variant sets.',
+        example: 'vset-1',
+    },
+    {
+        name: 'variantDbIds',
+        type: 'string[]',
+        description: 'Restrict to specific variants.',
+        example: 'variant-1',
+    },
+    {
+        name: 'referenceDbIds',
+        type: 'string[]',
+        description: 'Reference sequence identifiers.',
+        example: 'ref-chr1',
+    },
+    {
+        name: 'referenceName',
+        type: 'string',
+        description: 'Reference display name — e.g. "chr01".',
+        example: 'chr1',
+    },
+    {
+        name: 'start',
+        type: 'integer',
+        description: 'Inclusive start position on the reference (1-based).',
+        example: '1000',
+    },
+    {
+        name: 'end',
+        type: 'integer',
+        description: 'Exclusive end position on the reference.',
+        example: '5000',
+    },
+];
+const LOCATIONS = [
+    {
+        name: 'locationDbIds',
+        type: 'string[]',
+        description: 'Restrict to specific locations.',
+        example: 'loc-1',
+    },
+    {
+        name: 'locationNames',
+        type: 'string[]',
+        description: 'Restrict by display name.',
+        example: 'NCSU Station 1',
+    },
+    {
+        name: 'locationTypes',
+        type: 'string[]',
+        description: 'Location type — e.g. "Research Station", "Field".',
+        example: 'Research Station',
+    },
+    {
+        name: 'countryCodes',
+        type: 'string[]',
+        description: 'ISO 3166-1 alpha-3 country codes.',
+        example: 'USA',
+    },
+    {
+        name: 'abbreviations',
+        type: 'string[]',
+        description: 'Short location abbreviations.',
+        example: 'NCSU-1',
+    },
+];
+const SPEC_BASE = 'https://brapi.org/specification';
+const CATALOG = {
+    studies: {
+        specReference: `${SPEC_BASE}/core/get-studies`,
+        filters: withPagination(STUDIES),
+    },
+    germplasm: {
+        specReference: `${SPEC_BASE}/germplasm/get-germplasm`,
+        filters: withPagination(GERMPLASM),
+    },
+    variables: {
+        specReference: `${SPEC_BASE}/phenotyping/get-variables`,
+        filters: withPagination(VARIABLES),
+    },
+    observations: {
+        specReference: `${SPEC_BASE}/phenotyping/get-observations`,
+        filters: withPagination(OBSERVATIONS),
+    },
+    images: {
+        specReference: `${SPEC_BASE}/phenotyping/get-images`,
+        filters: withPagination(IMAGES),
+    },
+    variants: {
+        specReference: `${SPEC_BASE}/genotyping/get-variants`,
+        filters: withPagination(VARIANTS),
+    },
+    locations: {
+        specReference: `${SPEC_BASE}/core/get-locations`,
+        filters: withPagination(LOCATIONS),
+    },
+};
+function withPagination(filters) {
+    return [...filters, ...PAGINATION_FILTERS];
+}
+export function getFilterCatalog(endpoint) {
+    const entry = CATALOG[endpoint];
+    if (!entry)
+        return;
+    return { endpoint, ...entry };
+}
+export function listFilterEndpoints() {
+    return Object.keys(CATALOG).sort();
+}
+//# sourceMappingURL=catalog.js.map

package/dist/services/brapi-filters/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../src/services/brapi-filters/catalog.ts"],"names":[],"mappings":"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"}

package/dist/services/brapi-filters/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview Public API barrel for the BrAPI filter catalog.
+ *
+ * @module services/brapi-filters
+ */
+export { getFilterCatalog, listFilterEndpoints } from './catalog.js';
+export type { FilterCatalog, FilterDescriptor, FilterType } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/brapi-filters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/brapi-filters/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACrE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/services/brapi-filters/index.js

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Public API barrel for the BrAPI filter catalog.
+ *
+ * @module services/brapi-filters
+ */
+export { getFilterCatalog, listFilterEndpoints } from './catalog.js';
+//# sourceMappingURL=index.js.map

package/dist/services/brapi-filters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/brapi-filters/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/dist/services/brapi-filters/types.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview Types for the BrAPI filter catalog — the static map of
+ * endpoint → valid filter names used by `brapi_describe_filters` and the
+ * `extraFilters` passthrough on `find_*` tools.
+ *
+ * @module services/brapi-filters/types
+ */
+export type FilterType = 'string' | 'integer' | 'number' | 'boolean' | 'date' | 'string[]' | 'integer[]';
+export interface FilterDescriptor {
+    description: string;
+    /** Example value, always stringified — renderable directly in tool output. */
+    example: string;
+    /** Filter parameter name (matches what BrAPI accepts on the query string). */
+    name: string;
+    type: FilterType;
+}
+export interface FilterCatalog {
+    endpoint: string;
+    filters: FilterDescriptor[];
+    /** Pointer to the BrAPI v2 spec section covering this endpoint. */
+    specReference?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/brapi-filters/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/brapi-filters/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,UAAU,GAClB,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,SAAS,GACT,MAAM,GACN,UAAU,GACV,WAAW,CAAC;AAEhB,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/services/brapi-filters/types.js

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview Types for the BrAPI filter catalog — the static map of
+ * endpoint → valid filter names used by `brapi_describe_filters` and the
+ * `extraFilters` passthrough on `find_*` tools.
+ *
+ * @module services/brapi-filters/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/services/brapi-filters/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/brapi-filters/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/services/capability-registry/capability-registry.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @fileoverview Capability profile loader + cache for BrAPI servers. Pulls
+ * `/serverinfo`, `/calls`, and `/commoncropnames` on first use (or refresh),
+ * normalizes the shape, and stores the result in tenant-scoped state. Tools
+ * consult this before routing requests — if a required endpoint isn't in the
+ * server's capability set, the service surfaces a clear `ValidationError`
+ * instead of letting the call fail downstream.
+ *
+ * @module services/capability-registry/capability-registry
+ */
+import type { Context } from '@cyanheads/mcp-ts-core';
+import type { ServerConfig } from '../../config/server-config.js';
+import { type BrapiClient, type BrapiRequestOptions } from '../../services/brapi-client/index.js';
+import type { CallDescriptor, CapabilityProfile, EndpointProbe } from './types.js';
+export interface CapabilityLookupOptions extends Pick<BrapiRequestOptions, 'auth'> {
+    /** Force a fresh fetch, bypassing the cached profile. */
+    forceRefresh?: boolean;
+}
+export declare class CapabilityRegistry {
+    private readonly serverConfig;
+    private readonly client;
+    constructor(serverConfig: ServerConfig, client?: () => BrapiClient);
+    /**
+     * Load the capability profile for a base URL. Returns the cached profile
+     * when present and not expired; otherwise fetches fresh and caches it.
+     */
+    profile(baseUrl: string, ctx: Context, options?: CapabilityLookupOptions): Promise<CapabilityProfile>;
+    /**
+     * Throw a `ValidationError` if the requested endpoint (service + optional
+     * HTTP method) is not in the server's capability set. Tools call this
+     * before routing requests so missing-capability errors surface early with
+     * a clear recovery hint.
+     */
+    ensure(baseUrl: string, probe: EndpointProbe, ctx: Context, options?: CapabilityLookupOptions): Promise<CallDescriptor>;
+    /** Drop the cached profile for a base URL (e.g. on explicit reconnect). */
+    invalidate(baseUrl: string, ctx: Context): Promise<void>;
+    private fetchProfile;
+    /**
+     * `/calls` fallback — some servers don't embed calls in `/serverinfo` and
+     * expect clients to hit the dedicated endpoint. Degrades to an empty list
+     * if the server lacks this too; downstream `ensure()` will surface the
+     * missing-capability error with a useful message.
+     */
+    private fetchCallsFallback;
+    private fetchCrops;
+    private cacheKey;
+}
+export declare function initCapabilityRegistry(serverConfig: ServerConfig): void;
+export declare function getCapabilityRegistry(): CapabilityRegistry;
+export declare function resetCapabilityRegistry(): void;
+//# sourceMappingURL=capability-registry.d.ts.map

package/dist/services/capability-registry/capability-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-registry.d.ts","sourceRoot":"","sources":["../../../src/services/capability-registry/capability-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EACL,KAAK,WAAW,EAEhB,KAAK,mBAAmB,EAEzB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EACjB,aAAa,EAGd,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,uBAAwB,SAAQ,IAAI,CAAC,mBAAmB,EAAE,MAAM,CAAC;IAChF,yDAAyD;IACzD,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAID,qBAAa,kBAAkB;IAE3B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,YAAY,EAAE,YAAY,EAC1B,MAAM,GAAE,MAAM,WAA4B;IAG7D;;;OAGG;IACG,OAAO,CACX,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,iBAAiB,CAAC;IAa7B;;;;;OAKG;IACG,MAAM,CACV,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,aAAa,EACpB,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,cAAc,CAAC;IA2B1B,2EAA2E;IACrE,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;YAIhD,YAAY;IAkC1B;;;;;OAKG;YACW,kBAAkB;YAsBlB,UAAU;IAsBxB,OAAO,CAAC,QAAQ;CAGjB;AAoGD,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI,CAEvE;AAED,wBAAgB,qBAAqB,IAAI,kBAAkB,CAO1D;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}