@cyanheads/gbif-biodiversity-mcp-server 0.2.0

package/dist/mcp-server/tools/definitions/gbif-get-species.tool.js

@@ -0,0 +1,182 @@
+/**
+ * @fileoverview Fetch a taxon record by GBIF backbone key.
+ * @module mcp-server/tools/definitions/gbif-get-species
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode, McpError } from '@cyanheads/mcp-ts-core/errors';
+import { getGbifService } from '../../../services/gbif/gbif-service.js';
+export const gbifGetSpecies = tool('gbif_get_species', {
+    title: 'Get Species Record',
+    description: 'Fetch a single backbone taxon by its GBIF taxon key. Returns full classification, authorship, ' +
+        'taxonomic status, vernacular name, descendant count, and publication reference. ' +
+        'Use after gbif_match_species when you need the complete record rather than the match summary. ' +
+        'When taxonomicStatus is SYNONYM, acceptedKey and accepted fields identify the accepted taxon. ' +
+        'The extinct field is absent (not false) on most records — only present on explicitly flagged taxa.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    input: z.object({
+        taxonKey: z
+            .number()
+            .describe('GBIF backbone taxon key from gbif_match_species or another taxonomy tool.'),
+    }),
+    output: z.object({
+        key: z.number().optional().describe('GBIF backbone taxon key.'),
+        scientificName: z.string().optional().describe('Full scientific name with authorship.'),
+        canonicalName: z.string().optional().describe('Scientific name without authorship.'),
+        authorship: z.string().optional().describe('Taxonomic authorship of the name.'),
+        vernacularName: z.string().optional().describe('English common name when available.'),
+        rank: z.string().optional().describe('Taxonomic rank (SPECIES, GENUS, FAMILY, etc.).'),
+        taxonomicStatus: z
+            .string()
+            .optional()
+            .describe('ACCEPTED, SYNONYM, DOUBTFUL, etc. SYNONYM means acceptedKey/accepted are populated.'),
+        numDescendants: z
+            .number()
+            .optional()
+            .describe('Count of child taxa in the backbone under this taxon.'),
+        numOccurrences: z.number().optional().describe('Occurrence record count in GBIF.'),
+        publishedIn: z.string().optional().describe('Original description citation when available.'),
+        extinct: z
+            .boolean()
+            .optional()
+            .describe('True when the taxon is explicitly flagged as extinct. Absent on most records.'),
+        kingdom: z.string().optional().describe('Kingdom classification.'),
+        phylum: z.string().optional().describe('Phylum classification.'),
+        class: z.string().optional().describe('Class classification.'),
+        order: z.string().optional().describe('Order classification.'),
+        family: z.string().optional().describe('Family classification.'),
+        genus: z.string().optional().describe('Genus classification.'),
+        species: z.string().optional().describe('Species canonical name.'),
+        kingdomKey: z.number().optional().describe('Taxon key for the kingdom.'),
+        phylumKey: z.number().optional().describe('Taxon key for the phylum.'),
+        classKey: z.number().optional().describe('Taxon key for the class.'),
+        orderKey: z.number().optional().describe('Taxon key for the order.'),
+        familyKey: z.number().optional().describe('Taxon key for the family.'),
+        genusKey: z.number().optional().describe('Taxon key for the genus.'),
+        speciesKey: z.number().optional().describe('Taxon key for the species.'),
+        acceptedKey: z
+            .number()
+            .optional()
+            .describe('Backbone key of the accepted taxon when this record is a synonym.'),
+        accepted: z
+            .string()
+            .optional()
+            .describe('Scientific name of the accepted taxon when this record is a synonym.'),
+        parentKey: z.number().optional().describe('Taxon key of the immediate parent.'),
+        parent: z.string().optional().describe('Name of the immediate parent taxon.'),
+    }),
+    errors: [
+        {
+            reason: 'not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The taxonKey does not exist in the GBIF backbone.',
+            recovery: 'Use gbif_match_species to resolve a name to a valid backbone key, or gbif_search_species to browse.',
+        },
+    ],
+    async handler(input, ctx) {
+        ctx.log.info('Fetching species record', { taxonKey: input.taxonKey });
+        let raw;
+        try {
+            raw = await getGbifService().getSpecies(input.taxonKey, ctx);
+        }
+        catch (err) {
+            if (err instanceof McpError && err.code === -32001) {
+                throw ctx.fail('not_found', `Taxon key ${input.taxonKey} not found in the GBIF backbone.`, {
+                    ...ctx.recoveryFor('not_found'),
+                });
+            }
+            throw err;
+        }
+        if (!raw.key) {
+            throw ctx.fail('not_found', `Taxon key ${input.taxonKey} not found in the GBIF backbone.`, {
+                ...ctx.recoveryFor('not_found'),
+            });
+        }
+        return {
+            key: raw.key,
+            scientificName: raw.scientificName,
+            canonicalName: raw.canonicalName,
+            authorship: raw.authorship,
+            vernacularName: raw.vernacularName,
+            rank: raw.rank,
+            taxonomicStatus: raw.taxonomicStatus,
+            numDescendants: raw.numDescendants,
+            numOccurrences: raw.numOccurrences,
+            publishedIn: raw.publishedIn,
+            kingdom: raw.kingdom,
+            phylum: raw.phylum,
+            // GBIF API uses 'clazz' to avoid reserved word; we normalize to 'class'
+            class: raw.clazz,
+            order: raw.order,
+            family: raw.family,
+            genus: raw.genus,
+            species: raw.species,
+            kingdomKey: raw.kingdomKey,
+            phylumKey: raw.phylumKey,
+            classKey: raw.classKey,
+            orderKey: raw.orderKey,
+            familyKey: raw.familyKey,
+            genusKey: raw.genusKey,
+            speciesKey: raw.speciesKey,
+            acceptedKey: raw.acceptedKey,
+            accepted: raw.accepted,
+            parentKey: raw.parentKey,
+            parent: raw.parent,
+            ...(typeof raw.extinct === 'boolean' && { extinct: raw.extinct }),
+        };
+    },
+    format: (result) => {
+        const lines = [];
+        if (result.canonicalName || result.scientificName) {
+            lines.push(`## ${result.canonicalName ?? result.scientificName}`);
+        }
+        if (result.key != null)
+            lines.push(`**Taxon key:** ${result.key}`);
+        if (result.scientificName)
+            lines.push(`**Scientific name:** ${result.scientificName}`);
+        if (result.authorship)
+            lines.push(`**Authorship:** ${result.authorship}`);
+        if (result.vernacularName)
+            lines.push(`**Common name:** ${result.vernacularName}`);
+        if (result.rank)
+            lines.push(`**Rank:** ${result.rank}`);
+        if (result.taxonomicStatus)
+            lines.push(`**Status:** ${result.taxonomicStatus}`);
+        if (result.accepted)
+            lines.push(`**Accepted name:** ${result.accepted}${result.acceptedKey != null ? ` (key: ${result.acceptedKey})` : ''}`);
+        else if (result.acceptedKey != null)
+            lines.push(`**Accepted key:** ${result.acceptedKey}`);
+        if (result.parent)
+            lines.push(`**Parent:** ${result.parent}${result.parentKey != null ? ` (key: ${result.parentKey})` : ''}`);
+        else if (result.parentKey != null)
+            lines.push(`**Parent key:** ${result.parentKey}`);
+        if (result.numDescendants != null)
+            lines.push(`**Descendants:** ${result.numDescendants}`);
+        if (result.numOccurrences != null)
+            lines.push(`**Occurrences:** ${result.numOccurrences}`);
+        if (typeof result.extinct === 'boolean') {
+            lines.push(`**Extinct:** ${result.extinct ? 'Yes' : 'No'}`);
+        }
+        if (result.publishedIn)
+            lines.push(`**Published in:** ${result.publishedIn}`);
+        const classificationParts = [];
+        if (result.kingdom)
+            classificationParts.push(`Kingdom: ${result.kingdom}${result.kingdomKey ? ` (${result.kingdomKey})` : ''}`);
+        if (result.phylum)
+            classificationParts.push(`Phylum: ${result.phylum}${result.phylumKey ? ` (${result.phylumKey})` : ''}`);
+        if (result.class)
+            classificationParts.push(`Class: ${result.class}${result.classKey ? ` (${result.classKey})` : ''}`);
+        if (result.order)
+            classificationParts.push(`Order: ${result.order}${result.orderKey ? ` (${result.orderKey})` : ''}`);
+        if (result.family)
+            classificationParts.push(`Family: ${result.family}${result.familyKey ? ` (${result.familyKey})` : ''}`);
+        if (result.genus)
+            classificationParts.push(`Genus: ${result.genus}${result.genusKey ? ` (${result.genusKey})` : ''}`);
+        if (result.species)
+            classificationParts.push(`Species: ${result.species}${result.speciesKey ? ` (${result.speciesKey})` : ''}`);
+        if (classificationParts.length > 0) {
+            lines.push(`**Classification:** ${classificationParts.join(' › ')}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=gbif-get-species.tool.js.map

package/dist/mcp-server/tools/definitions/gbif-get-species.tool.js.map

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

package/dist/mcp-server/tools/definitions/gbif-match-species.tool.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @fileoverview Match a species name against the GBIF backbone taxonomy.
+ * @module mcp-server/tools/definitions/gbif-match-species
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const gbifMatchSpecies: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    name: z.ZodString;
+    strict: z.ZodDefault<z.ZodBoolean>;
+    kingdom: z.ZodOptional<z.ZodString>;
+    rank: z.ZodOptional<z.ZodEnum<{
+        KINGDOM: "KINGDOM";
+        PHYLUM: "PHYLUM";
+        CLASS: "CLASS";
+        ORDER: "ORDER";
+        FAMILY: "FAMILY";
+        GENUS: "GENUS";
+        SPECIES: "SPECIES";
+        SUBSPECIES: "SUBSPECIES";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    taxonKey: z.ZodOptional<z.ZodNumber>;
+    scientificName: z.ZodOptional<z.ZodString>;
+    canonicalName: z.ZodOptional<z.ZodString>;
+    rank: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodString>;
+    confidence: z.ZodOptional<z.ZodNumber>;
+    matchType: z.ZodOptional<z.ZodString>;
+    kingdom: z.ZodOptional<z.ZodString>;
+    phylum: z.ZodOptional<z.ZodString>;
+    class: z.ZodOptional<z.ZodString>;
+    order: z.ZodOptional<z.ZodString>;
+    family: z.ZodOptional<z.ZodString>;
+    genus: z.ZodOptional<z.ZodString>;
+    species: z.ZodOptional<z.ZodString>;
+    kingdomKey: z.ZodOptional<z.ZodNumber>;
+    phylumKey: z.ZodOptional<z.ZodNumber>;
+    classKey: z.ZodOptional<z.ZodNumber>;
+    orderKey: z.ZodOptional<z.ZodNumber>;
+    familyKey: z.ZodOptional<z.ZodNumber>;
+    genusKey: z.ZodOptional<z.ZodNumber>;
+    speciesKey: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "no_match";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "matchType is NONE — no candidate met the match threshold.";
+    readonly recovery: "Try a broader name, remove the strict flag, or search with gbif_search_species instead.";
+}]>;
+//# sourceMappingURL=gbif-match-species.tool.d.ts.map

package/dist/mcp-server/tools/definitions/gbif-match-species.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gbif-match-species.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/gbif-match-species.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsK3B,CAAC"}

package/dist/mcp-server/tools/definitions/gbif-match-species.tool.js

@@ -0,0 +1,148 @@
+/**
+ * @fileoverview Match a species name against the GBIF backbone taxonomy.
+ * @module mcp-server/tools/definitions/gbif-match-species
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getGbifService } from '../../../services/gbif/gbif-service.js';
+export const gbifMatchSpecies = tool('gbif_match_species', {
+    title: 'Match Species Name',
+    description: 'Match a scientific name against the GBIF backbone taxonomy. ' +
+        'Returns the best-matching taxon with full classification and a confidence score (0–100). ' +
+        'This is the mandatory first step for any GBIF workflow — it resolves synonyms and returns ' +
+        'the backbone taxonKey required by gbif_search_occurrences, gbif_count_occurrences, and ' +
+        'gbif_occurrence_facets. Below confidence 80, the match should be reviewed. ' +
+        'matchType NONE means no usable match was found — try removing the strict flag or broadening the name.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    input: z.object({
+        name: z
+            .string()
+            .describe('Scientific name to match. Examples: "Parus major", "Agaricus bisporus", "Homo sapiens". Fuzzy matching handles minor spelling variations. Common names are not supported — use gbif_search_species for vernacular name searches.'),
+        strict: z
+            .boolean()
+            .default(false)
+            .describe('When true, only return an exact match. When false (default), GBIF applies fuzzy matching — useful for minor spelling variations and abbreviated names.'),
+        kingdom: z
+            .string()
+            .optional()
+            .describe('Narrow the match to a specific kingdom (e.g., "Animalia", "Plantae", "Fungi") to disambiguate names that appear in multiple kingdoms.'),
+        rank: z
+            .enum(['KINGDOM', 'PHYLUM', 'CLASS', 'ORDER', 'FAMILY', 'GENUS', 'SPECIES', 'SUBSPECIES'])
+            .optional()
+            .describe('Expected taxonomic rank. Use to avoid matching a genus when you expect a species.'),
+    }),
+    output: z.object({
+        taxonKey: z
+            .number()
+            .optional()
+            .describe('GBIF backbone taxon key. Use this in downstream tools. Absent when matchType is NONE.'),
+        scientificName: z.string().optional().describe('Full scientific name with authorship.'),
+        canonicalName: z.string().optional().describe('Scientific name without authorship.'),
+        rank: z.string().optional().describe('Taxonomic rank of the matched taxon.'),
+        status: z.string().optional().describe('Taxonomic status: ACCEPTED, SYNONYM, or DOUBTFUL.'),
+        confidence: z
+            .number()
+            .optional()
+            .describe('Match confidence score 0–100. Below 80 warrants review.'),
+        matchType: z
+            .string()
+            .optional()
+            .describe('EXACT, FUZZY, HIGHERORDER, or NONE. NONE means no usable match.'),
+        kingdom: z.string().optional().describe('Kingdom of the matched taxon.'),
+        phylum: z.string().optional().describe('Phylum of the matched taxon.'),
+        class: z.string().optional().describe('Class of the matched taxon.'),
+        order: z.string().optional().describe('Order of the matched taxon.'),
+        family: z.string().optional().describe('Family of the matched taxon.'),
+        genus: z.string().optional().describe('Genus of the matched taxon.'),
+        species: z.string().optional().describe('Species canonical name of the matched taxon.'),
+        kingdomKey: z.number().optional().describe('Backbone taxon key for the kingdom.'),
+        phylumKey: z.number().optional().describe('Backbone taxon key for the phylum.'),
+        classKey: z.number().optional().describe('Backbone taxon key for the class.'),
+        orderKey: z.number().optional().describe('Backbone taxon key for the order.'),
+        familyKey: z.number().optional().describe('Backbone taxon key for the family.'),
+        genusKey: z.number().optional().describe('Backbone taxon key for the genus.'),
+        speciesKey: z.number().optional().describe('Backbone taxon key for the species.'),
+    }),
+    errors: [
+        {
+            reason: 'no_match',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'matchType is NONE — no candidate met the match threshold.',
+            recovery: 'Try a broader name, remove the strict flag, or search with gbif_search_species instead.',
+        },
+    ],
+    async handler(input, ctx) {
+        ctx.log.info('Matching species name', { name: input.name, strict: input.strict });
+        const raw = await getGbifService().matchSpecies({
+            name: input.name,
+            strict: input.strict,
+            ...(input.kingdom?.trim() && { kingdom: input.kingdom }),
+            ...(input.rank && { rank: input.rank }),
+        }, ctx);
+        if (raw.matchType === 'NONE' || !raw.usageKey) {
+            throw ctx.fail('no_match', `No backbone match for "${input.name}"`, {
+                ...ctx.recoveryFor('no_match'),
+            });
+        }
+        return {
+            taxonKey: raw.usageKey,
+            scientificName: raw.scientificName,
+            canonicalName: raw.canonicalName,
+            rank: raw.rank,
+            status: raw.status,
+            confidence: raw.confidence,
+            matchType: raw.matchType,
+            kingdom: raw.kingdom,
+            phylum: raw.phylum,
+            class: raw.class,
+            order: raw.order,
+            family: raw.family,
+            genus: raw.genus,
+            species: raw.species,
+            kingdomKey: raw.kingdomKey,
+            phylumKey: raw.phylumKey,
+            classKey: raw.classKey,
+            orderKey: raw.orderKey,
+            familyKey: raw.familyKey,
+            genusKey: raw.genusKey,
+            speciesKey: raw.speciesKey,
+        };
+    },
+    format: (result) => {
+        const lines = [];
+        if (result.canonicalName)
+            lines.push(`## ${result.canonicalName}`);
+        if (result.scientificName)
+            lines.push(`**Scientific name:** ${result.scientificName}`);
+        if (result.taxonKey != null)
+            lines.push(`**Taxon key:** ${result.taxonKey}`);
+        if (result.rank)
+            lines.push(`**Rank:** ${result.rank}`);
+        if (result.status)
+            lines.push(`**Status:** ${result.status}`);
+        if (result.matchType)
+            lines.push(`**Match type:** ${result.matchType}`);
+        if (result.confidence != null)
+            lines.push(`**Confidence:** ${result.confidence}/100`);
+        const classificationParts = [];
+        if (result.kingdom)
+            classificationParts.push(`Kingdom: ${result.kingdom}${result.kingdomKey ? ` (${result.kingdomKey})` : ''}`);
+        if (result.phylum)
+            classificationParts.push(`Phylum: ${result.phylum}${result.phylumKey ? ` (${result.phylumKey})` : ''}`);
+        if (result.class)
+            classificationParts.push(`Class: ${result.class}${result.classKey ? ` (${result.classKey})` : ''}`);
+        if (result.order)
+            classificationParts.push(`Order: ${result.order}${result.orderKey ? ` (${result.orderKey})` : ''}`);
+        if (result.family)
+            classificationParts.push(`Family: ${result.family}${result.familyKey ? ` (${result.familyKey})` : ''}`);
+        if (result.genus)
+            classificationParts.push(`Genus: ${result.genus}${result.genusKey ? ` (${result.genusKey})` : ''}`);
+        if (result.species)
+            classificationParts.push(`Species: ${result.species}${result.speciesKey ? ` (${result.speciesKey})` : ''}`);
+        if (classificationParts.length > 0) {
+            lines.push(`**Classification:** ${classificationParts.join(' › ')}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=gbif-match-species.tool.js.map

package/dist/mcp-server/tools/definitions/gbif-match-species.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gbif-match-species.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/gbif-match-species.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC,oBAAoB,EAAE;IACzD,KAAK,EAAE,oBAAoB;IAC3B,WAAW,EACT,8DAA8D;QAC9D,2FAA2F;QAC3F,4FAA4F;QAC5F,yFAAyF;QACzF,6EAA6E;QAC7E,uGAAuG;IACzG,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;IAC/E,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,CACP,kOAAkO,CACnO;QACH,MAAM,EAAE,CAAC;aACN,OAAO,EAAE;aACT,OAAO,CAAC,KAAK,CAAC;aACd,QAAQ,CACP,wJAAwJ,CACzJ;QACH,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,uIAAuI,CACxI;QACH,IAAI,EAAE,CAAC;aACJ,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;aACzF,QAAQ,EAAE;aACV,QAAQ,CACP,mFAAmF,CACpF;KACJ,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,uFAAuF,CACxF;QACH,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;QACvF,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;QACpF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;QAC5E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;QAC3F,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,yDAAyD,CAAC;QACtE,SAAS,EAAE,CAAC;aACT,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,iEAAiE,CAAC;QAC9E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;QACxE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;QACtE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;QACpE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;QACpE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;QACtE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;QACpE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;QACvF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;QACjF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;QAC/E,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;QAC7E,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;QAC7E,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;QAC/E,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;QAC7E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;KAClF,CAAC;IAEF,MAAM,EAAE;QACN;YACE,MAAM,EAAE,UAAU;YAClB,IAAI,EAAE,gBAAgB,CAAC,QAAQ;YAC/B,IAAI,EAAE,2DAA2D;YACjE,QAAQ,EACN,yFAAyF;SAC5F;KACF;IAED,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAClF,MAAM,GAAG,GAAG,MAAM,cAAc,EAAE,CAAC,YAAY,CAC7C;YACE,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;YACxD,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;SACxC,EACD,GAAG,CACJ,CAAC;QAEF,IAAI,GAAG,CAAC,SAAS,KAAK,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC9C,MAAM,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,0BAA0B,KAAK,CAAC,IAAI,GAAG,EAAE;gBAClE,GAAG,GAAG,CAAC,WAAW,CAAC,UAAU,CAAC;aAC/B,CAAC,CAAC;QACL,CAAC;QAED,OAAO;YACL,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,cAAc,EAAE,GAAG,CAAC,cAAc;YAClC,aAAa,EAAE,GAAG,CAAC,aAAa;YAChC,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,UAAU,EAAE,GAAG,CAAC,UAAU;SAC3B,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QACjB,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,MAAM,CAAC,aAAa;YAAE,KAAK,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC;QACnE,IAAI,MAAM,CAAC,cAAc;YAAE,KAAK,CAAC,IAAI,CAAC,wBAAwB,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;QACvF,IAAI,MAAM,CAAC,QAAQ,IAAI,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC7E,IAAI,MAAM,CAAC,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACxD,IAAI,MAAM,CAAC,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9D,IAAI,MAAM,CAAC,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,mBAAmB,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QACxE,IAAI,MAAM,CAAC,UAAU,IAAI,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,mBAAmB,MAAM,CAAC,UAAU,MAAM,CAAC,CAAC;QACtF,MAAM,mBAAmB,GAAa,EAAE,CAAC;QACzC,IAAI,MAAM,CAAC,OAAO;YAChB,mBAAmB,CAAC,IAAI,CACtB,YAAY,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAClF,CAAC;QACJ,IAAI,MAAM,CAAC,MAAM;YACf,mBAAmB,CAAC,IAAI,CACtB,WAAW,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC9E,CAAC;QACJ,IAAI,MAAM,CAAC,KAAK;YACd,mBAAmB,CAAC,IAAI,CACtB,UAAU,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC1E,CAAC;QACJ,IAAI,MAAM,CAAC,KAAK;YACd,mBAAmB,CAAC,IAAI,CACtB,UAAU,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC1E,CAAC;QACJ,IAAI,MAAM,CAAC,MAAM;YACf,mBAAmB,CAAC,IAAI,CACtB,WAAW,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC9E,CAAC;QACJ,IAAI,MAAM,CAAC,KAAK;YACd,mBAAmB,CAAC,IAAI,CACtB,UAAU,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC1E,CAAC;QACJ,IAAI,MAAM,CAAC,OAAO;YAChB,mBAAmB,CAAC,IAAI,CACtB,YAAY,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAClF,CAAC;QACJ,IAAI,mBAAmB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,uBAAuB,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/tools/definitions/gbif-occurrence-facets.tool.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @fileoverview Aggregate GBIF occurrence counts by a facet dimension.
+ * @module mcp-server/tools/definitions/gbif-occurrence-facets
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const gbifOccurrenceFacets: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    facet: z.ZodEnum<{
+        BASIS_OF_RECORD: "BASIS_OF_RECORD";
+        COUNTRY: "COUNTRY";
+        YEAR: "YEAR";
+        DATASET_KEY: "DATASET_KEY";
+        KINGDOM_KEY: "KINGDOM_KEY";
+        PHYLUM_KEY: "PHYLUM_KEY";
+        CLASS_KEY: "CLASS_KEY";
+        ORDER_KEY: "ORDER_KEY";
+        FAMILY_KEY: "FAMILY_KEY";
+        GENUS_KEY: "GENUS_KEY";
+        SPECIES_KEY: "SPECIES_KEY";
+        PUBLISHING_COUNTRY: "PUBLISHING_COUNTRY";
+        MONTH: "MONTH";
+    }>;
+    taxonKey: z.ZodOptional<z.ZodNumber>;
+    country: z.ZodOptional<z.ZodString>;
+    year: z.ZodOptional<z.ZodString>;
+    basisOfRecord: z.ZodOptional<z.ZodEnum<{
+        HUMAN_OBSERVATION: "HUMAN_OBSERVATION";
+        MACHINE_OBSERVATION: "MACHINE_OBSERVATION";
+        PRESERVED_SPECIMEN: "PRESERVED_SPECIMEN";
+        LIVING_SPECIMEN: "LIVING_SPECIMEN";
+        MATERIAL_SAMPLE: "MATERIAL_SAMPLE";
+        MATERIAL_CITATION: "MATERIAL_CITATION";
+        OCCURRENCE: "OCCURRENCE";
+        LITERATURE: "LITERATURE";
+    }>>;
+    geometry: z.ZodOptional<z.ZodString>;
+    facetLimit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    facet: z.ZodString;
+    totalOccurrences: z.ZodNumber;
+    counts: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        count: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>, undefined>;
+//# sourceMappingURL=gbif-occurrence-facets.tool.d.ts.map

package/dist/mcp-server/tools/definitions/gbif-occurrence-facets.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gbif-occurrence-facets.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/gbif-occurrence-facets.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AA8BjD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BA+F/B,CAAC"}

package/dist/mcp-server/tools/definitions/gbif-occurrence-facets.tool.js

@@ -0,0 +1,116 @@
+/**
+ * @fileoverview Aggregate GBIF occurrence counts by a facet dimension.
+ * @module mcp-server/tools/definitions/gbif-occurrence-facets
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { getGbifService } from '../../../services/gbif/gbif-service.js';
+const BASIS_OF_RECORD_VALUES = [
+    'HUMAN_OBSERVATION',
+    'MACHINE_OBSERVATION',
+    'PRESERVED_SPECIMEN',
+    'LIVING_SPECIMEN',
+    'MATERIAL_SAMPLE',
+    'MATERIAL_CITATION',
+    'OCCURRENCE',
+    'LITERATURE',
+];
+const FACET_VALUES = [
+    'BASIS_OF_RECORD',
+    'COUNTRY',
+    'YEAR',
+    'DATASET_KEY',
+    'KINGDOM_KEY',
+    'PHYLUM_KEY',
+    'CLASS_KEY',
+    'ORDER_KEY',
+    'FAMILY_KEY',
+    'GENUS_KEY',
+    'SPECIES_KEY',
+    'PUBLISHING_COUNTRY',
+    'MONTH',
+];
+export const gbifOccurrenceFacets = tool('gbif_occurrence_facets', {
+    title: 'Occurrence Facet Aggregation',
+    description: 'Aggregate occurrence counts across a dimension (COUNTRY, YEAR, BASIS_OF_RECORD, DATASET_KEY, ' +
+        'KINGDOM_KEY, etc.). Returns the top-N facet values ranked by count — no record payloads returned. ' +
+        'Core tool for distribution analysis and trend queries: "which countries have the most records ' +
+        'for this species?", "how has observation volume changed since 2010?". ' +
+        'Scope the aggregation with taxonKey, country, year, geometry, or basisOfRecord filters.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    input: z.object({
+        facet: z
+            .enum(FACET_VALUES)
+            .describe('Dimension to aggregate by (e.g., COUNTRY, YEAR, BASIS_OF_RECORD, SPECIES_KEY).'),
+        taxonKey: z.number().optional().describe('Backbone taxon key to scope the aggregation.'),
+        country: z
+            .string()
+            .optional()
+            .describe('ISO 3166-1 alpha-2 country code to scope to one country.'),
+        year: z
+            .string()
+            .optional()
+            .describe('Year or year range (e.g., "2020,2024") to scope the aggregation.'),
+        basisOfRecord: z
+            .enum(BASIS_OF_RECORD_VALUES)
+            .optional()
+            .describe('Scope to a specific basis of record.'),
+        geometry: z
+            .string()
+            .optional()
+            .describe('WKT polygon to scope the aggregation to a geographic area (e.g., POLYGON((8 47, 9 47, 9 48, 8 48, 8 47))). Coordinates are longitude latitude.'),
+        facetLimit: z
+            .number()
+            .min(1)
+            .max(100)
+            .default(10)
+            .describe('Maximum number of facet values to return (default 10, max 100).'),
+    }),
+    output: z.object({
+        facet: z.string().describe('The facet dimension aggregated.'),
+        totalOccurrences: z.number().describe('Total matching occurrences across all facet values.'),
+        counts: z
+            .array(z
+            .object({
+            name: z.string().describe('Facet value (country code, year, basisOfRecord, etc.).'),
+            count: z.number().describe('Occurrence count for this facet value.'),
+        })
+            .describe('A facet value with its occurrence count.'))
+            .describe('Facet values ranked by count descending (top facetLimit entries).'),
+    }),
+    async handler(input, ctx) {
+        ctx.log.info('Fetching occurrence facets', { facet: input.facet, taxonKey: input.taxonKey });
+        const raw = await getGbifService().getOccurrenceFacets({
+            facet: input.facet,
+            ...(input.taxonKey !== undefined && { taxonKey: input.taxonKey }),
+            ...(input.country?.trim() && { country: input.country }),
+            ...(input.year?.trim() && { year: input.year }),
+            ...(input.basisOfRecord && { basisOfRecord: input.basisOfRecord }),
+            ...(input.geometry?.trim() && { geometry: input.geometry }),
+            facetLimit: input.facetLimit,
+        }, ctx);
+        const facetData = raw.facets?.find((f) => f.field?.toUpperCase() === input.facet.toUpperCase());
+        const counts = (facetData?.counts ?? []).map((c) => ({
+            name: c.name ?? '',
+            count: c.count ?? 0,
+        }));
+        return {
+            facet: input.facet,
+            totalOccurrences: raw.count ?? 0,
+            counts,
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `## ${result.facet} Facet`,
+            `**Total occurrences in scope:** ${result.totalOccurrences}`,
+            `**Top ${result.counts.length} values:**`,
+        ];
+        const maxCount = result.counts[0]?.count ?? 1;
+        for (const entry of result.counts) {
+            const pct = ((entry.count / maxCount) * 100).toFixed(0);
+            lines.push(`- **${entry.name}**: ${entry.count.toLocaleString()} (${pct}% of top)`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=gbif-occurrence-facets.tool.js.map

package/dist/mcp-server/tools/definitions/gbif-occurrence-facets.tool.js.map

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

package/dist/mcp-server/tools/definitions/gbif-search-datasets.tool.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @fileoverview Search GBIF datasets by keyword, type, or country.
+ * @module mcp-server/tools/definitions/gbif-search-datasets
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const gbifSearchDatasets: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    q: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<{
+        OCCURRENCE: "OCCURRENCE";
+        CHECKLIST: "CHECKLIST";
+        METADATA: "METADATA";
+        SAMPLING_EVENT: "SAMPLING_EVENT";
+    }>>;
+    publishingCountry: z.ZodOptional<z.ZodString>;
+    hostingOrg: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    datasets: z.ZodArray<z.ZodObject<{
+        key: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        license: z.ZodOptional<z.ZodString>;
+        doi: z.ZodOptional<z.ZodString>;
+        publishingCountry: z.ZodOptional<z.ZodString>;
+        recordCount: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    totalCount: z.ZodNumber;
+    offset: z.ZodNumber;
+    limit: z.ZodNumber;
+    endOfRecords: z.ZodBoolean;
+}, z.core.$strip>, undefined>;
+//# sourceMappingURL=gbif-search-datasets.tool.d.ts.map

package/dist/mcp-server/tools/definitions/gbif-search-datasets.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gbif-search-datasets.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/gbif-search-datasets.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAIjD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;6BA4G7B,CAAC"}