@pipeworx/mcp-datacube-sk 0.1.2 → 0.1.3

package/README.md

@@ -2,7 +2,7 @@
 
 DATAcube — Statistical Office of the Slovak Republic (data.statistics.sk).
 
-Part of [Pipeworx](https://pipeworx.io) — an MCP gateway connecting AI agents to 1683+ live data sources.
+Part of [Pipeworx](https://pipeworx.io) — an MCP gateway connecting AI agents to 1684+ live data sources.
 
 ## Tools
 
@@ -56,7 +56,7 @@ directly, instead of just this one's:
 }
 ```
 
-Both URLs reach the same gateway and the same 1683+ data sources. The
+Both URLs reach the same gateway and the same 1684+ data sources. The
 only difference is which pack's tools are listed **directly**; `ask_pipeworx`
 reaches all of them from either one.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipeworx/mcp-datacube-sk",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "DATAcube — Statistical Office of the Slovak Republic (data.statistics.sk).",
   "type": "module",
   "main": "src/index.ts",
@@ -26,7 +26,7 @@
     "@cloudflare/workers-types": "^4.20260405.1"
   },
   "pipeworx": {
-    "sourceHash": "v1-6a26ec347402055b95913e0dd78ff13b920ccdf7b2c978d52ddbc5443b52af51",
-    "sourceCommit": "56d3c46c09bb3078ffdbdbca992a93f406bcd382"
+    "sourceHash": "v1-1f5767dfe4a92bdc524970d0bd33d2502d4fd95a7ec3e33a948e5bfff971addc",
+    "sourceCommit": "a00767651388cfd017fdeac82188622721db2051"
   }
 }

package/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.pipeworx-io/datacube-sk",
   "title": "Datacube Sk",
   "description": "DATAcube — Statistical Office of the Slovak Republic (data.statistics.sk).",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "websiteUrl": "https://pipeworx.io/packs/datacube-sk",
   "repository": {
     "url": "https://github.com/pipeworx-io/mcp-datacube-sk",

package/src/index.ts

@@ -830,17 +830,61 @@ async function getData(args: Record<string, unknown>): Promise<unknown> {
     throw new Error('selections must be a non-empty array of strings (one per dimension, in dataset_dimensions order). Use dataset_dimensions to find dimension order and valid codes.');
   }
   const path = (sel as string[]).map((s) => encodeURIComponent(s.trim())).join('/');
-  return dcGet(`/dataset/${encodeURIComponent(cube)}/${path}?lang=${lang}`);
+  let out: { size?: number[]; id?: string[]; value?: unknown[] | Record<string, unknown> };
+  try {
+    out = (await dcGet(`/dataset/${encodeURIComponent(cube)}/${path}?lang=${lang}`)) as typeof out;
+  } catch (err) {
+    // DATAcube answers an unknown cube with 400 {"status_message":"Name API not
+    // foud: <cube>"} (sic). That threw as a Pipeworx defect (fleet #2496).
+    if (err instanceof DcHttpError && err.status === 400 && /not fou?n?d/i.test(err.body)) {
+      return {
+        error: 'not_found',
+        message: `DATAcube has no cube "${cube}". Call list_datasets({query: "..."}) to find the cube code.`,
+        cube,
+      };
+    }
+    throw err;
+  }
+  // A selection code the cube does not have is NOT an error upstream: DATAcube
+  // returns a normal JSON-stat dataset with that dimension's size 0 and no
+  // values — a plain success with nothing in it (fleet #2496). Say so.
+  const size = Array.isArray(out?.size) ? out.size : [];
+  const zeroDims = (out?.id ?? []).filter((_, i) => size[i] === 0);
+  const noValues = Array.isArray(out?.value) ? out.value.length === 0 : out?.value != null && Object.keys(out.value).length === 0;
+  if (zeroDims.length > 0 || noValues) {
+    return {
+      ...out,
+      empty_reason: 'no_match',
+      note:
+        `DATAcube cube "${cube}" returned no values for selections ${JSON.stringify(sel)}` +
+        `${zeroDims.length ? ` — nothing matched in dimension(s) ${zeroDims.join(', ')}` : ''}. ` +
+        `Check the codes with dataset_dimensions({cube: "${cube}"}).`,
+    };
+  }
+  return out;
 }
 
 async function dcGet(path: string): Promise<unknown> {
   const res = await pwFetch(`${BASE}${path}`, {
     headers: { Accept: 'application/json', 'User-Agent': UA },
   });
-  if (!res.ok) throw new Error(`DATAcube: ${res.status} ${await res.text().then((t) => t.slice(0, 200))}`);
+  if (!res.ok) {
+    const body = await res.text().then((t) => t.slice(0, 200));
+    throw new DcHttpError(res.status, body, `DATAcube: ${res.status} ${body}`);
+  }
   return res.json();
 }
 
+class DcHttpError extends Error {
+  readonly status: number;
+  readonly body: string;
+  constructor(status: number, body: string, message: string) {
+    super(message);
+    this.status = status;
+    this.body = body;
+  }
+}
+
 function cubeFromHref(href: string | undefined): string | undefined {
   if (!href) return undefined;
   const m = href.match(/\/dataset\/([^/?]+)/);

package/src/server.ts

@@ -9,7 +9,7 @@ import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprot
 import pack from './index.js';
 
 const server = new Server(
-  { name: '@pipeworx/mcp-datacube-sk', version: '0.1.2' },
+  { name: '@pipeworx/mcp-datacube-sk', version: '0.1.3' },
   { capabilities: { tools: {} } },
 );