@coldiq/mcp 5.4.8 → 5.4.9

package/dist/tools/call-endpoint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"call-endpoint.d.ts","sourceRoot":"","sources":["../../src/tools/call-endpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,gBAAgB,kBAAkB,CAAA;AAE/C,eAAO,MAAM,uBAAuB,QAKgB,CAAA;AAEpD,eAAO,MAAM,kBAAkB;;;;;;;;;;;CAS9B,CAAA;AAED,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;GASvE"}
+{"version":3,"file":"call-endpoint.d.ts","sourceRoot":"","sources":["../../src/tools/call-endpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,eAAO,MAAM,gBAAgB,kBAAkB,CAAA;AAE/C,eAAO,MAAM,uBAAuB,QAKgB,CAAA;AAEpD,eAAO,MAAM,kBAAkB;;;;;;;;;;;CAS9B,CAAA;AAED,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;GAavE"}

package/dist/tools/call-endpoint.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { callApi } from '../client.js';
+import { upstreamMessage } from '../upstream-message.js';
 export const callEndpointName = 'call_endpoint';
 export const callEndpointDescription = 'Call any ColdIQ marketplace endpoint directly with provider-native parameters — the generic invoke for ' +
     'providers/capabilities without a dedicated tool. Get the `api`, `path`, and required params from ' +
@@ -19,8 +20,12 @@ export const callEndpointSchema = {
 export async function callEndpointHandler(input) {
     const res = await callApi('POST', '/endpoints/use', { api: input.api, path: input.path, method: input.method, params: input.params });
     if (!res.ok) {
+        const message = upstreamMessage(res.data);
         return {
-            content: [{ type: 'text', text: JSON.stringify({ error: 'Endpoint call failed', status: res.status, data: res.data }) }],
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ error: 'Endpoint call failed', ...(message ? { message } : {}), status: res.status, data: res.data }),
+                }],
             isError: true,
         };
     }

package/dist/tools/call-endpoint.js.map

