@aborruso/ckan-mcp-server 0.4.49 → 0.4.51

package/dist/index.js

@@ -489,6 +489,24 @@ function convertDateMathForUnsupportedFields(query) {
     return `${field}:[${startIso} TO ${nowIso}]`;
   });
 }
+var EXPLICIT_BOOL_PATTERN = /\b(AND|OR|NOT)\b|[+\-!]/;
+function isPlainMultiTermQuery(query) {
+  const trimmed = query.trim();
+  if (trimmed === "*:*" || trimmed === "") return false;
+  if (FIELD_QUERY_PATTERN.test(trimmed)) return false;
+  if (EXPLICIT_BOOL_PATTERN.test(trimmed)) return false;
+  const words = trimmed.split(/\s+/).filter(Boolean);
+  return words.length > 1;
+}
+function buildOrQuery(query) {
+  return query.trim().split(/\s+/).filter(Boolean).join(" OR ");
+}
+function stripAccents(text) {
+  return text.normalize("NFD").replace(/[\u0300-\u036f]/g, "");
+}
+function hasAccents(text) {
+  return text !== stripAccents(text);
+}
 function resolveSearchQuery(serverUrl, query, parserOverride) {
   const portalSearchConfig = getPortalSearchConfig(serverUrl);
   const portalForce = portalSearchConfig.force_text_field ?? false;
@@ -761,8 +779,14 @@ ${result.notes}
 `;
       if (resource.last_modified) markdown += `- **Modified**: ${formatDate(resource.last_modified)}
 `;
-      if (resource.datastore_active !== void 0) {
-        markdown += `- **DataStore**: ${resource.datastore_active ? "\u2705 Available" : "\u274C Not available"}
+      if (resource.datastore_active === true) {
+        markdown += `- **DataStore**: \u2705 Available
+`;
+      } else if (resource.datastore_active === false) {
+        markdown += `- **DataStore**: \u274C Not available
+`;
+      } else {
+        markdown += `- **DataStore**: \u2753 Not reported by portal
 `;
       }
       markdown += "\n";
@@ -780,6 +804,12 @@ ${result.notes}
   }
   return markdown;
 };
