@littlebearapps/australian-history-mcp 0.6.0

package/dist/tools/datagovau_search.d.ts

@@ -0,0 +1,58 @@
+/**
+ * data.gov.au Search Tool - Search Australia's national open data portal
+ */
+import type { MCPToolResponse } from '../types.js';
+export declare const dataGovAUSearchSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            organization: {
+                type: string;
+                description: string;
+            };
+            format: {
+                type: string;
+                description: string;
+            };
+            tags: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            sort: {
+                type: string;
+                description: string;
+                enum: string[];
+            };
+            limit: {
+                type: string;
+                description: string;
+                default: number;
+            };
+            offset: {
+                type: string;
+                description: string;
+                default: number;
+            };
+        };
+        required: never[];
+    };
+};
+export declare function executeDataGovAUSearch(input: {
+    query?: string;
+    organization?: string;
+    format?: string;
+    tags?: string[];
+    sort?: string;
+    limit?: number;
+    offset?: number;
+}): Promise<MCPToolResponse>;
+//# sourceMappingURL=datagovau_search.d.ts.map

package/dist/tools/datagovau_search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datagovau_search.d.ts","sourceRoot":"","sources":["../../src/tools/datagovau_search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAyB,MAAM,aAAa,CAAC;AAE1E,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwDjC,CAAC;AAEF,wBAAsB,sBAAsB,CAAC,KAAK,EAAE;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,eAAe,CAAC,CAkD3B"}

package/dist/tools/datagovau_search.js

@@ -0,0 +1,112 @@
+/**
+ * data.gov.au Search Tool - Search Australia's national open data portal
+ */
+import { dataGovAUClient } from '../clients/datagovau_client.js';
+export const dataGovAUSearchSchema = {
+    name: 'datagovau_search',
+    description: `Search data.gov.au for Australian government datasets.
+
+Use this to find:
+- Open data from federal, state, and local government
+- Statistical datasets from ABS
+- Geographic and spatial data
+- Environmental and climate data
+- Health, education, and transport datasets
+
+data.gov.au aggregates 85,000+ datasets from 800+ government organisations.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'Search keywords (e.g., "heritage victoria", "census population")',
+            },
+            organization: {
+                type: 'string',
+                description: 'Filter by organisation slug (e.g., "abs", "bom", "geoscience-australia")',
+            },
+            format: {
+                type: 'string',
+                description: 'Filter by resource format (e.g., "CSV", "JSON", "GeoJSON", "SHP")',
+            },
+            tags: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Filter by tags (e.g., ["environment", "water"])',
+            },
+            sort: {
+                type: 'string',
+                description: 'Sort order (e.g., "metadata_modified desc", "relevance")',
+                enum: [
+                    'relevance',
+                    'metadata_modified desc',
+                    'metadata_modified asc',
+                    'title asc',
+                    'title desc',
+                ],
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum results to return (1-100)',
+                default: 20,
+            },
+            offset: {
+                type: 'number',
+                description: 'Number of results to skip (for pagination)',
+                default: 0,
+            },
+        },
+        required: [],
+    },
+};
+export async function executeDataGovAUSearch(input) {
+    try {
+        // Allow empty searches (returns recent datasets)
+        const params = {
+            query: input.query,
+            organization: input.organization,
+            format: input.format,
+            tags: input.tags,
+            sort: input.sort,
+            limit: Math.min(input.limit ?? 20, 100),
+            offset: input.offset ?? 0,
+        };
+        const result = await dataGovAUClient.search(params);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        source: 'datagovau',
+                        totalResults: result.count,
+                        returned: result.datasets.length,
+                        offset: input.offset ?? 0,
+                        datasets: result.datasets.map(d => ({
+                            id: d.id,
+                            name: d.name,
+                            title: d.title,
+                            description: d.notes?.substring(0, 300),
+                            organization: d.organization?.title,
+                            resourceCount: d.resources.length,
+                            formats: [...new Set(d.resources.map(r => r.format))],
+                            tags: d.tags.slice(0, 10),
+                            license: d.licenseTitle || d.licenseId,
+                            modified: d.metadataModified,
+                            url: `https://data.gov.au/dataset/${d.name}`,
+                        })),
+                    }, null, 2),
+                }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: error instanceof Error ? error.message : 'Unknown error',
+                    }),
+                }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=datagovau_search.js.map

package/dist/tools/datagovau_search.js.map

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

package/dist/tools/harvest.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Harvest Tools - Bulk download records from PROV, Trove, and data.gov.au
+ */
+import type { MCPToolResponse } from '../types.js';
+export declare const provHarvestSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            series: {
+                type: string;
+                description: string;
+            };
+            agency: {
+                type: string;
+                description: string;
+            };
+            recordForm: {
+                type: string;
+                description: string;
+                enum: string[];
+            };
+            dateFrom: {
+                type: string;
+                description: string;
+            };
+            dateTo: {
+                type: string;
+                description: string;
+            };
+            digitisedOnly: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+            maxRecords: {
+                type: string;
+                description: string;
+                default: number;
+            };
+            startFrom: {
+                type: string;
+                description: string;
+                default: number;
+            };
+        };
+        required: never[];
+    };
+};
+export declare function executePROVHarvest(input: {
+    query?: string;
+    series?: string;
+    agency?: string;
+    recordForm?: string;
+    dateFrom?: string;
+    dateTo?: string;
+    digitisedOnly?: boolean;
+    maxRecords?: number;
+    startFrom?: number;
+}): Promise<MCPToolResponse>;
+export declare const troveHarvestSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            category: {
+                type: string;
+                description: string;
+                enum: string[];
+                default: string;
+            };
+            state: {
+                type: string;
+                description: string;
+                enum: string[];
+            };
+            dateFrom: {
+                type: string;
+                description: string;
+            };
+            dateTo: {
+                type: string;
+                description: string;
+            };
+            format: {
+                type: string;
+                description: string;
+            };
+            maxRecords: {
+                type: string;
+                description: string;
+                default: number;
+            };
+            cursor: {
+                type: string;
+                description: string;
+            };
+            includeFullText: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function executeTroveHarvest(input: {
+    query: string;
+    category?: string;
+    state?: string;
+    dateFrom?: string;
+    dateTo?: string;
+    format?: string;
+    maxRecords?: number;
+    cursor?: string;
+    includeFullText?: boolean;
+}): Promise<MCPToolResponse>;
+export declare const dataGovAUHarvestSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            organization: {
+                type: string;
+                description: string;
+            };
+            format: {
+                type: string;
+                description: string;
+            };
+            tags: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            maxRecords: {
+                type: string;
+                description: string;
+                default: number;
+            };
+            startFrom: {
+                type: string;
+                description: string;
+                default: number;
+            };
+        };
+        required: never[];
+    };
+};
+export declare function executeDataGovAUHarvest(input: {
+    query?: string;
+    organization?: string;
+    format?: string;
+    tags?: string[];
+    maxRecords?: number;
+    startFrom?: number;
+}): Promise<MCPToolResponse>;
+//# sourceMappingURL=harvest.d.ts.map

package/dist/tools/harvest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harvest.d.ts","sourceRoot":"","sources":["../../src/tools/harvest.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,eAAe,EAA6B,MAAM,aAAa,CAAC;AAM9E,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmE7B,CAAC;AAEF,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,eAAe,CAAC,CAsF3B;AAMD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0D9B,CAAC;AAEF,wBAAsB,mBAAmB,CAAC,KAAK,EAAE;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,GAAG,OAAO,CAAC,eAAe,CAAC,CAmG3B;AAMD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2ClC,CAAC;AAEF,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,eAAe,CAAC,CAuE3B"}