@pipeworx/mcp-ecb 0.1.4 → 0.1.6

package/README.md

@@ -2,7 +2,7 @@
 
 European Central Bank Data Portal MCP — exchange rates, interest rates, monetary aggregates, HICP, bank lending. No auth.
 
-Part of [Pipeworx](https://pipeworx.io) — an MCP gateway connecting AI agents to 1855+ live data sources. This is an independent, unofficial integration — not affiliated with, endorsed by, or published by the upstream provider.
+Part of [Pipeworx](https://pipeworx.io) — an MCP gateway connecting AI agents to 1881+ live data sources. This is an independent, unofficial integration — not affiliated with, endorsed by, or published by the upstream provider.
 
 ## Tools
 
@@ -71,7 +71,7 @@ directly, instead of just this one's:
 }
 ```
 
-Both URLs reach the same gateway and the same 1855+ data sources. The
+Both URLs reach the same gateway and the same 1881+ 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-ecb",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "ECB Data Portal MCP — European Central Bank statistical data",
   "type": "module",
   "main": "src/index.ts",
@@ -26,7 +26,7 @@
     "@cloudflare/workers-types": "^4.20260405.1"
   },
   "pipeworx": {
-    "sourceHash": "v1-ab883f34ae882027b585171d95c9b8c5f3467180a89e01691b2894af4f901431",
-    "sourceCommit": "5749f83c0ea115fab4c0c0ef04b66b05f2507d67"
+    "sourceHash": "v1-0c919aa84baead00fcec6845dd177b1997a602cf9d00824ea0d26f48a1c787b2",
+    "sourceCommit": "24e32b525f9c0b2fd7d94b519b08abb108cc11cd"
   }
 }

package/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.pipeworx-io/ecb",
   "title": "Ecb",
   "description": "ECB Data Portal MCP — European Central Bank statistical data",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "websiteUrl": "https://pipeworx.io/packs/ecb",
   "repository": {
     "url": "https://github.com/pipeworx-io/mcp-ecb",

package/src/index.ts

@@ -295,12 +295,28 @@ async function httpErrorMessage(res: Response, name: string): Promise<string> {
   // internal-host-class.ts; no-op for every third-party upstream, which is why
   // this touches 481 packs' error text and changes none of it.
   return markInternalOrigin(
-    `${name}: ${res.status}${detailSuffix(await readDetail(res))}`,
+    `${name}: ${res.status}${detailSuffix(await readDetail(res))}${responseHints(res)}`,
     res.url,
     res.status,
   );
 }
 
+/**
+ * Facts about a FAILED response that live in its headers, not its body, appended
+ * so the gateway's classifier (which only ever sees this string) can tell a limit
+ * from a wall from a refusal (fleet #3477). Both are standard, both are absent on
+ * almost every response, and neither is invented: `Retry-After` is the server
+ * saying "come back later" (the one thing that makes a 403 a throttle), and
+ * Cloudflare marks a bot challenge with `cf-mitigated: challenge`.
+ */
+function responseHints(res: Response): string {
+  const hints: string[] = [];
+  const retryAfter = res.headers.get('retry-after');
+  if (retryAfter) hints.push(`retry-after: ${retryAfter.slice(0, 40)}`);
+  if ((res.headers.get('cf-mitigated') ?? '').toLowerCase() === 'challenge') hints.push('Cloudflare bot challenge (cf-mitigated: challenge)');
+  return hints.length ? ` (${hints.join('; ')})` : '';
+}
+
 /**
  * Just the upstream's own explanation — no name, no status.
  *
@@ -1161,8 +1177,30 @@ async function hicpInflation(args: Record<string, unknown>) {
   });
 }
 
+/**
+ * An ECB Data Portal series key is written FLOW.dim.dim..., e.g.
+ * MIR.M.IT.B.A2C.A.R.A.2250.EUR.P, so callers hand the whole string over as
+ * flow_ref, or repeat the flow id at the head of key (fleet #3669). The ECB has
+ * no series whose first dimension equals its own flow id (the first dimension
+ * is FREQ), so stripping that prefix cannot change the meaning of a well-formed
+ * call; it only turns a guaranteed 404 into the series the caller named.
+ */
+function splitFlowPrefixedKey(flow: string, key: string): { flow: string; key: string } {
+  const flowDot = flow.indexOf('.');
+  if (flowDot > 0) {
+    // flow_ref carries the whole key ("MIR.M.IT...."). An explicit key that is
+    // not the same remainder wins nothing - the dotted flow_ref is the series.
+    return { flow: flow.slice(0, flowDot), key: flow.slice(flowDot + 1) };
+  }
+  if (key.startsWith(flow + '.')) return { flow, key: key.slice(flow.length + 1) };
+  return { flow, key };
+}
+
 async function getData(args: Record<string, unknown>) {
-  return fetchData(reqStr(args, 'flow_ref', '"EXR"'), reqStr(args, 'key', '"D.USD.EUR.SP00.A"'), {
+  const flowArg = reqStr(args, 'flow_ref', '"EXR"').trim();
+  const keyArg = flowArg.includes('.') && args.key == null ? '' : reqStr(args, 'key', '"D.USD.EUR.SP00.A"').trim();
+  const split = splitFlowPrefixedKey(flowArg, keyArg);
+  return fetchData(split.flow, split.key, {
     start_period: args.start_period as string | undefined,
     end_period: args.end_period as string | undefined,
     last_n: args.last_n as number | undefined,

package/src/server.ts

@@ -10,7 +10,7 @@ import pack from './index.js';
 
 
 const server = new Server(
-  { name: '@pipeworx/mcp-ecb', version: '0.1.4' },
+  { name: '@pipeworx/mcp-ecb', version: '0.1.6' },
   { capabilities: { tools: {} } },
 );