+function resolvePageParams(page, pageSize, start, rows) {
+  if (page !== void 0) {
+    return { effectiveStart: (page - 1) * pageSize, effectiveRows: pageSize };
+  }
+  return { effectiveStart: start, effectiveRows: rows };
+}
 function registerPackageTools(server2) {
   server2.registerTool(
     "ckan_package_search",
@@ -819,6 +849,8 @@ Args:
   - fq (string): Filter query (e.g., "organization:comune-palermo")
   - rows (number): Number of results to return (default: 10, max: 1000)
   - start (number): Offset for pagination (default: 0)
+  - page (number): Page number (1-based); alias for start. Overrides start if provided.
+  - page_size (number): Results per page when using page (default: 10, max: 1000)
   - sort (string): Sort field and direction (e.g., "metadata_modified desc")
   - facet_field (array): Fields to facet on (e.g., ["organization", "tags"])
   - facet_limit (number): Max facet values per field (default: 50)
@@ -899,6 +931,8 @@ Typical workflow: ckan_package_search \u2192 ckan_package_show (get full metadat
         sort: z2.string().optional().describe("Sort field and direction (e.g., 'metadata_modified desc')"),
         facet_field: z2.array(z2.string()).optional().describe("Fields to facet on"),
         facet_limit: z2.number().int().min(1).optional().default(50).describe("Maximum facet values per field"),
+        page: z2.number().int().min(1).optional().describe("Page number (1-based); alias for start. Overrides start if provided."),
+        page_size: z2.number().int().min(1).max(1e3).optional().default(10).describe("Results per page when using page (default: 10)"),
         include_drafts: z2.boolean().optional().default(false).describe("Include draft datasets"),
         content_recent: z2.boolean().optional().default(false).describe("Use issued date with fallback to metadata_created for recent content"),
         content_recent_days: z2.number().int().min(1).optional().default(30).describe("Day window for content_recent (default 30)"),
@@ -928,10 +962,11 @@ Typical workflow: ckan_package_search \u2192 ckan_package_show (get full metadat
           query,
           params.query_parser
         );
+        const { effectiveRows, effectiveStart } = resolvePageParams(params.page, params.page_size, params.start, params.rows);
         const apiParams = {
           q: effectiveQuery,
-          rows: params.rows,
-          start: params.start,
+          rows: effectiveRows,
+          start: effectiveStart,
           include_private: params.include_drafts
         };
         if (params.fq) apiParams.fq = params.fq;
@@ -940,11 +975,29 @@ Typical workflow: ckan_package_search \u2192 ckan_package_show (get full metadat
           apiParams["facet.field"] = JSON.stringify(params.facet_field);
           apiParams["facet.limit"] = params.facet_limit;
         }
-        const result = await makeCkanRequest(
+        let result = await makeCkanRequest(
           params.server_url,
           "package_search",
           apiParams
         );
+        let accentFallbackUsed = false;
+        if (result.count === 0 && hasAccents(params.q)) {
+          const strippedQuery = stripAccents(params.q);
+          const { effectiveQuery: strippedEffective } = resolveSearchQuery(
+            params.server_url,
+            strippedQuery,
+            params.query_parser
+          );
+          const fallbackResult = await makeCkanRequest(
+            params.server_url,
+            "package_search",
+            { ...apiParams, q: strippedEffective }
+          );
+          if (fallbackResult.count > 0) {
+            result = fallbackResult;
+            accentFallbackUsed = true;
+          }
+        }
         if (params.response_format === "json" /* JSON */) {
           return {
             content: [{ type: "text", text: truncateText(JSON.stringify(result, null, 2)) }]
@@ -958,10 +1011,12 @@ ${params.content_recent ? `**Content Recent**: last ${params.content_recent_days
 ` : ""}
 ${effectiveQuery !== userQuery ? `**Effective Query**: ${effectiveQuery}
 ` : ""}
+${accentFallbackUsed ? `**Note**: Original query returned 0 results; retried with accent-stripped query "${stripAccents(params.q)}".
+` : ""}
 ${params.fq ? `**Filter**: ${params.fq}
 ` : ""}
 **Total Results**: ${result.count}
-**Showing**: ${result.results.length} results (from ${params.start})
+**Showing**: ${result.results.length} results (from ${effectiveStart})
 
 `;
         if (result.facets && Object.keys(result.facets).length > 0) {
@@ -1027,13 +1082,27 @@ Note: showing top ${sorted.length} only. Use \`response_format: json\` for full
         } else {
           markdown += `No datasets found matching your query.
 `;
+          if (isPlainMultiTermQuery(params.q)) {
+            markdown += `
+> **Tip**: Multi-term queries use AND by default (all terms must match). Try OR to broaden the search:
+`;
+            markdown += `> \`q: "${buildOrQuery(params.q)}"\`
+`;
+          }
         }
-        if (result.count > params.start + params.rows) {
-          const nextStart = params.start + params.rows;
-          markdown += `
+        if (result.count > effectiveStart + effectiveRows) {
+          if (params.page !== void 0) {
+            markdown += `
+---
+**More results available**: Use \`page: ${params.page + 1}\` to see next page.
+`;
+          } else {
+            const nextStart = effectiveStart + effectiveRows;
+            markdown += `
 ---
 **More results available**: Use \`start: ${nextStart}\` to see next page.
 `;
+          }
         }
         return {
           content: [{ type: "text", text: truncateText(addDemoFooter(markdown)) }]
@@ -1319,6 +1388,7 @@ Use this to quickly assess what files a dataset contains before deciding how to
 Args:
   - server_url (string): Base URL of CKAN server
   - id (string): Dataset ID or name
+  - format_filter (string): Filter resources by format, case-insensitive (e.g., "CSV", "json", "XLSX")
   - response_format ('markdown' | 'json'): Output format
 
 Returns:
@@ -1326,11 +1396,13 @@ Returns:
 
 Examples:
   - { server_url: "https://dati.gov.it/opendata", id: "dataset-name" }
+  - { server_url: "...", id: "dataset-name", format_filter: "CSV" }
 
 Typical workflow: ckan_package_search \u2192 ckan_list_resources (assess available files) \u2192 ckan_datastore_search (for resources with DataStore=true)`,
       inputSchema: z2.object({
         server_url: z2.string().url().describe("Base URL of the CKAN server"),
         id: z2.string().min(1).describe("Dataset ID or name"),
+        format_filter: z2.string().optional().describe("Filter resources by format, case-insensitive (e.g., 'CSV', 'json', 'XLSX')"),
         response_format: ResponseFormatSchema
       }).strict(),
       annotations: {
@@ -1348,7 +1420,8 @@ Typical workflow: ckan_package_search \u2192 ckan_list_resources (assess availab
           { id: params.id }
         );
         const resources = Array.isArray(result.resources) ? result.resources : [];
-        const summary = resources.map((r) => {
+        const formatFilter = params.format_filter?.toUpperCase();
+        const summary = resources.filter((r) => !formatFilter || (r.format || "").toUpperCase() === formatFilter).map((r) => {
           const effectiveUrl = resolveDownloadUrl(r);
           return {
             name: r.name || "Unnamed Resource",
@@ -1364,7 +1437,9 @@ Typical workflow: ckan_package_search \u2192 ckan_list_resources (assess availab
             dataset_id: result.id,
             dataset_name: result.name,
             dataset_title: result.title || result.name,
-            total_resources: summary.length,
+            total_resources: resources.length,
+            filtered_resources: summary.length,
+            format_filter: formatFilter ?? null,
             resources: summary
           };
           return {
@@ -1379,7 +1454,11 @@ Typical workflow: ckan_package_search \u2192 ckan_list_resources (assess availab
 `;
         markdown += `**Dataset**: \`${result.name}\` (\`${result.id}\`)
 `;
-        markdown += `**Total Resources**: ${summary.length}
+        markdown += `**Total Resources**: ${resources.length}`;
+        if (formatFilter) {
+          markdown += ` (showing ${summary.length} ${formatFilter})`;
+        }
+        markdown += `
 
 `;
         if (summary.length === 0) {
@@ -1426,6 +1505,65 @@ Typical workflow: ckan_package_search \u2192 ckan_list_resources (assess availab
 
 // src/tools/organization.ts
 import { z as z3 } from "zod";
+function formatOrganizationShowMarkdown(result, serverUrl) {
+  let markdown = `# Organization: ${result.title || result.name}
+
+`;
+  markdown += `**Server**: ${serverUrl}
+`;
+  markdown += `**Link**: ${getOrganizationViewUrl(serverUrl, result)}
+
+`;
+  markdown += `## Details
+
+`;
+  markdown += `- **ID**: \`${result.id}\`
+`;
+  markdown += `- **Name**: \`${result.name}\`
+`;
+  markdown += `- **Datasets**: ${result.package_count || 0}
+`;
+  markdown += `- **Created**: ${formatDate(result.created)}
+`;
+  markdown += `- **State**: ${result.state}
+
+`;
+  if (result.description) {
+    markdown += `## Description
+
+${result.description}
+
+`;
+  }
+  if (result.packages && result.packages.length > 0) {
+    const displayed = Math.min(result.packages.length, 20);
+    const totalHint = result.package_count && result.package_count !== result.packages.length ? ` \u2014 ${result.package_count} total` : "";
+    markdown += `## Datasets (showing ${displayed} of ${result.packages.length} returned${totalHint})
+
+`;
+    for (const pkg of result.packages.slice(0, 20)) {
+      markdown += `- **${pkg.title || pkg.name}** (\`${pkg.name}\`)
+`;
+    }
+    if (result.packages.length > 20) {
+      markdown += `
+... and ${result.packages.length - 20} more datasets
+`;
+    }
+    markdown += "\n";
+  }
+  if (result.users && result.users.length > 0) {
+    markdown += `## Users (${result.users.length})
+
+`;
+    for (const user of result.users) {
+      markdown += `- **${user.name}** (${user.capacity})
+`;
+    }
+    markdown += "\n";
+  }
+  return markdown;
+}
 function registerOrganizationTools(server2) {
   server2.registerTool(
     "ckan_organization_list",
@@ -1669,60 +1807,7 @@ Typical workflow: ckan_organization_show \u2192 ckan_package_show (inspect a dat
             structuredContent: result
           };
         }
-        let markdown = `# Organization: ${result.title || result.name}
-
-`;
-        markdown += `**Server**: ${params.server_url}
-`;
-        markdown += `**Link**: ${getOrganizationViewUrl(params.server_url, result)}
-
-`;
-        markdown += `## Details
-
-`;
-        markdown += `- **ID**: \`${result.id}\`
-`;
-        markdown += `- **Name**: \`${result.name}\`
-`;
-        markdown += `- **Datasets**: ${result.package_count || 0}
-`;
-        markdown += `- **Created**: ${formatDate(result.created)}
-`;
-        markdown += `- **State**: ${result.state}
-
-`;
-        if (result.description) {
-          markdown += `## Description
-
-${result.description}
-
-`;
-        }
-        if (result.packages && result.packages.length > 0) {
-          markdown += `## Datasets (${result.packages.length})
-
-`;
-          for (const pkg of result.packages.slice(0, 20)) {
-            markdown += `- **${pkg.title || pkg.name}** (\`${pkg.name}\`)
-`;
-          }
-          if (result.packages.length > 20) {
-            markdown += `
-... and ${result.packages.length - 20} more datasets
-`;
-          }
-          markdown += "\n";
-        }
-        if (result.users && result.users.length > 0) {
-          markdown += `## Users (${result.users.length})
-
-`;
-          for (const user of result.users) {
-            markdown += `- **${user.name}** (${user.capacity})
-`;
-          }
-          markdown += "\n";
-        }
+        const markdown = formatOrganizationShowMarkdown(result, params.server_url);
         return {
           content: [{ type: "text", text: truncateText(addDemoFooter(markdown)) }]
         };
@@ -1847,6 +1932,108 @@ Typical workflow: ckan_organization_search \u2192 ckan_organization_show (get de
 
 // src/tools/datastore.ts
 import { z as z4 } from "zod";
+function formatDatastoreSearchMarkdown(result, serverUrl, resourceId, offset, limit) {
+  let markdown = `# DataStore Query Results
+
+`;
+  markdown += `**Server**: ${serverUrl}
+`;
+  markdown += `**Resource ID**: \`${resourceId}\`
+`;
+  markdown += `**Total Records**: ${result.total || 0}
+`;
+  markdown += `**Returned**: ${result.records ? result.records.length : 0} records
+
+`;
+  if (result.fields && result.fields.length > 0) {
+    markdown += `## Fields
+
+`;
+    markdown += result.fields.map((f) => `- **${f.id}** (${f.type})`).join("\n") + "\n\n";
+  }
+  if (result.records && result.records.length > 0) {
+    markdown += `## Records
+
+`;
+    const fields = result.fields ? result.fields.map((f) => f.id).filter((id) => id !== "_id") : [];
+    const displayFields = fields.slice(0, 8);
+    markdown += `| ${displayFields.join(" | ")} |
+`;
+    markdown += `| ${displayFields.map(() => "---").join(" | ")} |
+`;
+    for (const record of result.records.slice(0, 50)) {
+      const values = displayFields.map((field) => {
+        const val = record[field];
+        if (val === null || val === void 0) return "-";
+        const str = String(val);
+        return str.length > 80 ? str.substring(0, 77) + "..." : str;
+      });
+      markdown += `| ${values.join(" | ")} |
+`;
+    }
+    if (result.records.length > 50) {
+      markdown += `
+... and ${result.records.length - 50} more records
+`;
+    }
+    markdown += "\n";
+  }
+  if (result.total && result.total > offset + (result.records?.length || 0)) {
+    const nextOffset = offset + limit;
+    markdown += `**More results available**: Use \`offset: ${nextOffset}\` for next page.
+`;
+  }
+  return markdown;
+}
+function formatDatastoreSqlMarkdown(result, serverUrl, sql) {
+  const records = result.records || [];
+  const fieldIds = (result.fields?.map((field) => field.id) || Object.keys(records[0] || {})).filter((id) => id !== "_id");
+  let markdown = `# DataStore SQL Results
+
+`;
+  markdown += `**Server**: ${serverUrl}
+`;
+  markdown += `**SQL**: \`${sql}\`
+`;
+  markdown += `**Returned**: ${records.length} records
+
+`;
+  if (result.fields && result.fields.length > 0) {
+    markdown += `## Fields
+
+`;
+    markdown += result.fields.map((field) => `- **${field.id}** (${field.type})`).join("\n") + "\n\n";
+  }
+  if (records.length > 0 && fieldIds.length > 0) {
+    markdown += `## Records
+
+`;
+    const displayFields = fieldIds.slice(0, 8);
+    markdown += `| ${displayFields.join(" | ")} |
+`;
+    markdown += `| ${displayFields.map(() => "---").join(" | ")} |
+`;
+    for (const record of records.slice(0, 50)) {
+      const values = displayFields.map((field) => {
+        const value = record[field];
+        if (value === null || value === void 0) return "-";
+        const text = String(value);
+        return text.length > 80 ? text.substring(0, 77) + "..." : text;
+      });
+      markdown += `| ${values.join(" | ")} |
+`;
+    }
+    if (records.length > 50) {
+      markdown += `
+... and ${records.length - 50} more records
+`;
+    }
+    markdown += "\n";
+  } else {
+    markdown += "No records returned by the SQL query.\n";
+  }
+  return markdown;
+}
 function registerDatastoreTools(server2) {
   server2.registerTool(
     "ckan_datastore_search",
@@ -1918,56 +2105,7 @@ Typical workflow: ckan_package_search \u2192 ckan_package_show (find resource_id
             content: [{ type: "text", text: truncateText(JSON.stringify(result, null, 2)) }]
           };
         }
-        let markdown = `# DataStore Query Results
-
-`;
-        markdown += `**Server**: ${params.server_url}
-`;
-        markdown += `**Resource ID**: \`${params.resource_id}\`
-`;
-        markdown += `**Total Records**: ${result.total || 0}
-`;
-        markdown += `**Returned**: ${result.records ? result.records.length : 0} records
-
-`;
-        if (result.fields && result.fields.length > 0) {
-          markdown += `## Fields
-
-`;
-          markdown += result.fields.map((f) => `- **${f.id}** (${f.type})`).join("\n") + "\n\n";
-        }
-        if (result.records && result.records.length > 0) {
-          markdown += `## Records
-
-`;
-          const fields = result.fields.map((f) => f.id);
-          const displayFields = fields.slice(0, 8);
-          markdown += `| ${displayFields.join(" | ")} |
-`;
-          markdown += `| ${displayFields.map(() => "---").join(" | ")} |
-`;
-          for (const record of result.records.slice(0, 50)) {
-            const values = displayFields.map((field) => {
-              const val = record[field];
-              if (val === null || val === void 0) return "-";
-              const str = String(val);
-              return str.length > 50 ? str.substring(0, 47) + "..." : str;
-            });
-            markdown += `| ${values.join(" | ")} |
-`;
-          }
-          if (result.records.length > 50) {
-            markdown += `
-... and ${result.records.length - 50} more records
-`;
-          }
-          markdown += "\n";
-        }
-        if (result.total && result.total > params.offset + (result.records?.length || 0)) {
-          const nextOffset = params.offset + params.limit;
-          markdown += `**More results available**: Use \`offset: ${nextOffset}\` for next page.
-`;
-        }
+        const markdown = formatDatastoreSearchMarkdown(result, params.server_url, params.resource_id, params.offset, params.limit);
         return {
           content: [{ type: "text", text: truncateText(addDemoFooter(markdown)) }]
         };
@@ -2028,52 +2166,7 @@ Typical workflow: ckan_package_show (get resource_id) \u2192 ckan_datastore_sear
             structuredContent: result
           };
         }
-        const records = result.records || [];
-        const fieldIds = result.fields?.map((field) => field.id) || Object.keys(records[0] || {});
-        let markdown = `# DataStore SQL Results
-
-`;
-        markdown += `**Server**: ${params.server_url}
-`;
-        markdown += `**SQL**: \`${params.sql}\`
-`;
-        markdown += `**Returned**: ${records.length} records
-
-`;
-        if (result.fields && result.fields.length > 0) {
-          markdown += `## Fields
-
-`;
-          markdown += result.fields.map((field) => `- **${field.id}** (${field.type})`).join("\n") + "\n\n";
-        }
-        if (records.length > 0 && fieldIds.length > 0) {
-          markdown += `## Records
-
-`;
-          const displayFields = fieldIds.slice(0, 8);
-          markdown += `| ${displayFields.join(" | ")} |
-`;
-          markdown += `| ${displayFields.map(() => "---").join(" | ")} |
-`;
-          for (const record of records.slice(0, 50)) {
-            const values = displayFields.map((field) => {
-              const value = record[field];
-              if (value === null || value === void 0) return "-";
-              const text = String(value);
-              return text.length > 50 ? text.substring(0, 47) + "..." : text;
-            });
-            markdown += `| ${values.join(" | ")} |
-`;
-          }
-          if (records.length > 50) {
-            markdown += `
-... and ${records.length - 50} more records
-`;
-          }
-          markdown += "\n";
-        } else {
-          markdown += "No records returned by the SQL query.\n";
-        }
+        const markdown = formatDatastoreSqlMarkdown(result, params.server_url, params.sql);
         return {
           content: [{ type: "text", text: truncateText(addDemoFooter(markdown)) }]
         };
@@ -2092,6 +2185,16 @@ Typical workflow: ckan_package_show (get resource_id) \u2192 ckan_datastore_sear
 
 // src/tools/status.ts
 import { z as z5 } from "zod";
+function formatStatusMarkdown(result, serverUrl) {
+  return `# CKAN Server Status
+
+**Server**: ${serverUrl}
+**Status**: \u2705 Online
+**CKAN Version**: ${result.ckan_version || "Unknown"}
+**Site Title**: ${result.site_title || "N/A"}
+**Site URL**: ${result.site_url || "N/A"}
+`;
+}
 function registerStatusTools(server2) {
   server2.registerTool(
     "ckan_status_show",
@@ -2125,14 +2228,7 @@ Typical workflow: ckan_status_show (verify server is up) \u2192 ckan_package_sea
           "status_show",
           {}
         );
-        const markdown = `# CKAN Server Status
-
-**Server**: ${params.server_url}
-**Status**: \u2705 Online
-**CKAN Version**: ${result.ckan_version || "Unknown"}
-**Site Title**: ${result.site_title || "N/A"}
-**Site URL**: ${result.site_url || "N/A"}
-`;
+        const markdown = formatStatusMarkdown(result, params.server_url);
         return {
           content: [{ type: "text", text: addDemoFooter(markdown) }],
           structuredContent: result
@@ -2154,7 +2250,10 @@ ${error instanceof Error ? error.message : String(error)}`
 // src/tools/tag.ts
 import { z as z6 } from "zod";
 function normalizeTagFacets(result) {
-  const searchItems = result?.search_facets?.tags?.items;
+  const r = result;
+  const searchFacets = r?.search_facets;
+  const tagsGroup = searchFacets?.tags;
+  const searchItems = tagsGroup?.items;
   if (Array.isArray(searchItems)) {
     return searchItems.map((item) => ({
       name: item?.name || item?.display_name || String(item),
@@ -2162,7 +2261,7 @@ function normalizeTagFacets(result) {
       display_name: item?.display_name
     }));
   }
-  const facets = result?.facets?.tags;
+  const facets = r?.facets?.tags;
   if (Array.isArray(facets)) {
     if (facets.length > 0 && typeof facets[0] === "object") {
       return facets.map((item) => ({
@@ -2292,16 +2391,67 @@ function getGroupViewUrl(serverUrl, group) {
   const cleanServerUrl = serverUrl.replace(/\/$/, "");
   return `${cleanServerUrl}/group/${group.name}`;
 }
+function formatGroupShowMarkdown(result, serverUrl) {
+  let markdown = `# Group: ${result.title || result.name}
+
+`;
+  markdown += `**Server**: ${serverUrl}
+`;
+  markdown += `**Link**: ${getGroupViewUrl(serverUrl, result)}
+
+`;
+  markdown += `## Details
+
+`;
+  markdown += `- **ID**: \`${result.id}\`
+`;
+  markdown += `- **Name**: \`${result.name}\`
+`;
+  markdown += `- **Datasets**: ${result.package_count || 0}
+`;
+  markdown += `- **Created**: ${formatDate(result.created)}
+`;
+  markdown += `- **State**: ${result.state}
+
+`;
+  if (result.description) {
+    markdown += `## Description
+
+${result.description}
+
+`;
+  }
+  if (result.packages && result.packages.length > 0) {
+    const displayed = Math.min(result.packages.length, 20);
+    const totalHint = result.package_count && result.package_count !== result.packages.length ? ` \u2014 ${result.package_count} total` : "";
+    markdown += `## Datasets (showing ${displayed} of ${result.packages.length} returned${totalHint})
+
+`;
+    for (const pkg of result.packages.slice(0, 20)) {
+      markdown += `- **${pkg.title || pkg.name}** (\`${pkg.name}\`)
+`;
+    }
+    if (result.packages.length > 20) {
+      markdown += `
+... and ${result.packages.length - 20} more datasets
+`;
+    }
+    markdown += "\n";
+  }
+  return markdown;
+}
 function normalizeGroupFacets(result) {
-  const items = result?.search_facets?.groups?.items;
-  if (Array.isArray(items)) {
-    return items.map((item) => ({
+  const r = result;
+  const items = r?.search_facets?.groups;
+  const itemsArr = items?.items;
+  if (Array.isArray(itemsArr)) {
+    return itemsArr.map((item) => ({
       name: item?.name || item?.display_name || String(item),
       display_name: item?.display_name,
       count: typeof item?.count === "number" ? item.count : 0
     }));
   }
-  const facets = result?.facets?.groups;
+  const facets = r?.facets?.groups;
   if (Array.isArray(facets)) {
     if (facets.length > 0 && typeof facets[0] === "object") {
       return facets.map((item) => ({
@@ -2492,50 +2642,7 @@ Typical workflow: ckan_group_show \u2192 ckan_package_show (inspect a dataset) \
             structuredContent: result
           };
         }
-        let markdown = `# Group: ${result.title || result.name}
-
-`;
-        markdown += `**Server**: ${params.server_url}
-`;
-        markdown += `**Link**: ${getGroupViewUrl(params.server_url, result)}
-
-`;
-        markdown += `## Details
-
-`;
-        markdown += `- **ID**: \`${result.id}\`
-`;
-        markdown += `- **Name**: \`${result.name}\`
-`;
-        markdown += `- **Datasets**: ${result.package_count || 0}
-`;
-        markdown += `- **Created**: ${formatDate(result.created)}
-`;
-        markdown += `- **State**: ${result.state}
-
-`;
-        if (result.description) {
-          markdown += `## Description
-
-${result.description}
-
-`;
-        }
-        if (result.packages && result.packages.length > 0) {
-          markdown += `## Datasets (${result.packages.length})
-
-`;
-          for (const pkg of result.packages.slice(0, 20)) {
-            markdown += `- **${pkg.title || pkg.name}** (\`${pkg.name}\`)
-`;
-          }
-          if (result.packages.length > 20) {
-            markdown += `
-... and ${result.packages.length - 20} more datasets
-`;
-          }
-          markdown += "\n";
-        }
+        const markdown = formatGroupShowMarkdown(result, params.server_url);
         return {
           content: [{ type: "text", text: truncateText(addDemoFooter(markdown)) }]
         };
@@ -3089,8 +3196,9 @@ function metricAvailability(section, availabilityKey, statusKey) {
   return void 0;
 }
 function normalizeQualityData(data) {
-  const mqaData = data?.mqa ?? data;
-  const breakdown = data?.breakdown;
+  const d = data;
+  const mqaData = d?.mqa ?? data;
+  const breakdown = d?.breakdown;
   const resultEntry = mqaData?.result?.results?.[0];
   if (!resultEntry || typeof resultEntry !== "object") {
     return { ...data, breakdown };
@@ -3896,7 +4004,7 @@ var registerAllPrompts = (server2) => {
 function createServer() {
   return new McpServer({
     name: "ckan-mcp-server",
-    version: "0.4.49"
+    version: "0.4.50"
   });
 }
 function registerAll(server2) {