@@ -1 +1 @@
-{"version":3,"file":"call-endpoint.js","sourceRoot":"","sources":["../../src/tools/call-endpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,MAAM,CAAC,MAAM,gBAAgB,GAAG,eAAe,CAAA;AAE/C,MAAM,CAAC,MAAM,uBAAuB,GAClC,yGAAyG;IACzG,mGAAmG;IACnG,6FAA6F;IAC7F,0GAA0G;IAC1G,kDAAkD,CAAA;AAEpD,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2EAA2E,CAAC;IACrG,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gFAAgF,CAAC;IAC3G,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;SACjE,QAAQ,CAAC,0FAA0F,CAAC;IACvG,MAAM,EAAE,CAAC;SACN,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;SAC/B,QAAQ,EAAE;SACV,QAAQ,CAAC,qHAAqH,CAAC;CACnI,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAA8B;IACtE,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,gBAAgB,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;IACrI,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,sBAAsB,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YACjI,OAAO,EAAE,IAAI;SACd,CAAA;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAA;AACjF,CAAC"}
+{"version":3,"file":"call-endpoint.js","sourceRoot":"","sources":["../../src/tools/call-endpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAExD,MAAM,CAAC,MAAM,gBAAgB,GAAG,eAAe,CAAA;AAE/C,MAAM,CAAC,MAAM,uBAAuB,GAClC,yGAAyG;IACzG,mGAAmG;IACnG,6FAA6F;IAC7F,0GAA0G;IAC1G,kDAAkD,CAAA;AAEpD,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2EAA2E,CAAC;IACrG,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gFAAgF,CAAC;IAC3G,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;SACjE,QAAQ,CAAC,0FAA0F,CAAC;IACvG,MAAM,EAAE,CAAC;SACN,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;SAC/B,QAAQ,EAAE;SACV,QAAQ,CAAC,qHAAqH,CAAC;CACnI,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAA8B;IACtE,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,gBAAgB,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;IACrI,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACzC,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,sBAAsB,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;iBAC7H,CAAC;YACF,OAAO,EAAE,IAAI;SACd,CAAA;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAA;AACjF,CAAC"}

package/dist/tools/get-endpoint-details.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-endpoint-details.d.ts","sourceRoot":"","sources":["../../src/tools/get-endpoint-details.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,sBAAsB,yBAAyB,CAAA;AAE5D,eAAO,MAAM,6BAA6B,QAGV,CAAA;AAEhC,eAAO,MAAM,wBAAwB;;;;;;;;;;CAKpC,CAAA;AAED,wBAAsB,yBAAyB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;GAS7E"}
+{"version":3,"file":"get-endpoint-details.d.ts","sourceRoot":"","sources":["../../src/tools/get-endpoint-details.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,eAAO,MAAM,sBAAsB,yBAAyB,CAAA;AAE5D,eAAO,MAAM,6BAA6B,QAGV,CAAA;AAEhC,eAAO,MAAM,wBAAwB;;;;;;;;;;CAKpC,CAAA;AAED,wBAAsB,yBAAyB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;GAkB7E"}

package/dist/tools/get-endpoint-details.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { callApi } from '../client.js';
+import { upstreamMessage } from '../upstream-message.js';
 export const getEndpointDetailsName = 'get_endpoint_details';
 export const getEndpointDetailsDescription = 'Get the real request schema, parameters, a ready-to-run request example, and price for one ColdIQ endpoint ' +
     '(from search_endpoints). Read the example before calling — it shows the exact provider-native params ' +
@@ -13,8 +14,17 @@ export const getEndpointDetailsSchema = {
 export async function getEndpointDetailsHandler(input) {
     const res = await callApi('POST', '/endpoints/details', { api: input.api, path: input.path, method: input.method });
     if (!res.ok) {
+        const message = upstreamMessage(res.data);
         return {
-            content: [{ type: 'text', text: JSON.stringify({ error: 'Endpoint not found or details unavailable', status: res.status, data: res.data }) }],
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: 'Endpoint not found or details unavailable',
+                        ...(message ? { message } : {}),
+                        status: res.status,
+                        data: res.data,
+                    }),
+                }],
             isError: true,
         };
     }

package/dist/tools/get-endpoint-details.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-endpoint-details.js","sourceRoot":"","sources":["../../src/tools/get-endpoint-details.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,MAAM,CAAC,MAAM,sBAAsB,GAAG,sBAAsB,CAAA;AAE5D,MAAM,CAAC,MAAM,6BAA6B,GACxC,6GAA6G;IAC7G,uGAAuG;IACvG,8BAA8B,CAAA;AAEhC,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oFAAoF,CAAC;IAC9G,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gFAAgF,CAAC;IAC3G,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;SACjE,QAAQ,CAAC,0FAA0F,CAAC;CACxG,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,KAA8B;IAC5E,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,oBAAoB,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;IACnH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,2CAA2C,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YACtJ,OAAO,EAAE,IAAI;SACd,CAAA;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAA;AACjF,CAAC"}
+{"version":3,"file":"get-endpoint-details.js","sourceRoot":"","sources":["../../src/tools/get-endpoint-details.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAExD,MAAM,CAAC,MAAM,sBAAsB,GAAG,sBAAsB,CAAA;AAE5D,MAAM,CAAC,MAAM,6BAA6B,GACxC,6GAA6G;IAC7G,uGAAuG;IACvG,8BAA8B,CAAA;AAEhC,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oFAAoF,CAAC;IAC9G,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gFAAgF,CAAC;IAC3G,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;SACjE,QAAQ,CAAC,0FAA0F,CAAC;CACxG,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,KAA8B;IAC5E,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,oBAAoB,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;IACnH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACzC,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,KAAK,EAAE,2CAA2C;wBAClD,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBAC/B,MAAM,EAAE,GAAG,CAAC,MAAM;wBAClB,IAAI,EAAE,GAAG,CAAC,IAAI;qBACf,CAAC;iBACH,CAAC;YACF,OAAO,EAAE,IAAI;SACd,CAAA;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAA;AACjF,CAAC"}

package/dist/upstream-message.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The message the API sent with a failure, when it has one of its own.
+ *
+ * A miss on the wrong namespace is answered with the namespace that DOES
+ * serve the path. That sentence is the difference between an agent correcting
+ * itself and an agent reporting a live feature as broken, so every tool that
+ * wraps a failure lifts it to the top level instead of leaving it nested in
+ * `data`, where a model reading the envelope can miss it.
+ */
+export declare function upstreamMessage(data: unknown): string | undefined;
+//# sourceMappingURL=upstream-message.d.ts.map

package/dist/upstream-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upstream-message.d.ts","sourceRoot":"","sources":["../src/upstream-message.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAIjE"}

package/dist/upstream-message.js

@@ -0,0 +1,16 @@
+/**
+ * The message the API sent with a failure, when it has one of its own.
+ *
+ * A miss on the wrong namespace is answered with the namespace that DOES
+ * serve the path. That sentence is the difference between an agent correcting
+ * itself and an agent reporting a live feature as broken, so every tool that
+ * wraps a failure lifts it to the top level instead of leaving it nested in
+ * `data`, where a model reading the envelope can miss it.
+ */
+export function upstreamMessage(data) {
+    if (!data || typeof data !== 'object')
+        return undefined;
+    const value = data.error;
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+//# sourceMappingURL=upstream-message.js.map

package/dist/upstream-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upstream-message.js","sourceRoot":"","sources":["../src/upstream-message.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,IAAa;IAC3C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAA;IACvD,MAAM,KAAK,GAAI,IAA4B,CAAC,KAAK,CAAA;IACjD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;AAC1E,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coldiq/mcp",
-  "version": "5.4.8",
+  "version": "5.4.9",
   "type": "module",
   "main": "dist/index.js",
   "bin": {

package/src/tools/call-endpoint.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod'
 import { callApi } from '../client.js'
+import { upstreamMessage } from '../upstream-message.js'
 
 export const callEndpointName = 'call_endpoint'
 
@@ -24,8 +25,12 @@ export const callEndpointSchema = {
 export async function callEndpointHandler(input: Record<string, unknown>) {
   const res = await callApi('POST', '/endpoints/use', { api: input.api, path: input.path, method: input.method, params: input.params })
   if (!res.ok) {
+    const message = upstreamMessage(res.data)
     return {
-      content: [{ type: 'text' as const, text: JSON.stringify({ error: 'Endpoint call failed', status: res.status, data: res.data }) }],
+      content: [{
+        type: 'text' as const,
+        text: JSON.stringify({ error: 'Endpoint call failed', ...(message ? { message } : {}), status: res.status, data: res.data }),
+      }],
       isError: true,
     }
   }

package/src/tools/get-endpoint-details.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod'
 import { callApi } from '../client.js'
+import { upstreamMessage } from '../upstream-message.js'
 
 export const getEndpointDetailsName = 'get_endpoint_details'
 
@@ -18,8 +19,17 @@ export const getEndpointDetailsSchema = {
 export async function getEndpointDetailsHandler(input: Record<string, unknown>) {
   const res = await callApi('POST', '/endpoints/details', { api: input.api, path: input.path, method: input.method })
   if (!res.ok) {
+    const message = upstreamMessage(res.data)
     return {
-      content: [{ type: 'text' as const, text: JSON.stringify({ error: 'Endpoint not found or details unavailable', status: res.status, data: res.data }) }],
+      content: [{
+        type: 'text' as const,
+        text: JSON.stringify({
+          error: 'Endpoint not found or details unavailable',
+          ...(message ? { message } : {}),
+          status: res.status,
+          data: res.data,
+        }),
+      }],
       isError: true,
     }
   }

package/src/upstream-message.ts

@@ -0,0 +1,14 @@
+/**
+ * The message the API sent with a failure, when it has one of its own.
+ *
+ * A miss on the wrong namespace is answered with the namespace that DOES
+ * serve the path. That sentence is the difference between an agent correcting
+ * itself and an agent reporting a live feature as broken, so every tool that
+ * wraps a failure lifts it to the top level instead of leaving it nested in
+ * `data`, where a model reading the envelope can miss it.
+ */
+export function upstreamMessage(data: unknown): string | undefined {
+  if (!data || typeof data !== 'object') return undefined
+  const value = (data as { error?: unknown }).error
+  return typeof value === 'string' && value.length > 0 ? value : undefined
+}

package/tests/tools/call-endpoint.test.ts

@@ -54,4 +54,18 @@ describe('call_endpoint handler', () => {
       api: 'exa', path: '/exa/agent/runs', method: 'POST', params: { query: 'Research ColdIQ' },
     })
   })
+
+  it('surfaces the namespace the API suggests instead of burying it in data', async () => {
+    // This is the tool the incident agent actually called: it reached
+    // /endpoints/use with api "coldiq" for a path served by "mailboxes".
+    const body = { error: 'Endpoint not found for api=coldiq path=/mailboxes/quotes method=POST. That path exists under api="mailboxes".', code: -32004 }
+    globalThis.fetch = vi.fn(async () => new Response(JSON.stringify(body), { status: 404 })) as typeof fetch
+
+    const result = await callEndpointHandler({ api: 'coldiq', path: '/mailboxes/quotes', method: 'POST' })
+    const parsed = JSON.parse(result.content[0].text)
+
+    expect(result.isError).toBe(true)
+    expect(parsed.error).toBe('Endpoint call failed')
+    expect(parsed.message).toContain('api="mailboxes"')
+  })
 })

package/tests/tools/get-endpoint-details.test.ts

@@ -35,6 +35,30 @@ describe('get_endpoint_details handler', () => {
     expect(parsed.error).toBe('Endpoint not found or details unavailable')
   })
 
+  it('surfaces the namespace the API suggests instead of burying it in data', async () => {
+    // The API answers a wrong-namespace miss with the namespace that DOES
+    // serve the path. Swallowing that sentence is what let an agent report a
+    // live ColdIQ Mailbox surface as broken.
+    const body = { error: 'Endpoint not found for api=coldiq path=/mailboxes/quotes method=POST. That path exists under api="mailboxes".' }
+    globalThis.fetch = vi.fn(async () => new Response(JSON.stringify(body), { status: 404 })) as typeof fetch
+
+    const result = await getEndpointDetailsHandler({ api: 'coldiq', path: '/mailboxes/quotes', method: 'POST' })
+    const parsed = JSON.parse(result.content[0].text)
+
+    expect(result.isError).toBe(true)
+    expect(parsed.error).toBe('Endpoint not found or details unavailable')
+    expect(parsed.message).toContain('api="mailboxes"')
+  })
+
+  it('omits message when the failure body carries no message of its own', async () => {
+    globalThis.fetch = vi.fn(async () => new Response(JSON.stringify({ detail: 'upstream hiccup' }), { status: 502 })) as typeof fetch
+    const result = await getEndpointDetailsHandler({ api: 'limadata', path: '/nope' })
+    const parsed = JSON.parse(result.content[0].text)
+
+    expect(parsed.message).toBeUndefined()
+    expect(parsed.data).toEqual({ detail: 'upstream hiccup' })
+  })
+
   it('forwards the HTTP method for a shared endpoint path', async () => {
     let capturedBody: unknown
     globalThis.fetch = vi.fn(async (_url: string | URL | Request, opts?: RequestInit) => {