@pipeworx/mcp-data360 0.1.2 → 0.1.3

package/README.md

@@ -2,7 +2,7 @@
 
 World Bank Data360 MCP — the World Bank's modern unified data platform.
 
-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-data360",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "World Bank Data360 MCP — the World Bank's modern unified data platform.",
   "type": "module",
   "main": "src/index.ts",
@@ -26,7 +26,7 @@
     "@cloudflare/workers-types": "^4.20260405.1"
   },
   "pipeworx": {
-    "sourceHash": "v1-61d39d1cf7fa43ecbd2836e19c734b143647b67ff511a68979ea6f88a8a0de97",
-    "sourceCommit": "56d3c46c09bb3078ffdbdbca992a93f406bcd382"
+    "sourceHash": "v1-65667b630bb15d46ce130f4a24495fed088134e0b2301b8e8f7e71ea0734d4c1",
+    "sourceCommit": "904686a205e7659f86731df3f45eb88b9333c5a0"
   }
 }

package/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.pipeworx-io/data360",
   "title": "Data360",
   "description": "World Bank Data360 MCP — the World Bank's modern unified data platform.",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "websiteUrl": "https://pipeworx.io/packs/data360",
   "repository": {
     "url": "https://github.com/pipeworx-io/mcp-data360",

package/src/index.ts

@@ -796,7 +796,39 @@ async function callTool(name: string, args: Record<string, unknown>): Promise<un
       if (period) params.set('TIME_PERIOD', period);
       params.set('skip', String(numArg(args.skip, 0)));
       params.set('top', String(numArg(args.top, 100)));
-      return get(`/data?${params.toString()}`);
+      const res = await pwFetch(`${BASE}/data?${params.toString()}`, {
+        headers: { Accept: 'application/json', 'User-Agent': UA },
+      });
+      if (!res.ok) {
+        const text = await res.text();
+        // Data360 answers an unknown DATABASE_ID with 417 EA500001 "Data
+        // retrieval failed" -- the same body it sends on a real outage, so the
+        // body cannot tell them apart. Check the id against the database list
+        // and only call it not_found when it is genuinely absent (fleet #2497).
+        const dbId = params.get('DATABASE_ID')!;
+        const known = await databaseIds().catch(() => null);
+        if (known && !known.includes(dbId)) {
+          const near = known.find((k) => k.toLowerCase() === dbId.toLowerCase());
+          return {
+            error: 'not_found',
+            message: near
+              ? `Data360 has no database "${dbId}" -- ids are case-sensitive; did you mean "${near}"?`
+              : `Data360 has no database "${dbId}". Call data360_list_databases for valid DATABASE_IDs (e.g. "WB_WDI").`,
+            DATABASE_ID: dbId,
+          };
+        }
+        throw new Error(`Data360: ${res.status} ${text.slice(0, 200)}`);
+      }
+      const data = (await res.json()) as { count?: number; value?: unknown[] };
+      if ((data.count ?? data.value?.length ?? 0) === 0) {
+        // An unknown INDICATOR / REF_AREA pair is a 200 with zero rows, not an error.
+        return {
+          ...data,
+          empty_reason: 'no_match',
+          note: `No observations for INDICATOR "${params.get('INDICATOR')}" in ${params.get('DATABASE_ID')} for REF_AREA "${params.get('REF_AREA')}"${period ? ` in ${period}` : ''}. Check the code with data360_search_indicators (database_id: "${params.get('DATABASE_ID')}"), or drop TIME_PERIOD.`,
+        };
+      }
+      return data;
     }
 
     default:
@@ -814,10 +846,16 @@ async function searchPost(body: unknown): Promise<unknown> {
   return res.json();
 }
 
-async function get(path: string): Promise<unknown> {
-  const res = await pwFetch(`${BASE}${path}`, { headers: { Accept: 'application/json', 'User-Agent': UA } });
-  if (!res.ok) throw new Error(`Data360: ${res.status} ${await res.text().then((t) => t.slice(0, 200))}`);
-  return res.json();
+async function databaseIds(): Promise<string[]> {
+  const res = (await searchPost({
+    count: true,
+    search: '*',
+    top: 0,
+    facets: ['series_description/database_id,count:1000'],
+  })) as any;
+  const ids: Array<{ value: string }> = res?.['@search.facets']?.['series_description/database_id'] ?? [];
+  if (ids.length === 0) throw new Error('Data360 database list came back empty');
+  return ids.map((d) => d.value);
 }
 
 function reqStr(args: Record<string, unknown>, key: string, example: string): string {

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-data360', version: '0.1.2' },
+  { name: '@pipeworx/mcp-data360', version: '0.1.3' },
   { capabilities: { tools: {} } },
 );