Merge pull request #32 from stainless-api/release-please--branches--main--changes--next--components--sdk

release: 0.2.0

Author: dgellow

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.1.0"
+  ".": "0.2.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 22
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/stainless%2Fstainless-v0-bced6b6177fa276293bb8c54df90e10340f1b5dd92189225c53551d3952c091a.yml
-openapi_spec_hash: ad0459eb77d77055a261721e087ed5da
-config_hash: c3e64d6d69fcc4fb22a312bc13bcb67a
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/stainless%2Fstainless-v0-c05bce23f6a3478a1803494b2c627e0bbf73917a849756eddc42f4607e167c6b.yml
+openapi_spec_hash: b9eb999620220d15b176f815f21a67ba
+config_hash: 977c436868252591d86546b2127ab8ce

CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 0.2.0 (2026-02-20)
+
+Full Changelog: [v0.1.0...v0.2.0](https://github.com/stainless-api/stainless-api-typescript/compare/v0.1.0...v0.2.0)
+
+### Features
+
+* **api:** manual updates ([79e1b0f](https://github.com/stainless-api/stainless-api-typescript/commit/79e1b0f2cdc37955766d09304b51017ed6dde8d7))
+* **api:** populate integrated_stats ([d197453](https://github.com/stainless-api/stainless-api-typescript/commit/d197453190c3f44ad746e7b3f83c6060d59e2dbb))
+
+
+### Bug Fixes
+
+* **mcp:** initialize SDK lazily to avoid failing the connection on init errors ([f07516c](https://github.com/stainless-api/stainless-api-typescript/commit/f07516c5bc6719099b64f2a4ef693377d87b8ddc))
+
+
+### Chores
+
+* **internal:** remove mock server code ([47f0521](https://github.com/stainless-api/stainless-api-typescript/commit/47f0521a21a0e3ae9bcd690e1c4802153d21dc55))
+* **mcp:** correctly update version in sync with sdk ([c5227ab](https://github.com/stainless-api/stainless-api-typescript/commit/c5227abb38834153889b213c0e666bb06ffd6464))
+* update mock server docs ([39315f6](https://github.com/stainless-api/stainless-api-typescript/commit/39315f6bc3defb8d426178475222568c9d79c138))
+
 ## 0.1.0 (2026-02-19)
 
 Full Changelog: [v0.1.0-alpha.27...v0.1.0](https://github.com/stainless-api/stainless-api-typescript/compare/v0.1.0-alpha.27...v0.1.0)

CONTRIBUTING.md

@@ -68,7 +68,7 @@ $ pnpm link -—global @stainless-api/sdk
 Most tests require you to [set up a mock server](https://github.com/stoplightio/prism) against the OpenAPI spec to run the tests.
 
 ```sh
-$ npx prism mock path/to/your/openapi.yml
+$ ./scripts/mock
 ```
 
 ```sh

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stainless-api/sdk",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "The official TypeScript library for the Stainless API",
   "author": "Stainless <support@stainless.com>",
   "types": "dist/index.d.ts",

packages/mcp-server/manifest.json

@@ -1,7 +1,7 @@
 {
   "dxt_version": "0.2",
   "name": "@stainless-api/mcp",
-  "version": "0.1.0-alpha.11",
+  "version": "0.2.0",
   "description": "The official MCP Server for the Stainless API",
   "author": {
     "name": "Stainless",
@@ -18,7 +18,9 @@
     "entry_point": "index.js",
     "mcp_config": {
       "command": "node",
-      "args": ["${__dirname}/index.js"],
+      "args": [
+        "${__dirname}/index.js"
+      ],
       "env": {
         "STAINLESS_API_KEY": "${user_config.STAINLESS_API_KEY}",
         "STAINLESS_PROJECT": "${user_config.STAINLESS_PROJECT}"
@@ -46,5 +48,7 @@
       "node": ">=18.0.0"
     }
   },
-  "keywords": ["api"]
+  "keywords": [
+    "api"
+  ]
 }

packages/mcp-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stainless-api/mcp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "The official MCP Server for the Stainless API",
   "author": "Stainless <support@stainless.com>",
   "types": "dist/index.d.ts",

packages/mcp-server/src/http.ts

@@ -24,28 +24,17 @@ const newServer = async ({
   const stainlessApiKey = getStainlessApiKey(req, mcpOptions);
   const server = await newMcpServer(stainlessApiKey);
 
-  try {
-    const authOptions = parseClientAuthHeaders(req, false);
+  const authOptions = parseClientAuthHeaders(req, false);
 
-    await initMcpServer({
-      server: server,
-      mcpOptions: mcpOptions,
-      clientOptions: {
-        ...clientOptions,
-        ...authOptions,
-      },
-      stainlessApiKey: stainlessApiKey,
-    });
-  } catch (error) {
-    res.status(401).json({
-      jsonrpc: '2.0',
-      error: {
-        code: -32000,
-        message: `Unauthorized: ${error instanceof Error ? error.message : error}`,
-      },
-    });
-    return null;
-  }
+  await initMcpServer({
+    server: server,
+    mcpOptions: mcpOptions,
+    clientOptions: {
+      ...clientOptions,
+      ...authOptions,
+    },
+    stainlessApiKey: stainlessApiKey,
+  });
 
   return server;
 };

packages/mcp-server/src/index.ts

@@ -24,7 +24,7 @@ async function main() {
       await launchStreamableHTTPServer({
         mcpOptions: options,
         debug: options.debug,
-        port: options.port ?? options.socket,
+        port: options.socket ?? options.port,
       });
       break;
   }

packages/mcp-server/src/server.ts

@@ -21,7 +21,7 @@ export const newMcpServer = async (stainlessApiKey: string | undefined) =>
   new McpServer(
     {
       name: 'stainless_api_sdk_api',
-      version: '0.1.0',
+      version: '0.2.0',
     },
     {
       instructions: await getInstructions(stainlessApiKey),
@@ -56,18 +56,36 @@ export async function initMcpServer(params: {
     error: logAtLevel('error'),
   };
 
-  let client = new Stainless({
-    ...{
-      project: readEnv('STAINLESS_PROJECT'),
-      environment: (readEnv('STAINLESS_ENVIRONMENT') || undefined) as any,
-    },
-    logger,
-    ...params.clientOptions,
-    defaultHeaders: {
-      ...params.clientOptions?.defaultHeaders,
-      'X-Stainless-MCP': 'true',
-    },
-  });
+  let _client: Stainless | undefined;
+  let _clientError: Error | undefined;
+  let _logLevel: 'debug' | 'info' | 'warn' | 'error' | 'off' | undefined;
+
+  const getClient = (): Stainless => {
+    if (_clientError) throw _clientError;
+    if (!_client) {
+      try {
+        _client = new Stainless({
+          ...{
+            project: readEnv('STAINLESS_PROJECT'),
+            environment: (readEnv('STAINLESS_ENVIRONMENT') || undefined) as any,
+          },
+          logger,
+          ...params.clientOptions,
+          defaultHeaders: {
+            ...params.clientOptions?.defaultHeaders,
+            'X-Stainless-MCP': 'true',
+          },
+        });
+        if (_logLevel) {
+          _client = _client.withOptions({ logLevel: _logLevel });
+        }
+      } catch (e) {
+        _clientError = e instanceof Error ? e : new Error(String(e));
+        throw _clientError;
+      }
+    }
+    return _client;
+  };
 
   const providedTools = selectTools(params.mcpOptions);
   const toolMap = Object.fromEntries(providedTools.map((mcpTool) => [mcpTool.tool.name, mcpTool]));
@@ -85,6 +103,21 @@ export async function initMcpServer(params: {
       throw new Error(`Unknown tool: ${name}`);
     }
 
+    let client: Stainless;
+    try {
+      client = getClient();
+    } catch (error) {
+      return {
+        content: [
+          {
+            type: 'text' as const,
+            text: `Failed to initialize client: ${error instanceof Error ? error.message : String(error)}`,
+          },
+        ],
+        isError: true,
+      };
+    }
+
     return executeHandler({
       handler: mcpTool.handler,
       reqContext: {
@@ -97,24 +130,29 @@ export async function initMcpServer(params: {
 
   server.setRequestHandler(SetLevelRequestSchema, async (request) => {
     const { level } = request.params;
+    let logLevel: 'debug' | 'info' | 'warn' | 'error' | 'off';
     switch (level) {
       case 'debug':
-        client = client.withOptions({ logLevel: 'debug' });
+        logLevel = 'debug';
         break;
       case 'info':
-        client = client.withOptions({ logLevel: 'info' });
+        logLevel = 'info';
         break;
       case 'notice':
       case 'warning':
-        client = client.withOptions({ logLevel: 'warn' });
+        logLevel = 'warn';
         break;
       case 'error':
-        client = client.withOptions({ logLevel: 'error' });
+        logLevel = 'error';
         break;
       default:
-        client = client.withOptions({ logLevel: 'off' });
+        logLevel = 'off';
         break;
     }
+    _logLevel = logLevel;
+    if (_client) {
+      _client = _client.withOptions({ logLevel });
+    }
     return {};
   });
 }