@cyanheads/gbif-biodiversity-mcp-server 0.2.0

package/dist/index.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview gbif-biodiversity-mcp-server MCP server entry point.
+ * @module index
+ */
+import { createApp } from '@cyanheads/mcp-ts-core';
+import { getServerConfig } from './config/server-config.js';
+// Resources
+import { gbifDatasetResource } from './mcp-server/resources/definitions/gbif-dataset.resource.js';
+import { gbifSpeciesResource } from './mcp-server/resources/definitions/gbif-species.resource.js';
+import { gbifCountOccurrences } from './mcp-server/tools/definitions/gbif-count-occurrences.tool.js';
+import { gbifGetDataset } from './mcp-server/tools/definitions/gbif-get-dataset.tool.js';
+import { gbifGetOccurrence } from './mcp-server/tools/definitions/gbif-get-occurrence.tool.js';
+import { gbifGetSpecies } from './mcp-server/tools/definitions/gbif-get-species.tool.js';
+import { gbifGetSpeciesChildren } from './mcp-server/tools/definitions/gbif-get-species-children.tool.js';
+import { gbifGetSpeciesClassification } from './mcp-server/tools/definitions/gbif-get-species-classification.tool.js';
+// Taxonomy tools
+import { gbifMatchSpecies } from './mcp-server/tools/definitions/gbif-match-species.tool.js';
+import { gbifOccurrenceFacets } from './mcp-server/tools/definitions/gbif-occurrence-facets.tool.js';
+// Dataset and publisher tools
+import { gbifSearchDatasets } from './mcp-server/tools/definitions/gbif-search-datasets.tool.js';
+// Occurrence tools
+import { gbifSearchOccurrences } from './mcp-server/tools/definitions/gbif-search-occurrences.tool.js';
+import { gbifSearchPublishers } from './mcp-server/tools/definitions/gbif-search-publishers.tool.js';
+import { gbifSearchSpecies } from './mcp-server/tools/definitions/gbif-search-species.tool.js';
+import { initGbifService } from './services/gbif/gbif-service.js';
+await createApp({
+    tools: [
+        gbifMatchSpecies,
+        gbifGetSpecies,
+        gbifSearchSpecies,
+        gbifGetSpeciesClassification,
+        gbifGetSpeciesChildren,
+        gbifSearchOccurrences,
+        gbifCountOccurrences,
+        gbifGetOccurrence,
+        gbifOccurrenceFacets,
+        gbifSearchDatasets,
+        gbifGetDataset,
+        gbifSearchPublishers,
+    ],
+    resources: [gbifSpeciesResource, gbifDatasetResource],
+    prompts: [],
+    setup(core) {
+        const cfg = getServerConfig();
+        initGbifService(core.config, core.storage, {
+            baseUrl: cfg.baseUrl,
+            timeoutMs: cfg.requestTimeoutMs,
+            ...(cfg.apiKey ? { apiKey: cfg.apiKey } : {}),
+        });
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,YAAY;AACZ,OAAO,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AAClG,OAAO,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AAClG,OAAO,EAAE,oBAAoB,EAAE,MAAM,+DAA+D,CAAC;AACrG,OAAO,EAAE,cAAc,EAAE,MAAM,yDAAyD,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,4DAA4D,CAAC;AAC/F,OAAO,EAAE,cAAc,EAAE,MAAM,yDAAyD,CAAC;AACzF,OAAO,EAAE,sBAAsB,EAAE,MAAM,kEAAkE,CAAC;AAC1G,OAAO,EAAE,4BAA4B,EAAE,MAAM,wEAAwE,CAAC;AACtH,iBAAiB;AACjB,OAAO,EAAE,gBAAgB,EAAE,MAAM,2DAA2D,CAAC;AAC7F,OAAO,EAAE,oBAAoB,EAAE,MAAM,+DAA+D,CAAC;AACrG,8BAA8B;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,6DAA6D,CAAC;AACjG,mBAAmB;AACnB,OAAO,EAAE,qBAAqB,EAAE,MAAM,gEAAgE,CAAC;AACvG,OAAO,EAAE,oBAAoB,EAAE,MAAM,+DAA+D,CAAC;AACrG,OAAO,EAAE,iBAAiB,EAAE,MAAM,4DAA4D,CAAC;AAC/F,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAElE,MAAM,SAAS,CAAC;IACd,KAAK,EAAE;QACL,gBAAgB;QAChB,cAAc;QACd,iBAAiB;QACjB,4BAA4B;QAC5B,sBAAsB;QACtB,qBAAqB;QACrB,oBAAoB;QACpB,iBAAiB;QACjB,oBAAoB;QACpB,kBAAkB;QAClB,cAAc;QACd,oBAAoB;KACrB;IACD,SAAS,EAAE,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;IACrD,OAAO,EAAE,EAAE;IACX,KAAK,CAAC,IAAI;QACR,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;QAC9B,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE;YACzC,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,SAAS,EAAE,GAAG,CAAC,gBAAgB;YAC/B,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9C,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/resources/definitions/gbif-dataset.resource.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @fileoverview GBIF dataset resource — stable URI for dataset metadata.
+ * @module mcp-server/resources/definitions/gbif-dataset
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const gbifDatasetResource: import("@cyanheads/mcp-ts-core").ResourceDefinition<z.ZodObject<{
+    datasetKey: z.ZodString;
+}, z.core.$strip>, 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>;
+    citationText: z.ZodOptional<z.ZodString>;
+    publishingCountry: z.ZodOptional<z.ZodString>;
+    recordCount: z.ZodOptional<z.ZodNumber>;
+    numConstituents: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, undefined>;
+//# sourceMappingURL=gbif-dataset.resource.d.ts.map

package/dist/mcp-server/resources/definitions/gbif-dataset.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gbif-dataset.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/gbif-dataset.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAIrD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;6BA6C9B,CAAC"}

package/dist/mcp-server/resources/definitions/gbif-dataset.resource.js

@@ -0,0 +1,50 @@
+/**
+ * @fileoverview GBIF dataset resource — stable URI for dataset metadata.
+ * @module mcp-server/resources/definitions/gbif-dataset
+ */
+import { resource, z } from '@cyanheads/mcp-ts-core';
+import { notFound } from '@cyanheads/mcp-ts-core/errors';
+import { getGbifService } from '../../../services/gbif/gbif-service.js';
+export const gbifDatasetResource = resource('gbif://dataset/{datasetKey}', {
+    name: 'gbif-dataset',
+    title: 'GBIF Dataset',
+    description: 'Dataset metadata — title, description, citation, license, contacts, coverage. ' +
+        'Stable URI for provenance context. Use the dataset UUID from gbif_search_datasets or ' +
+        "an occurrence record's datasetKey field.",
+    mimeType: 'application/json',
+    params: z.object({
+        datasetKey: z.string().describe('Dataset UUID.'),
+    }),
+    output: z.object({
+        key: z.string().optional().describe('Dataset UUID.'),
+        title: z.string().optional().describe('Dataset title.'),
+        type: z.string().optional().describe('Dataset type.'),
+        description: z.string().optional().describe('Dataset description. May be absent.'),
+        license: z.string().optional().describe('License identifier. May be absent.'),
+        doi: z.string().optional().describe('DOI for citation. May be absent.'),
+        citationText: z.string().optional().describe('Full citation text. May be absent.'),
+        publishingCountry: z.string().optional().describe('Publishing organization country.'),
+        recordCount: z.number().optional().describe('Number of records. May be absent.'),
+        numConstituents: z.number().optional().describe('Number of sub-datasets. May be absent.'),
+    }),
+    async handler(params, ctx) {
+        ctx.log.debug('Fetching dataset resource', { datasetKey: params.datasetKey });
+        const raw = await getGbifService().getDataset(params.datasetKey, ctx);
+        if (!raw.key) {
+            throw notFound(`Dataset ${params.datasetKey} not found in GBIF.`);
+        }
+        return {
+            key: raw.key,
+            title: raw.title,
+            type: raw.type,
+            description: raw.description,
+            license: raw.license,
+            doi: raw.doi,
+            citationText: raw.citation?.text,
+            publishingCountry: raw.publishingCountry,
+            recordCount: raw.numRecords ?? raw.recordCount,
+            numConstituents: raw.numConstituents,
+        };
+    },
+});
+//# sourceMappingURL=gbif-dataset.resource.js.map

package/dist/mcp-server/resources/definitions/gbif-dataset.resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gbif-dataset.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/gbif-dataset.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE,MAAM,CAAC,MAAM,mBAAmB,GAAG,QAAQ,CAAC,6BAA6B,EAAE;IACzE,IAAI,EAAE,cAAc;IACpB,KAAK,EAAE,cAAc;IACrB,WAAW,EACT,gFAAgF;QAChF,uFAAuF;QACvF,0CAA0C;IAC5C,QAAQ,EAAE,kBAAkB;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;KACjD,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;QACpD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QACvD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;QACrD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;QAClF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;QAC7E,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;QACvE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;QAClF,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;QACrF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;QAChF,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;KAC1F,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG;QACvB,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,2BAA2B,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QAC9E,MAAM,GAAG,GAAG,MAAM,cAAc,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAEtE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;YACb,MAAM,QAAQ,CAAC,WAAW,MAAM,CAAC,UAAU,qBAAqB,CAAC,CAAC;QACpE,CAAC;QAED,OAAO;YACL,GAAG,EAAE,GAAG,CAAC,GAAG;YACZ,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,GAAG,EAAE,GAAG,CAAC,GAAG;YACZ,YAAY,EAAE,GAAG,CAAC,QAAQ,EAAE,IAAI;YAChC,iBAAiB,EAAE,GAAG,CAAC,iBAAiB;YACxC,WAAW,EAAE,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,WAAW;YAC9C,eAAe,EAAE,GAAG,CAAC,eAAe;SACrC,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/resources/definitions/gbif-species.resource.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @fileoverview GBIF species resource — stable URI for taxon records from the backbone.
+ * @module mcp-server/resources/definitions/gbif-species
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const gbifSpeciesResource: import("@cyanheads/mcp-ts-core").ResourceDefinition<z.ZodObject<{
+    taxonKey: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    key: z.ZodOptional<z.ZodNumber>;
+    scientificName: z.ZodOptional<z.ZodString>;
+    canonicalName: z.ZodOptional<z.ZodString>;
+    authorship: z.ZodOptional<z.ZodString>;
+    vernacularName: z.ZodOptional<z.ZodString>;
+    rank: z.ZodOptional<z.ZodString>;
+    taxonomicStatus: 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>;
+    numDescendants: z.ZodOptional<z.ZodNumber>;
+    extinct: z.ZodOptional<z.ZodBoolean>;
+    acceptedKey: z.ZodOptional<z.ZodNumber>;
+    accepted: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, undefined>;
+//# sourceMappingURL=gbif-species.resource.d.ts.map

package/dist/mcp-server/resources/definitions/gbif-species.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gbif-species.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/gbif-species.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAIrD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;6BA8D9B,CAAC"}

package/dist/mcp-server/resources/definitions/gbif-species.resource.js

@@ -0,0 +1,67 @@
+/**
+ * @fileoverview GBIF species resource — stable URI for taxon records from the backbone.
+ * @module mcp-server/resources/definitions/gbif-species
+ */
+import { resource, z } from '@cyanheads/mcp-ts-core';
+import { notFound } from '@cyanheads/mcp-ts-core/errors';
+import { getGbifService } from '../../../services/gbif/gbif-service.js';
+export const gbifSpeciesResource = resource('gbif://species/{taxonKey}', {
+    name: 'gbif-species',
+    title: 'GBIF Species Record',
+    description: 'Taxon record from the GBIF backbone — classification, authorship, synonymy status, ' +
+        'vernacular name. Stable URI for caching and injection as context.',
+    mimeType: 'application/json',
+    params: z.object({
+        taxonKey: z.string().describe('GBIF backbone taxon key as a string.'),
+    }),
+    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.'),
+        vernacularName: z.string().optional().describe('English common name when available.'),
+        rank: z.string().optional().describe('Taxonomic rank.'),
+        taxonomicStatus: z.string().optional().describe('ACCEPTED, SYNONYM, DOUBTFUL, etc.'),
+        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.'),
+        numDescendants: z.number().optional().describe('Count of child taxa in backbone.'),
+        extinct: z.boolean().optional().describe('True when explicitly flagged as extinct.'),
+        acceptedKey: z.number().optional().describe('Accepted taxon key when synonym.'),
+        accepted: z.string().optional().describe('Accepted name when synonym.'),
+    }),
+    async handler(params, ctx) {
+        const taxonKey = parseInt(params.taxonKey, 10);
+        if (Number.isNaN(taxonKey)) {
+            throw notFound(`Invalid taxon key: "${params.taxonKey}". Must be a numeric backbone key.`);
+        }
+        ctx.log.debug('Fetching species resource', { taxonKey });
+        const raw = await getGbifService().getSpecies(taxonKey, ctx);
+        if (!raw.key) {
+            throw notFound(`Taxon key ${taxonKey} not found in the GBIF backbone.`);
+        }
+        return {
+            key: raw.key,
+            scientificName: raw.scientificName,
+            canonicalName: raw.canonicalName,
+            authorship: raw.authorship,
+            vernacularName: raw.vernacularName,
+            rank: raw.rank,
+            taxonomicStatus: raw.taxonomicStatus,
+            kingdom: raw.kingdom,
+            phylum: raw.phylum,
+            class: raw.clazz,
+            order: raw.order,
+            family: raw.family,
+            genus: raw.genus,
+            numDescendants: raw.numDescendants,
+            acceptedKey: raw.acceptedKey,
+            accepted: raw.accepted,
+            ...(typeof raw.extinct === 'boolean' && { extinct: raw.extinct }),
+        };
+    },
+});
+//# sourceMappingURL=gbif-species.resource.js.map

package/dist/mcp-server/resources/definitions/gbif-species.resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gbif-species.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/gbif-species.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE,MAAM,CAAC,MAAM,mBAAmB,GAAG,QAAQ,CAAC,2BAA2B,EAAE;IACvE,IAAI,EAAE,cAAc;IACpB,KAAK,EAAE,qBAAqB;IAC5B,WAAW,EACT,qFAAqF;QACrF,mEAAmE;IACrE,QAAQ,EAAE,kBAAkB;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;KACtE,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;QAC/D,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,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;QACnE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;QACrF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QACvD,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;QACpF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QAClE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;QAChE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;QAC9D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;QAC9D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;QAChE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;QAC9D,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;QAClF,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;QACpF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;QAC/E,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;KACxE,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG;QACvB,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC/C,IAAI,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3B,MAAM,QAAQ,CAAC,uBAAuB,MAAM,CAAC,QAAQ,oCAAoC,CAAC,CAAC;QAC7F,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,2BAA2B,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACzD,MAAM,GAAG,GAAG,MAAM,cAAc,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAE7D,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;YACb,MAAM,QAAQ,CAAC,aAAa,QAAQ,kCAAkC,CAAC,CAAC;QAC1E,CAAC;QAED,OAAO;YACL,GAAG,EAAE,GAAG,CAAC,GAAG;YACZ,cAAc,EAAE,GAAG,CAAC,cAAc;YAClC,aAAa,EAAE,GAAG,CAAC,aAAa;YAChC,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,cAAc,EAAE,GAAG,CAAC,cAAc;YAClC,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,eAAe,EAAE,GAAG,CAAC,eAAe;YACpC,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,cAAc,EAAE,GAAG,CAAC,cAAc;YAClC,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,GAAG,CAAC,OAAO,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;SAClE,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/tools/definitions/gbif-count-occurrences.tool.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @fileoverview Count GBIF occurrences matching a filter without fetching records.
+ * @module mcp-server/tools/definitions/gbif-count-occurrences
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const gbifCountOccurrences: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    taxonKey: z.ZodOptional<z.ZodNumber>;
+    country: z.ZodOptional<z.ZodString>;
+    isGeoreferenced: z.ZodOptional<z.ZodBoolean>;
+    datasetKey: z.ZodOptional<z.ZodString>;
+    year: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    count: z.ZodNumber;
+}, z.core.$strip>, undefined>;
+//# sourceMappingURL=gbif-count-occurrences.tool.d.ts.map

package/dist/mcp-server/tools/definitions/gbif-count-occurrences.tool.d.ts.map

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

package/dist/mcp-server/tools/definitions/gbif-count-occurrences.tool.js

@@ -0,0 +1,42 @@
+/**
+ * @fileoverview Count GBIF occurrences matching a filter without fetching records.
+ * @module mcp-server/tools/definitions/gbif-count-occurrences
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { getGbifService } from '../../../services/gbif/gbif-service.js';
+export const gbifCountOccurrences = tool('gbif_count_occurrences', {
+    title: 'Count Occurrences',
+    description: 'Count occurrences matching a taxon + location filter without fetching records. ' +
+        'Use for quick totals ("how many Aves records in Sweden?") or before deciding whether ' +
+        'to paginate a full search. Accepts taxonKey, country, isGeoreferenced, datasetKey, and year.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    input: z.object({
+        taxonKey: z.number().optional().describe('GBIF backbone taxon key from gbif_match_species.'),
+        country: z.string().optional().describe('ISO 3166-1 alpha-2 country code (e.g., "GB", "US").'),
+        isGeoreferenced: z
+            .boolean()
+            .optional()
+            .describe('When true, count only georeferenced records. When false, count only non-georeferenced records.'),
+        datasetKey: z.string().optional().describe('Filter to a specific dataset UUID.'),
+        year: z.string().optional().describe('Year or year range (e.g., "2024" or "2020,2024").'),
+    }),
+    output: z.object({
+        count: z.number().describe('Total occurrences matching the supplied filters.'),
+    }),
+    async handler(input, ctx) {
+        ctx.log.info('Counting occurrences', {
+            taxonKey: input.taxonKey,
+            country: input.country,
+        });
+        const count = await getGbifService().countOccurrences({
+            ...(input.taxonKey !== undefined && { taxonKey: input.taxonKey }),
+            ...(input.country?.trim() && { country: input.country }),
+            ...(input.isGeoreferenced !== undefined && { isGeoreferenced: input.isGeoreferenced }),
+            ...(input.datasetKey?.trim() && { datasetKey: input.datasetKey }),
+            ...(input.year?.trim() && { year: input.year }),
+        }, ctx);
+        return { count };
+    },
+    format: (result) => [{ type: 'text', text: `**Occurrence count:** ${result.count}` }],
+});
+//# sourceMappingURL=gbif-count-occurrences.tool.js.map

package/dist/mcp-server/tools/definitions/gbif-count-occurrences.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gbif-count-occurrences.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/gbif-count-occurrences.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC,wBAAwB,EAAE;IACjE,KAAK,EAAE,mBAAmB;IAC1B,WAAW,EACT,iFAAiF;QACjF,uFAAuF;QACvF,8FAA8F;IAChG,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;IAC/E,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;QAC5F,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qDAAqD,CAAC;QAC9F,eAAe,EAAE,CAAC;aACf,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CACP,gGAAgG,CACjG;QACH,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;QAChF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;KAC1F,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;KAC/E,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,sBAAsB,EAAE;YACnC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,cAAc,EAAE,CAAC,gBAAgB,CACnD;YACE,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;YACjE,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;YACxD,GAAG,CAAC,KAAK,CAAC,eAAe,KAAK,SAAS,IAAI,EAAE,eAAe,EAAE,KAAK,CAAC,eAAe,EAAE,CAAC;YACtF,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC;YACjE,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;SAChD,EACD,GAAG,CACJ,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC;IAED,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,yBAAyB,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;CACtF,CAAC,CAAC"}

package/dist/mcp-server/tools/definitions/gbif-get-dataset.tool.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @fileoverview Fetch full metadata for a GBIF dataset by key.
+ * @module mcp-server/tools/definitions/gbif-get-dataset
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const gbifGetDataset: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    datasetKey: z.ZodString;
+}, z.core.$strip>, 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>;
+    citationText: z.ZodOptional<z.ZodString>;
+    publishingCountry: z.ZodOptional<z.ZodString>;
+    recordCount: z.ZodOptional<z.ZodNumber>;
+    numConstituents: z.ZodOptional<z.ZodNumber>;
+    contacts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodOptional<z.ZodString>;
+        firstName: z.ZodOptional<z.ZodString>;
+        lastName: z.ZodOptional<z.ZodString>;
+        organization: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The datasetKey UUID does not match any dataset in GBIF.";
+    readonly recovery: "Use gbif_search_datasets to find valid dataset keys, or check the UUID from an occurrence record's datasetKey field.";
+}]>;
+//# sourceMappingURL=gbif-get-dataset.tool.d.ts.map

package/dist/mcp-server/tools/definitions/gbif-get-dataset.tool.d.ts.map

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

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

@@ -0,0 +1,143 @@
+/**
+ * @fileoverview Fetch full metadata for a GBIF dataset by key.
+ * @module mcp-server/tools/definitions/gbif-get-dataset
+ */
+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';
+import { stripHtml } from '../utils.js';
+export const gbifGetDataset = tool('gbif_get_dataset', {
+    title: 'Get Dataset',
+    description: 'Fetch full dataset metadata by UUID key — title, description, citation text, contacts, license, ' +
+        'DOI, numConstituents (sub-datasets), and temporal/geographic coverage. Use after gbif_search_datasets ' +
+        "or when an occurrence record's datasetKey needs provenance detail.",
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    input: z.object({
+        datasetKey: z
+            .string()
+            .describe('Dataset UUID from gbif_search_datasets or an occurrence record.'),
+    }),
+    output: z.object({
+        key: z.string().optional().describe('Dataset UUID.'),
+        title: z.string().optional().describe('Dataset title.'),
+        type: z.string().optional().describe('Dataset type (OCCURRENCE, CHECKLIST, etc.).'),
+        description: z.string().optional().describe('Full dataset description. May be absent.'),
+        license: z.string().optional().describe('License identifier. May be absent.'),
+        doi: z.string().optional().describe('DOI for citation. May be absent.'),
+        citationText: z
+            .string()
+            .optional()
+            .describe('Full citation text for academic reference. May be absent.'),
+        publishingCountry: z
+            .string()
+            .optional()
+            .describe('Country code of the publishing organization.'),
+        recordCount: z.number().optional().describe('Number of records in the dataset. May be absent.'),
+        numConstituents: z
+            .number()
+            .optional()
+            .describe('Number of constituent sub-datasets. May be absent.'),
+        contacts: z
+            .array(z
+            .object({
+            type: z
+                .string()
+                .optional()
+                .describe('Contact type (e.g., ADMINISTRATIVE_POINT_OF_CONTACT).'),
+            firstName: z.string().optional().describe('First name. May be absent.'),
+            lastName: z.string().optional().describe('Last name. May be absent.'),
+            organization: z.string().optional().describe('Organization name. May be absent.'),
+            email: z
+                .array(z.string())
+                .optional()
+                .describe('Contact email addresses. May be absent.'),
+        })
+            .describe('A dataset contact with role, name, organization, and email.'))
+            .optional()
+            .describe('Dataset contacts. May be absent.'),
+    }),
+    errors: [
+        {
+            reason: 'not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The datasetKey UUID does not match any dataset in GBIF.',
+            recovery: "Use gbif_search_datasets to find valid dataset keys, or check the UUID from an occurrence record's datasetKey field.",
+        },
+    ],
+    async handler(input, ctx) {
+        ctx.log.info('Fetching dataset record', { datasetKey: input.datasetKey });
+        let raw;
+        try {
+            raw = await getGbifService().getDataset(input.datasetKey, ctx);
+        }
+        catch (err) {
+            if (err instanceof McpError && err.code === -32001) {
+                throw ctx.fail('not_found', `Dataset ${input.datasetKey} not found in GBIF.`, {
+                    ...ctx.recoveryFor('not_found'),
+                });
+            }
+            throw err;
+        }
+        if (!raw.key) {
+            throw ctx.fail('not_found', `Dataset ${input.datasetKey} not found in GBIF.`, {
+                ...ctx.recoveryFor('not_found'),
+            });
+        }
+        const contacts = raw.contacts?.map((c) => ({
+            type: c.type,
+            firstName: c.firstName,
+            lastName: c.lastName,
+            organization: c.organization,
+            email: c.email?.length ? c.email : undefined,
+        }));
+        return {
+            key: raw.key,
+            title: raw.title,
+            type: raw.type,
+            description: raw.description ? stripHtml(raw.description) : undefined,
+            license: raw.license,
+            doi: raw.doi,
+            citationText: raw.citation?.text,
+            publishingCountry: raw.publishingCountry,
+            recordCount: raw.numRecords ?? raw.recordCount,
+            numConstituents: raw.numConstituents,
+            contacts: contacts?.length ? contacts : undefined,
+        };
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push(`## ${result.title ?? 'Dataset'}`);
+        if (result.key)
+            lines.push(`**Key:** ${result.key}`);
+        if (result.type)
+            lines.push(`**Type:** ${result.type}`);
+        if (result.license)
+            lines.push(`**License:** ${result.license}`);
+        if (result.doi)
+            lines.push(`**DOI:** ${result.doi}`);
+        if (result.publishingCountry)
+            lines.push(`**Publishing country:** ${result.publishingCountry}`);
+        if (result.recordCount != null)
+            lines.push(`**Records:** ${result.recordCount.toLocaleString()}`);
+        if (result.numConstituents != null)
+            lines.push(`**Constituent datasets:** ${result.numConstituents}`);
+        if (result.citationText)
+            lines.push(`\n**Citation:**\n> ${result.citationText}`);
+        if (result.description)
+            lines.push(`\n${result.description}`);
+        if (result.contacts?.length) {
+            lines.push('\n**Contacts:**');
+            for (const c of result.contacts) {
+                const name = [c.firstName, c.lastName].filter(Boolean).join(' ');
+                const typeLabel = c.type ? ` [${c.type}]` : '';
+                lines.push(`- ${name || '(unnamed)'}${typeLabel}`);
+                if (c.organization)
+                    lines.push(`  Organization: ${c.organization}`);
+                if (c.email?.length)
+                    lines.push(`  ${c.email.join(', ')}`);
+            }
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=gbif-get-dataset.tool.js.map

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

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

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

@@ -0,0 +1,58 @@
+/**
+ * @fileoverview Fetch a single GBIF occurrence record by key.
+ * @module mcp-server/tools/definitions/gbif-get-occurrence
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const gbifGetOccurrence: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    occurrenceKey: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    key: z.ZodOptional<z.ZodNumber>;
+    datasetKey: z.ZodOptional<z.ZodString>;
+    taxonKey: z.ZodOptional<z.ZodNumber>;
+    scientificName: z.ZodOptional<z.ZodString>;
+    canonicalName: z.ZodOptional<z.ZodString>;
+    kingdom: z.ZodOptional<z.ZodString>;
+    phylum: z.ZodOptional<z.ZodString>;
+    order: z.ZodOptional<z.ZodString>;
+    family: z.ZodOptional<z.ZodString>;
+    genus: z.ZodOptional<z.ZodString>;
+    species: z.ZodOptional<z.ZodString>;
+    taxonRank: z.ZodOptional<z.ZodString>;
+    decimalLatitude: z.ZodOptional<z.ZodNumber>;
+    decimalLongitude: z.ZodOptional<z.ZodNumber>;
+    coordinateUncertaintyInMeters: z.ZodOptional<z.ZodNumber>;
+    continent: z.ZodOptional<z.ZodString>;
+    country: z.ZodOptional<z.ZodString>;
+    countryCode: z.ZodOptional<z.ZodString>;
+    stateProvince: z.ZodOptional<z.ZodString>;
+    locality: z.ZodOptional<z.ZodString>;
+    publishingCountry: z.ZodOptional<z.ZodString>;
+    eventDate: z.ZodOptional<z.ZodString>;
+    year: z.ZodOptional<z.ZodNumber>;
+    month: z.ZodOptional<z.ZodNumber>;
+    day: z.ZodOptional<z.ZodNumber>;
+    basisOfRecord: z.ZodOptional<z.ZodString>;
+    institutionCode: z.ZodOptional<z.ZodString>;
+    collectionCode: z.ZodOptional<z.ZodString>;
+    catalogNumber: z.ZodOptional<z.ZodString>;
+    recordedBy: z.ZodOptional<z.ZodString>;
+    identifiedBy: z.ZodOptional<z.ZodString>;
+    individualCount: z.ZodOptional<z.ZodNumber>;
+    sex: z.ZodOptional<z.ZodString>;
+    lifeStage: z.ZodOptional<z.ZodString>;
+    issues: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    media: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodOptional<z.ZodString>;
+        format: z.ZodOptional<z.ZodString>;
+        identifier: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        license: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The occurrenceKey does not exist in GBIF.";
+    readonly recovery: "Use gbif_search_occurrences to find valid occurrence keys.";
+}]>;
+//# sourceMappingURL=gbif-get-occurrence.tool.d.ts.map

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

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