scorecard-ai-mcp 2.5.0 → 2.6.0

package/docs-search-tool.js

@@ -11,7 +11,7 @@ exports.metadata = {
 };
 exports.tool = {
     name: 'search_docs',
-    description: 'Search for documentation for how to use the client to interact with the API.\nThe tool will return an array of Markdown-formatted documentation pages.',
+    description: 'Search for documentation for how to use the client to interact with the API.',
     inputSchema: {
         type: 'object',
         properties: {
@@ -22,7 +22,12 @@ exports.tool = {
             language: {
                 type: 'string',
                 description: 'The language for the SDK to search for.',
-                enum: ['http', 'python', 'go', 'typescript', 'terraform', 'ruby', 'java', 'kotlin'],
+                enum: ['http', 'python', 'go', 'typescript', 'javascript', 'terraform', 'ruby', 'java', 'kotlin'],
+            },
+            detail: {
+                type: 'string',
+                description: 'The amount of detail to return.',
+                enum: ['default', 'verbose'],
             },
         },
         required: ['query', 'language'],
@@ -36,6 +41,9 @@ const handler = async (_, args) => {
     const body = args;
     const query = new URLSearchParams(body).toString();
     const result = await fetch(`${docsSearchURL}?${query}`);
+    if (!result.ok) {
+        throw new Error(`${result.status}: ${result.statusText} when using doc search tool. Details: ${await result.text()}`);
+    }
     return (0, types_1.asTextContentResult)(await result.json());
 };
 exports.handler = handler;

package/docs-search-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"docs-search-tool.js","sourceRoot":"","sources":["src/docs-search-tool.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,4CAA8D;AAIjD,QAAA,QAAQ,GAAa;IAChC,QAAQ,EAAE,KAAK;IACf,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,KAAK;CAClB,CAAC;AAEW,QAAA,IAAI,GAAS;IACxB,IAAI,EAAE,aAAa;IACnB,WAAW,EACT,wJAAwJ;IAC1J,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0BAA0B;aACxC;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yCAAyC;gBACtD,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;aACpF;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC;KAChC;IACD,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEF,MAAM,aAAa,GACjB,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,8DAA8D,CAAC;AAE5F,MAAM,OAAO,GAAG,KAAK,EAAE,CAAU,EAAE,IAAyC,EAAE,EAAE;IACrF,MAAM,IAAI,GAAG,IAAW,CAAC;IACzB,MAAM,KAAK,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;IACnD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,aAAa,IAAI,KAAK,EAAE,CAAC,CAAC;IACxD,OAAO,IAAA,2BAAmB,EAAC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;AAClD,CAAC,CAAC;AALW,QAAA,OAAO,WAKlB;AAEF,kBAAe,EAAE,QAAQ,EAAR,gBAAQ,EAAE,IAAI,EAAJ,YAAI,EAAE,OAAO,EAAP,eAAO,EAAE,CAAC"}
+{"version":3,"file":"docs-search-tool.js","sourceRoot":"","sources":["src/docs-search-tool.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,4CAA8D;AAIjD,QAAA,QAAQ,GAAa;IAChC,QAAQ,EAAE,KAAK;IACf,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,KAAK;CAClB,CAAC;AAEW,QAAA,IAAI,GAAS;IACxB,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,8EAA8E;IAC3F,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0BAA0B;aACxC;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yCAAyC;gBACtD,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;aAClG;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iCAAiC;gBAC9C,IAAI,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;aAC7B;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC;KAChC;IACD,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEF,MAAM,aAAa,GACjB,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,8DAA8D,CAAC;AAE5F,MAAM,OAAO,GAAG,KAAK,EAAE,CAAU,EAAE,IAAyC,EAAE,EAAE;IACrF,MAAM,IAAI,GAAG,IAAW,CAAC;IACzB,MAAM,KAAK,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;IACnD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,aAAa,IAAI,KAAK,EAAE,CAAC,CAAC;IAExD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,GAAG,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,UAAU,yCAAyC,MAAM,MAAM,CAAC,IAAI,EAAE,EAAE,CACrG,CAAC;IACJ,CAAC;IAED,OAAO,IAAA,2BAAmB,EAAC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;AAClD,CAAC,CAAC;AAZW,QAAA,OAAO,WAYlB;AAEF,kBAAe,EAAE,QAAQ,EAAR,gBAAQ,EAAE,IAAI,EAAJ,YAAI,EAAE,OAAO,EAAP,eAAO,EAAE,CAAC"}

package/docs-search-tool.mjs

@@ -8,7 +8,7 @@ export const metadata = {
 };
 export const tool = {
     name: 'search_docs',
-    description: 'Search for documentation for how to use the client to interact with the API.\nThe tool will return an array of Markdown-formatted documentation pages.',
+    description: 'Search for documentation for how to use the client to interact with the API.',
     inputSchema: {
         type: 'object',
         properties: {
@@ -19,7 +19,12 @@ export const tool = {
             language: {
                 type: 'string',
                 description: 'The language for the SDK to search for.',
-                enum: ['http', 'python', 'go', 'typescript', 'terraform', 'ruby', 'java', 'kotlin'],
+                enum: ['http', 'python', 'go', 'typescript', 'javascript', 'terraform', 'ruby', 'java', 'kotlin'],
+            },
+            detail: {
+                type: 'string',
+                description: 'The amount of detail to return.',
+                enum: ['default', 'verbose'],
             },
         },
         required: ['query', 'language'],
@@ -33,6 +38,9 @@ export const handler = async (_, args) => {
     const body = args;
     const query = new URLSearchParams(body).toString();
     const result = await fetch(`${docsSearchURL}?${query}`);
+    if (!result.ok) {
+        throw new Error(`${result.status}: ${result.statusText} when using doc search tool. Details: ${await result.text()}`);
+    }
     return asTextContentResult(await result.json());
 };
 export default { metadata, tool, handler };

package/docs-search-tool.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"docs-search-tool.mjs","sourceRoot":"","sources":["src/docs-search-tool.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAY,mBAAmB,EAAE;AAIxC,MAAM,CAAC,MAAM,QAAQ,GAAa;IAChC,QAAQ,EAAE,KAAK;IACf,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,KAAK;CAClB,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAS;IACxB,IAAI,EAAE,aAAa;IACnB,WAAW,EACT,wJAAwJ;IAC1J,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0BAA0B;aACxC;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yCAAyC;gBACtD,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;aACpF;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC;KAChC;IACD,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEF,MAAM,aAAa,GACjB,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,8DAA8D,CAAC;AAEnG,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,CAAU,EAAE,IAAyC,EAAE,EAAE;IACrF,MAAM,IAAI,GAAG,IAAW,CAAC;IACzB,MAAM,KAAK,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;IACnD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,aAAa,IAAI,KAAK,EAAE,CAAC,CAAC;IACxD,OAAO,mBAAmB,CAAC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;AAClD,CAAC,CAAC;AAEF,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"docs-search-tool.mjs","sourceRoot":"","sources":["src/docs-search-tool.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAY,mBAAmB,EAAE;AAIxC,MAAM,CAAC,MAAM,QAAQ,GAAa;IAChC,QAAQ,EAAE,KAAK;IACf,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,KAAK;CAClB,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAS;IACxB,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,8EAA8E;IAC3F,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0BAA0B;aACxC;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yCAAyC;gBACtD,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;aAClG;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iCAAiC;gBAC9C,IAAI,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;aAC7B;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC;KAChC;IACD,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEF,MAAM,aAAa,GACjB,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,8DAA8D,CAAC;AAEnG,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,CAAU,EAAE,IAAyC,EAAE,EAAE;IACrF,MAAM,IAAI,GAAG,IAAW,CAAC;IACzB,MAAM,KAAK,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;IACnD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,aAAa,IAAI,KAAK,EAAE,CAAC,CAAC;IAExD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,GAAG,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,UAAU,yCAAyC,MAAM,MAAM,CAAC,IAAI,EAAE,EAAE,CACrG,CAAC;IACJ,CAAC;IAED,OAAO,mBAAmB,CAAC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;AAClD,CAAC,CAAC;AAEF,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scorecard-ai-mcp",
-  "version": "2.5.0",
+  "version": "2.6.0",
   "mcpName": "io.scorecard/mcp",
   "description": "The official MCP Server for the Scorecard API",
   "author": "Scorecard <team@scorecard.io>",
@@ -28,9 +28,9 @@
     "fix": "eslint --fix --ext ts,js ."
   },
   "dependencies": {
-    "scorecard-ai": "^2.5.0",
+    "scorecard-ai": "^2.6.0",
     "@cloudflare/cabidela": "^0.2.4",
-    "@modelcontextprotocol/sdk": "^1.11.5",
+    "@modelcontextprotocol/sdk": "^1.24.0",
     "@valtown/deno-http-worker": "^0.0.21",
     "cors": "^2.8.5",
     "express": "^5.1.0",
@@ -59,12 +59,6 @@
       "types": "./index.d.mts",
       "default": "./index.mjs"
     },
-    "./code-tool-paths": {
-      "require": "./code-tool-paths.cjs"
-    },
-    "./code-tool-paths.cjs": {
-      "default": "./code-tool-paths.cjs"
-    },
     "./code-tool-types": {
       "import": "./code-tool-types.mjs",
       "require": "./code-tool-types.js"
@@ -75,16 +69,6 @@
     "./code-tool-types.mjs": {
       "default": "./code-tool-types.mjs"
     },
-    "./code-tool-worker": {
-      "import": "./code-tool-worker.mjs",
-      "require": "./code-tool-worker.js"
-    },
-    "./code-tool-worker.js": {
-      "default": "./code-tool-worker.js"
-    },
-    "./code-tool-worker.mjs": {
-      "default": "./code-tool-worker.mjs"
-    },
     "./code-tool": {
       "import": "./code-tool.mjs",
       "require": "./code-tool.js"

package/server.js

@@ -22,7 +22,7 @@ var tools_2 = require("./tools.js");
 Object.defineProperty(exports, "endpoints", { enumerable: true, get: function () { return tools_2.endpoints; } });
 const newMcpServer = () => new mcp_js_1.McpServer({
     name: 'scorecard_ai_api',
-    version: '2.5.0',
+    version: '2.6.0',
 }, { capabilities: { tools: {}, logging: {} } });
 exports.newMcpServer = newMcpServer;
 // Create server instance

package/server.mjs

@@ -11,7 +11,7 @@ export { ClientType } from "./compat.mjs";
 export { endpoints } from "./tools.mjs";
 export const newMcpServer = () => new McpServer({
     name: 'scorecard_ai_api',
-    version: '2.5.0',
+    version: '2.6.0',
 }, { capabilities: { tools: {}, logging: {} } });
 // Create server instance
 export const server = newMcpServer();

package/src/code-tool-types.ts

@@ -11,4 +11,8 @@ export type WorkerSuccess = {
   logLines: string[];
   errLines: string[];
 };
-export type WorkerError = { message: string | undefined };
+export type WorkerError = {
+  message: string | undefined;
+  logLines: string[];
+  errLines: string[];
+};

package/src/code-tool.ts

@@ -1,14 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { dirname } from 'node:path';
-import { pathToFileURL } from 'node:url';
-import Scorecard, { ClientOptions } from 'scorecard-ai';
-import { ContentBlock, Endpoint, Metadata, ToolCallResult } from './tools/types';
-
+import { Metadata, ToolCallResult, asTextContentResult } from './tools/types';
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-
-import { WorkerInput, WorkerError, WorkerSuccess } from './code-tool-types';
-
+import { readEnv } from './server';
+import { WorkerSuccess } from './code-tool-types';
 /**
  * A tool that runs code against a copy of the SDK.
  *
@@ -18,129 +13,46 @@ import { WorkerInput, WorkerError, WorkerSuccess } from './code-tool-types';
  *
  * @param endpoints - The endpoints to include in the list.
  */
-export async function codeTool(): Promise<Endpoint> {
+export async function codeTool() {
   const metadata: Metadata = { resource: 'all', operation: 'write', tags: [] };
   const tool: Tool = {
     name: 'execute',
     description:
-      'Runs JavaScript code to interact with the API.\n\nYou are a skilled programmer writing code to interface with the service.\nDefine an async function named "run" that takes a single parameter of an initialized client named "client", and it will be run.\nWrite code within this template:\n\n```\nasync function run(client) {\n  // Fill this out\n}\n```\n\nYou will be returned anything that your function returns, plus the results of any console.log statements.\nIf any code triggers an error, the tool will return an error response, so you do not need to add error handling unless you want to output something more helpful than the raw error.\nIt is not necessary to add comments to code, unless by adding those comments you believe that you can generate better code.\nThis code will run in a container, and you will not be able to use fetch or otherwise interact with the network calls other than through the client you are given.\nAny variables you define won\'t live between successive uses of this call, so make sure to return or log any data you might need later.',
+      'Runs JavaScript code to interact with the API.\n\nYou are a skilled programmer writing code to interface with the service.\nDefine an async function named "run" that takes a single parameter of an initialized SDK client and it will be run.\nWrite code within this template:\n\n```\nasync function run(client) {\n  // Fill this out\n}\n```\n\nYou will be returned anything that your function returns, plus the results of any console.log statements.\nIf any code triggers an error, the tool will return an error response, so you do not need to add error handling unless you want to output something more helpful than the raw error.\nIt is not necessary to add comments to code, unless by adding those comments you believe that you can generate better code.\nThis code will run in a container, and you will not be able to use fetch or otherwise interact with the network calls other than through the client you are given.\nAny variables you define won\'t live between successive uses of this call, so make sure to return or log any data you might need later.',
     inputSchema: { type: 'object', properties: { code: { type: 'string' } } },
   };
-
-  // Import dynamically to avoid failing at import time in cases where the environment is not well-supported.
-  const { newDenoHTTPWorker } = await import('@valtown/deno-http-worker');
-  const { workerPath } = await import('./code-tool-paths.cjs');
-
-  const handler = async (client: Scorecard, args: unknown): Promise<ToolCallResult> => {
-    const baseURLHostname = new URL(client.baseURL).hostname;
-    const { code } = args as { code: string };
-
-    const worker = await newDenoHTTPWorker(pathToFileURL(workerPath), {
-      runFlags: [
-        `--node-modules-dir=manual`,
-        `--allow-read=code-tool-worker.mjs,${workerPath.replace(/([\/\\]node_modules)[\/\\].+$/, '$1')}/`,
-        `--allow-net=${baseURLHostname}`,
-        // Allow environment variables because instantiating the client will try to read from them,
-        // even though they are not set.
-        '--allow-env',
-      ],
-      printOutput: true,
-      spawnOptions: {
-        cwd: dirname(workerPath),
+  const handler = async (_: unknown, args: any): Promise<ToolCallResult> => {
+    const code = args.code as string;
+
+    // this is not required, but passing a Stainless API key for the matching project_name
+    // will allow you to run code-mode queries against non-published versions of your SDK.
+    const stainlessAPIKey = readEnv('STAINLESS_API_KEY');
+    const codeModeEndpoint =
+      readEnv('CODE_MODE_ENDPOINT_URL') ?? 'https://api.stainless.com/api/ai/code-tool';
+
+    const res = await fetch(codeModeEndpoint, {
+      method: 'POST',
+      headers: {
+        ...(stainlessAPIKey && { Authorization: stainlessAPIKey }),
+        'Content-Type': 'application/json',
+        client_envs: JSON.stringify({ SCORECARD_API_KEY: readEnv('SCORECARD_API_KEY') }),
       },
+      body: JSON.stringify({
+        project_name: 'scorecard',
+        client_opts: { environment: (readEnv('SCORECARD_ENVIRONMENT') || undefined) as any },
+        code,
+      }),
     });
 
-    try {
-      const resp = await new Promise<Response>((resolve, reject) => {
-        worker.addEventListener('exit', (exitCode) => {
-          reject(new Error(`Worker exited with code ${exitCode}`));
-        });
-
-        const opts: ClientOptions = {
-          baseURL: client.baseURL,
-          apiKey: client.apiKey,
-          defaultHeaders: {
-            'X-Stainless-MCP': 'true',
-          },
-        };
-
-        const req = worker.request(
-          'http://localhost',
-          {
-            headers: {
-              'content-type': 'application/json',
-            },
-            method: 'POST',
-          },
-          (resp) => {
-            const body: Uint8Array[] = [];
-            resp.on('error', (err) => {
-              reject(err);
-            });
-            resp.on('data', (chunk) => {
-              body.push(chunk);
-            });
-            resp.on('end', () => {
-              resolve(
-                new Response(Buffer.concat(body).toString(), {
-                  status: resp.statusCode ?? 200,
-                  headers: resp.headers as any,
-                }),
-              );
-            });
-          },
-        );
-
-        const body = JSON.stringify({
-          opts,
-          code,
-        } satisfies WorkerInput);
-
-        req.write(body, (err) => {
-          if (err != null) {
-            reject(err);
-          }
-        });
-
-        req.end();
-      });
-
-      if (resp.status === 200) {
-        const { result, logLines, errLines } = (await resp.json()) as WorkerSuccess;
-        const returnOutput: ContentBlock | null =
-          result == null ? null : (
-            {
-              type: 'text',
-              text: typeof result === 'string' ? result : JSON.stringify(result),
-            }
-          );
-        const logOutput: ContentBlock | null =
-          logLines.length === 0 ?
-            null
-          : {
-              type: 'text',
-              text: logLines.join('\n'),
-            };
-        const errOutput: ContentBlock | null =
-          errLines.length === 0 ?
-            null
-          : {
-              type: 'text',
-              text: 'Error output:\n' + errLines.join('\n'),
-            };
-        return {
-          content: [returnOutput, logOutput, errOutput].filter((block) => block !== null),
-        };
-      } else {
-        const { message } = (await resp.json()) as WorkerError;
-        return {
-          content: message == null ? [] : [{ type: 'text', text: message }],
-          isError: true,
-        };
-      }
-    } finally {
-      worker.terminate();
+    if (!res.ok) {
+      throw new Error(
+        `${res.status}: ${
+          res.statusText
+        } error when trying to contact Code Tool server. Details: ${await res.text()}`,
+      );
     }
+
+    return asTextContentResult((await res.json()) as WorkerSuccess);
   };
 
   return { metadata, tool, handler };

package/src/docs-search-tool.ts

@@ -13,8 +13,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'search_docs',
-  description:
-    'Search for documentation for how to use the client to interact with the API.\nThe tool will return an array of Markdown-formatted documentation pages.',
+  description: 'Search for documentation for how to use the client to interact with the API.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -25,7 +24,12 @@ export const tool: Tool = {
       language: {
         type: 'string',
         description: 'The language for the SDK to search for.',
-        enum: ['http', 'python', 'go', 'typescript', 'terraform', 'ruby', 'java', 'kotlin'],
+        enum: ['http', 'python', 'go', 'typescript', 'javascript', 'terraform', 'ruby', 'java', 'kotlin'],
+      },
+      detail: {
+        type: 'string',
+        description: 'The amount of detail to return.',
+        enum: ['default', 'verbose'],
       },
     },
     required: ['query', 'language'],
@@ -42,6 +46,13 @@ export const handler = async (_: unknown, args: Record<string, unknown> | undefi
   const body = args as any;
   const query = new URLSearchParams(body).toString();
   const result = await fetch(`${docsSearchURL}?${query}`);
+
+  if (!result.ok) {
+    throw new Error(
+      `${result.status}: ${result.statusText} when using doc search tool. Details: ${await result.text()}`,
+    );
+  }
+
   return asTextContentResult(await result.json());
 };
 

package/src/server.ts

@@ -34,7 +34,7 @@ export const newMcpServer = () =>
   new McpServer(
     {
       name: 'scorecard_ai_api',
-      version: '2.5.0',
+      version: '2.6.0',
     },
     { capabilities: { tools: {}, logging: {} } },
   );

package/src/tools/metrics/create-metrics.ts

@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { Metadata, asTextContentResult } from 'scorecard-ai-mcp/tools/types';
+import { Metadata, asErrorResult, asTextContentResult } from 'scorecard-ai-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
 import Scorecard from 'scorecard-ai';
@@ -370,7 +370,14 @@ export const tool: Tool = {
 
 export const handler = async (client: Scorecard, args: Record<string, unknown> | undefined) => {
   const { projectId, ...body } = args as any;
-  return asTextContentResult(await client.metrics.create(projectId, body));
+  try {
+    return asTextContentResult(await client.metrics.create(projectId, body));
+  } catch (error) {
+    if (error instanceof Scorecard.APIError) {
+      return asErrorResult(error.message);
+    }
+    throw error;
+  }
 };
 
 export default { metadata, tool, handler };

package/src/tools/metrics/delete-metrics.ts

@@ -44,7 +44,7 @@ export const handler = async (client: Scorecard, args: Record<string, unknown> |
   try {
     return asTextContentResult(await maybeFilter(jq_filter, await client.metrics.delete(metricId)));
   } catch (error) {
-    if (isJqError(error)) {
+    if (error instanceof Scorecard.APIError || isJqError(error)) {
       return asErrorResult(error.message);
     }
     throw error;

package/src/tools/metrics/get-metrics.ts

@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { Metadata, asTextContentResult } from 'scorecard-ai-mcp/tools/types';
+import { Metadata, asErrorResult, asTextContentResult } from 'scorecard-ai-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
 import Scorecard from 'scorecard-ai';
@@ -33,7 +33,14 @@ export const tool: Tool = {
 
 export const handler = async (client: Scorecard, args: Record<string, unknown> | undefined) => {
   const { metricId, ...body } = args as any;
-  return asTextContentResult(await client.metrics.get(metricId));
+  try {
+    return asTextContentResult(await client.metrics.get(metricId));
+  } catch (error) {
+    if (error instanceof Scorecard.APIError) {
+      return asErrorResult(error.message);
+    }
+    throw error;
+  }
 };
 
 export default { metadata, tool, handler };

package/src/tools/metrics/list-metrics.ts

@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { Metadata, asTextContentResult } from 'scorecard-ai-mcp/tools/types';
+import { Metadata, asErrorResult, asTextContentResult } from 'scorecard-ai-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
 import Scorecard from 'scorecard-ai';
@@ -45,7 +45,14 @@ export const tool: Tool = {
 export const handler = async (client: Scorecard, args: Record<string, unknown> | undefined) => {
   const { projectId, ...body } = args as any;
   const response = await client.metrics.list(projectId, body).asResponse();
-  return asTextContentResult(await response.json());
+  try {
+    return asTextContentResult(await response.json());
+  } catch (error) {
+    if (error instanceof Scorecard.APIError) {
+      return asErrorResult(error.message);
+    }
+    throw error;
+  }
 };
 
 export default { metadata, tool, handler };

package/src/tools/metrics/update-metrics.ts

@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { Metadata, asTextContentResult } from 'scorecard-ai-mcp/tools/types';
+import { Metadata, asErrorResult, asTextContentResult } from 'scorecard-ai-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
 import Scorecard from 'scorecard-ai';
@@ -370,7 +370,14 @@ export const tool: Tool = {
 
 export const handler = async (client: Scorecard, args: Record<string, unknown> | undefined) => {
   const { metricId, ...body } = args as any;
-  return asTextContentResult(await client.metrics.update(metricId, body));
+  try {
+    return asTextContentResult(await client.metrics.update(metricId, body));
+  } catch (error) {
+    if (error instanceof Scorecard.APIError) {
+      return asErrorResult(error.message);
+    }
+    throw error;
+  }
 };
 
 export default { metadata, tool, handler };

package/src/tools/projects/create-projects.ts

@@ -47,7 +47,7 @@ export const handler = async (client: Scorecard, args: Record<string, unknown> |
   try {
     return asTextContentResult(await maybeFilter(jq_filter, await client.projects.create(body)));
   } catch (error) {
-    if (isJqError(error)) {
+    if (error instanceof Scorecard.APIError || isJqError(error)) {
       return asErrorResult(error.message);
     }
     throw error;

package/src/tools/projects/list-projects.ts

@@ -52,7 +52,7 @@ export const handler = async (client: Scorecard, args: Record<string, unknown> |
   try {
     return asTextContentResult(await maybeFilter(jq_filter, await response.json()));
   } catch (error) {
-    if (isJqError(error)) {
+    if (error instanceof Scorecard.APIError || isJqError(error)) {
       return asErrorResult(error.message);
     }
     throw error;

package/src/tools/records/create-records.ts

@@ -61,7 +61,7 @@ export const handler = async (client: Scorecard, args: Record<string, unknown> |
   try {
     return asTextContentResult(await maybeFilter(jq_filter, await client.records.create(runId, body)));
   } catch (error) {
-    if (isJqError(error)) {
+    if (error instanceof Scorecard.APIError || isJqError(error)) {
       return asErrorResult(error.message);
     }
     throw error;

package/src/tools/records/delete-records.ts

@@ -44,7 +44,7 @@ export const handler = async (client: Scorecard, args: Record<string, unknown> |
   try {
     return asTextContentResult(await maybeFilter(jq_filter, await client.records.delete(recordId)));
   } catch (error) {
-    if (isJqError(error)) {
+    if (error instanceof Scorecard.APIError || isJqError(error)) {
       return asErrorResult(error.message);
     }
     throw error;

package/src/tools/records/list-records.ts

@@ -55,7 +55,7 @@ export const handler = async (client: Scorecard, args: Record<string, unknown> |
   try {
     return asTextContentResult(await maybeFilter(jq_filter, await response.json()));
   } catch (error) {
-    if (isJqError(error)) {
+    if (error instanceof Scorecard.APIError || isJqError(error)) {
       return asErrorResult(error.message);
     }
     throw error;

package/src/tools/runs/create-runs.ts

@@ -57,7 +57,7 @@ export const handler = async (client: Scorecard, args: Record<string, unknown> |
   try {
     return asTextContentResult(await maybeFilter(jq_filter, await client.runs.create(projectId, body)));
   } catch (error) {
-    if (isJqError(error)) {
+    if (error instanceof Scorecard.APIError || isJqError(error)) {
       return asErrorResult(error.message);
     }
     throw error;

package/src/tools/runs/get-runs.ts

@@ -44,7 +44,7 @@ export const handler = async (client: Scorecard, args: Record<string, unknown> |
   try {
     return asTextContentResult(await maybeFilter(jq_filter, await client.runs.get(runId)));
   } catch (error) {
-    if (isJqError(error)) {
+    if (error instanceof Scorecard.APIError || isJqError(error)) {
       return asErrorResult(error.message);
     }
     throw error;

package/src/tools/runs/list-runs.ts

@@ -55,7 +55,7 @@ export const handler = async (client: Scorecard, args: Record<string, unknown> |
   try {
     return asTextContentResult(await maybeFilter(jq_filter, await response.json()));
   } catch (error) {
-    if (isJqError(error)) {
+    if (error instanceof Scorecard.APIError || isJqError(error)) {
       return asErrorResult(error.message);
     }
     throw error;

package/src/tools/scores/upsert-scores.ts

@@ -55,7 +55,7 @@ export const handler = async (client: Scorecard, args: Record<string, unknown> |
       await maybeFilter(jq_filter, await client.scores.upsert(metricConfigId, body)),
     );
   } catch (error) {
-    if (isJqError(error)) {
+    if (error instanceof Scorecard.APIError || isJqError(error)) {
       return asErrorResult(error.message);
     }
     throw error;

package/src/tools/systems/delete-systems.ts

@@ -44,7 +44,7 @@ export const handler = async (client: Scorecard, args: Record<string, unknown> |
   try {
     return asTextContentResult(await maybeFilter(jq_filter, await client.systems.delete(systemId)));
   } catch (error) {
-    if (isJqError(error)) {
+    if (error instanceof Scorecard.APIError || isJqError(error)) {
       return asErrorResult(error.message);
     }
     throw error;

package/src/tools/systems/get-systems.ts

@@ -44,7 +44,7 @@ export const handler = async (client: Scorecard, args: Record<string, unknown> |
   try {
     return asTextContentResult(await maybeFilter(jq_filter, await client.systems.get(systemId)));
   } catch (error) {
-    if (isJqError(error)) {
+    if (error instanceof Scorecard.APIError || isJqError(error)) {
       return asErrorResult(error.message);
     }
     throw error;

package/src/tools/systems/list-systems.ts

@@ -55,7 +55,7 @@ export const handler = async (client: Scorecard, args: Record<string, unknown> |
   try {
     return asTextContentResult(await maybeFilter(jq_filter, await response.json()));
   } catch (error) {
-    if (isJqError(error)) {
+    if (error instanceof Scorecard.APIError || isJqError(error)) {
       return asErrorResult(error.message);
     }
     throw error;

package/src/tools/systems/update-systems.ts

@@ -54,7 +54,7 @@ export const handler = async (client: Scorecard, args: Record<string, unknown> |
   try {
     return asTextContentResult(await maybeFilter(jq_filter, await client.systems.update(systemId, body)));
   } catch (error) {
-    if (isJqError(error)) {
+    if (error instanceof Scorecard.APIError || isJqError(error)) {
       return asErrorResult(error.message);
     }
     throw error;

package/src/tools/systems/upsert-systems.ts

@@ -56,7 +56,7 @@ export const handler = async (client: Scorecard, args: Record<string, unknown> |
   try {
     return asTextContentResult(await maybeFilter(jq_filter, await client.systems.upsert(projectId, body)));
   } catch (error) {
-    if (isJqError(error)) {
+    if (error instanceof Scorecard.APIError || isJqError(error)) {
       return asErrorResult(error.message);
     }
     throw error;