@littlebearapps/australian-history-mcp 0.6.0

package/dist/tools/datagovau_browse.js

@@ -0,0 +1,297 @@
+/**
+ * data.gov.au Browse Tools - Explore organisations, groups, and tags
+ */
+import { dataGovAUClient } from '../clients/datagovau_client.js';
+// ============================================================================
+// List Organizations Tool
+// ============================================================================
+export const dataGovAUListOrganizationsSchema = {
+    name: 'datagovau_list_organizations',
+    description: `List organisations that publish data on data.gov.au.
+
+Returns 800+ government organisations including:
+- Federal agencies (ABS, BOM, Geoscience Australia)
+- State government departments
+- Local councils
+- Research institutions
+
+Use the organisation slug to filter search results.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            limit: {
+                type: 'number',
+                description: 'Maximum organisations to return (default: 50)',
+                default: 50,
+            },
+        },
+        required: [],
+    },
+};
+export async function executeDataGovAUListOrganizations(input) {
+    try {
+        const organizations = await dataGovAUClient.listOrganizations(true, input.limit ?? 50);
+        // Sort by package count descending
+        const sorted = organizations.sort((a, b) => b.packageCount - a.packageCount);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        source: 'datagovau',
+                        count: sorted.length,
+                        organizations: sorted.map(o => ({
+                            name: o.name,
+                            title: o.title,
+                            datasetCount: o.packageCount,
+                            description: o.description?.substring(0, 150),
+                        })),
+                        tip: 'Use the "name" field to filter searches with organization parameter',
+                    }, null, 2),
+                }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: error instanceof Error ? error.message : 'Unknown error',
+                    }),
+                }],
+            isError: true,
+        };
+    }
+}
+// ============================================================================
+// Get Organization Tool
+// ============================================================================
+export const dataGovAUGetOrganizationSchema = {
+    name: 'datagovau_get_organization',
+    description: `Get details about a specific organisation on data.gov.au.
+
+Returns organisation metadata and optionally their published datasets.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            organization: {
+                type: 'string',
+                description: 'Organisation ID or slug (e.g., "abs", "bom")',
+            },
+            includeDatasets: {
+                type: 'boolean',
+                description: 'Include list of datasets (default: false)',
+                default: false,
+            },
+        },
+        required: ['organization'],
+    },
+};
+export async function executeDataGovAUGetOrganization(input) {
+    try {
+        const org = await dataGovAUClient.getOrganization(input.organization, input.includeDatasets ?? false);
+        if (!org) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: `Organisation not found: ${input.organization}`,
+                        }),
+                    }],
+                isError: true,
+            };
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        source: 'datagovau',
+                        organization: {
+                            id: org.id,
+                            name: org.name,
+                            title: org.title,
+                            description: org.description,
+                            datasetCount: org.packageCount,
+                            created: org.created,
+                            url: `https://data.gov.au/organization/${org.name}`,
+                        },
+                    }, null, 2),
+                }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: error instanceof Error ? error.message : 'Unknown error',
+                    }),
+                }],
+            isError: true,
+        };
+    }
+}
+// ============================================================================
+// List Groups Tool
+// ============================================================================
+export const dataGovAUListGroupsSchema = {
+    name: 'datagovau_list_groups',
+    description: `List dataset groups (categories) on data.gov.au.
+
+Groups are thematic categories that datasets can belong to.
+Use group names to filter search results.`,
+    inputSchema: {
+        type: 'object',
+        properties: {},
+        required: [],
+    },
+};
+export async function executeDataGovAUListGroups(_input) {
+    try {
+        const groups = await dataGovAUClient.listGroups(true);
+        // Sort by package count descending
+        const sorted = groups.sort((a, b) => b.packageCount - a.packageCount);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        source: 'datagovau',
+                        count: sorted.length,
+                        groups: sorted.map(g => ({
+                            name: g.name,
+                            title: g.title,
+                            datasetCount: g.packageCount,
+                            description: g.description?.substring(0, 150),
+                        })),
+                        tip: 'Use group names in the "groups" parameter when searching',
+                    }, null, 2),
+                }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: error instanceof Error ? error.message : 'Unknown error',
+                    }),
+                }],
+            isError: true,
+        };
+    }
+}
+// ============================================================================
+// Get Group Tool
+// ============================================================================
+export const dataGovAUGetGroupSchema = {
+    name: 'datagovau_get_group',
+    description: `Get details about a specific group (category) on data.gov.au.
+
+Returns group metadata and optionally datasets in this group.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            group: {
+                type: 'string',
+                description: 'Group ID or slug',
+            },
+            includeDatasets: {
+                type: 'boolean',
+                description: 'Include list of datasets (default: false)',
+                default: false,
+            },
+        },
+        required: ['group'],
+    },
+};
+export async function executeDataGovAUGetGroup(input) {
+    try {
+        const group = await dataGovAUClient.getGroup(input.group, input.includeDatasets ?? false);
+        if (!group) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: `Group not found: ${input.group}`,
+                        }),
+                    }],
+                isError: true,
+            };
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        source: 'datagovau',
+                        group: {
+                            id: group.id,
+                            name: group.name,
+                            title: group.title,
+                            description: group.description,
+                            datasetCount: group.packageCount,
+                            url: `https://data.gov.au/group/${group.name}`,
+                        },
+                    }, null, 2),
+                }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: error instanceof Error ? error.message : 'Unknown error',
+                    }),
+                }],
+            isError: true,
+        };
+    }
+}
+// ============================================================================
+// List Tags Tool
+// ============================================================================
+export const dataGovAUListTagsSchema = {
+    name: 'datagovau_list_tags',
+    description: `List popular tags used on data.gov.au datasets.
+
+Tags help categorise and discover datasets.
+Use tags to filter search results.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'Filter tags matching this text',
+            },
+        },
+        required: [],
+    },
+};
+export async function executeDataGovAUListTags(input) {
+    try {
+        const tags = await dataGovAUClient.listTags(input.query);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        source: 'datagovau',
+                        query: input.query || null,
+                        count: tags.length,
+                        tags: tags.slice(0, 100), // Limit output
+                        tip: 'Use these tags in the "tags" parameter when searching',
+                    }, null, 2),
+                }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: error instanceof Error ? error.message : 'Unknown error',
+                    }),
+                }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=datagovau_browse.js.map

package/dist/tools/datagovau_browse.js.map

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

package/dist/tools/datagovau_dataset.d.ts

@@ -0,0 +1,79 @@
+/**
+ * data.gov.au Dataset Tools - Get dataset details, resources, and query datastore
+ */
+import type { MCPToolResponse } from '../types.js';
+export declare const dataGovAUGetDatasetSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            dataset: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function executeDataGovAUGetDataset(input: {
+    dataset: string;
+}): Promise<MCPToolResponse>;
+export declare const dataGovAUGetResourceSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            resourceId: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function executeDataGovAUGetResource(input: {
+    resourceId: string;
+}): Promise<MCPToolResponse>;
+export declare const dataGovAUDatastoreSearchSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            resourceId: {
+                type: string;
+                description: string;
+            };
+            query: {
+                type: string;
+                description: string;
+            };
+            filters: {
+                type: string;
+                description: string;
+                additionalProperties: boolean;
+            };
+            limit: {
+                type: string;
+                description: string;
+                default: number;
+            };
+            offset: {
+                type: string;
+                description: string;
+                default: number;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function executeDataGovAUDatastoreSearch(input: {
+    resourceId: string;
+    query?: string;
+    filters?: Record<string, string | string[]>;
+    limit?: number;
+    offset?: number;
+}): Promise<MCPToolResponse>;
+//# sourceMappingURL=datagovau_dataset.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"datagovau_dataset.d.ts","sourceRoot":"","sources":["../../src/tools/datagovau_dataset.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAMnD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;CAmBrC,CAAC;AAEF,wBAAsB,0BAA0B,CAAC,KAAK,EAAE;IACtD,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,eAAe,CAAC,CA2D3B;AAMD,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;CAgBtC,CAAC;AAEF,wBAAsB,2BAA2B,CAAC,KAAK,EAAE;IACvD,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,eAAe,CAAC,CAgD3B;AAMD,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqC1C,CAAC;AAEF,wBAAsB,+BAA+B,CAAC,KAAK,EAAE;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,eAAe,CAAC,CAkD3B"}

package/dist/tools/datagovau_dataset.js

@@ -0,0 +1,246 @@
+/**
+ * data.gov.au Dataset Tools - Get dataset details, resources, and query datastore
+ */
+import { dataGovAUClient } from '../clients/datagovau_client.js';
+// ============================================================================
+// Get Dataset Tool
+// ============================================================================
+export const dataGovAUGetDatasetSchema = {
+    name: 'datagovau_get_dataset',
+    description: `Get full details of a specific dataset from data.gov.au.
+
+Returns complete metadata including:
+- All resources (files, APIs) with download URLs
+- Full description and documentation
+- Organization and contact details
+- License information`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            dataset: {
+                type: 'string',
+                description: 'Dataset ID or name (e.g., "heritage-inventory" or UUID)',
+            },
+        },
+        required: ['dataset'],
+    },
+};
+export async function executeDataGovAUGetDataset(input) {
+    try {
+        const dataset = await dataGovAUClient.getDataset(input.dataset);
+        if (!dataset) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: `Dataset not found: ${input.dataset}`,
+                        }),
+                    }],
+                isError: true,
+            };
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        source: 'datagovau',
+                        dataset: {
+                            id: dataset.id,
+                            name: dataset.name,
+                            title: dataset.title,
+                            description: dataset.notes,
+                            organization: dataset.organization,
+                            author: dataset.author,
+                            maintainer: dataset.maintainer,
+                            license: dataset.licenseTitle || dataset.licenseId,
+                            created: dataset.metadataCreated,
+                            modified: dataset.metadataModified,
+                            tags: dataset.tags,
+                            url: `https://data.gov.au/dataset/${dataset.name}`,
+                            resources: dataset.resources.map(r => ({
+                                id: r.id,
+                                name: r.name,
+                                description: r.description?.substring(0, 200),
+                                format: r.format,
+                                url: r.url,
+                                size: r.size,
+                                lastModified: r.lastModified,
+                                datastoreEnabled: r.datastoreActive,
+                            })),
+                        },
+                    }, null, 2),
+                }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: error instanceof Error ? error.message : 'Unknown error',
+                    }),
+                }],
+            isError: true,
+        };
+    }
+}
+// ============================================================================
+// Get Resource Tool
+// ============================================================================
+export const dataGovAUGetResourceSchema = {
+    name: 'datagovau_get_resource',
+    description: `Get details of a specific resource (file or API) from data.gov.au.
+
+Resources are the actual data files within a dataset - CSV, JSON, GeoJSON, APIs, etc.
+Use this to get the download URL and check if datastore querying is available.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            resourceId: {
+                type: 'string',
+                description: 'Resource ID (UUID)',
+            },
+        },
+        required: ['resourceId'],
+    },
+};
+export async function executeDataGovAUGetResource(input) {
+    try {
+        const resource = await dataGovAUClient.getResource(input.resourceId);
+        if (!resource) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: `Resource not found: ${input.resourceId}`,
+                        }),
+                    }],
+                isError: true,
+            };
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        source: 'datagovau',
+                        resource: {
+                            id: resource.id,
+                            name: resource.name,
+                            description: resource.description,
+                            format: resource.format,
+                            url: resource.url,
+                            size: resource.size,
+                            lastModified: resource.lastModified,
+                            datastoreEnabled: resource.datastoreActive,
+                            tip: resource.datastoreActive
+                                ? 'Use datagovau_datastore_search to query this resource directly'
+                                : 'Download the file from the URL to access the data',
+                        },
+                    }, null, 2),
+                }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: error instanceof Error ? error.message : 'Unknown error',
+                    }),
+                }],
+            isError: true,
+        };
+    }
+}
+// ============================================================================
+// Datastore Search Tool
+// ============================================================================
+export const dataGovAUDatastoreSearchSchema = {
+    name: 'datagovau_datastore_search',
+    description: `Query tabular data directly from a data.gov.au resource.
+
+Only works for resources with datastore enabled (typically CSV files that have been imported).
+Returns rows of data with pagination support.
+
+Note: Not all resources have datastore enabled. Use datagovau_get_resource to check.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            resourceId: {
+                type: 'string',
+                description: 'Resource ID (UUID) - must have datastore enabled',
+            },
+            query: {
+                type: 'string',
+                description: 'Full-text search query within the data',
+            },
+            filters: {
+                type: 'object',
+                description: 'Field-value filters (e.g., {"state": "VIC", "year": "2020"})',
+                additionalProperties: true,
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum rows to return (1-100)',
+                default: 20,
+            },
+            offset: {
+                type: 'number',
+                description: 'Number of rows to skip (for pagination)',
+                default: 0,
+            },
+        },
+        required: ['resourceId'],
+    },
+};
+export async function executeDataGovAUDatastoreSearch(input) {
+    try {
+        const result = await dataGovAUClient.datastoreSearch({
+            resourceId: input.resourceId,
+            query: input.query,
+            filters: input.filters,
+            limit: Math.min(input.limit ?? 20, 100),
+            offset: input.offset ?? 0,
+        });
+        if (!result) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: `Datastore not available for resource: ${input.resourceId}. The resource may not have datastore enabled or the ID is invalid.`,
+                        }),
+                    }],
+                isError: true,
+            };
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        source: 'datagovau',
+                        resourceId: result.resourceId,
+                        total: result.total,
+                        returned: result.records.length,
+                        offset: input.offset ?? 0,
+                        fields: result.fields.map(f => ({
+                            name: f.id,
+                            type: f.type,
+                        })),
+                        records: result.records,
+                    }, null, 2),
+                }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: error instanceof Error ? error.message : 'Unknown error',
+                    }),
+                }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=datagovau_dataset.js.map

package/dist/tools/datagovau_dataset.js.map

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