From 60a5820c6194a717c6a795b5c9aa40510f03c744 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Tue, 3 Feb 2026 03:25:51 +0000
Subject: [PATCH 01/10] fix(client): avoid memory leak with abort signals

---
 src/client.ts | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/src/client.ts b/src/client.ts
index 41024e6..fdbd738 100644
--- a/src/client.ts
+++ b/src/client.ts
@@ -521,9 +521,10 @@ export class BrandDev {
     controller: AbortController,
   ): Promise<Response> {
     const { signal, method, ...options } = init || {};
-    if (signal) signal.addEventListener('abort', () => controller.abort());
+    const abort = controller.abort.bind(controller);
+    if (signal) signal.addEventListener('abort', abort, { once: true });
 
-    const timeout = setTimeout(() => controller.abort(), ms);
+    const timeout = setTimeout(abort, ms);
 
     const isReadableBody =
       ((globalThis as any).ReadableStream && options.body instanceof (globalThis as any).ReadableStream) ||

From 00c1b991097b8681c8187edb2697259964d9f195 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Tue, 3 Feb 2026 03:27:29 +0000
Subject: [PATCH 02/10] chore(client): do not parse responses with empty
 content-length

---
 src/internal/parse.ts | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/src/internal/parse.ts b/src/internal/parse.ts
index 0fb7cb0..19f1c9b 100644
--- a/src/internal/parse.ts
+++ b/src/internal/parse.ts
@@ -29,6 +29,12 @@ export async function defaultParseResponse<T>(client: BrandDev, props: APIRespon
     const mediaType = contentType?.split(';')[0]?.trim();
     const isJSON = mediaType?.includes('application/json') || mediaType?.endsWith('+json');
     if (isJSON) {
+      const contentLength = response.headers.get('content-length');
+      if (contentLength === '0') {
+        // if there is no content we can't do anything
+        return undefined as T;
+      }
+
       const json = await response.json();
       return json as T;
     }

From 55744a2b31a70642e6338d615d7e20fa522d1181 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Tue, 3 Feb 2026 03:33:43 +0000
Subject: [PATCH 03/10] chore(internal): support oauth authorization code flow
 for MCP servers

---
 packages/mcp-server/package.json   | 4 ++++
 packages/mcp-server/src/headers.ts | 4 +++-
 packages/mcp-server/src/http.ts    | 9 +++++----
 packages/mcp-server/src/options.ts | 1 +
 4 files changed, 13 insertions(+), 5 deletions(-)

diff --git a/packages/mcp-server/package.json b/packages/mcp-server/package.json
index daaebec..3c8e935 100644
--- a/packages/mcp-server/package.json
+++ b/packages/mcp-server/package.json
@@ -34,10 +34,12 @@
     "@cloudflare/cabidela": "^0.2.4",
     "@modelcontextprotocol/sdk": "^1.25.2",
     "@valtown/deno-http-worker": "^0.0.21",
+    "cookie-parser": "^1.4.6",
     "cors": "^2.8.5",
     "express": "^5.1.0",
     "fuse.js": "^7.1.0",
     "jq-web": "https://github.com/stainless-api/jq-web/releases/download/v0.8.8/jq-web.tar.gz",
+    "morgan": "^1.10.0",
     "qs": "^6.14.1",
     "typescript": "5.8.3",
     "yargs": "^17.7.2",
@@ -50,9 +52,11 @@
   },
   "devDependencies": {
     "@anthropic-ai/mcpb": "^2.1.2",
+    "@types/cookie-parser": "^1.4.10",
     "@types/cors": "^2.8.19",
     "@types/express": "^5.0.3",
     "@types/jest": "^29.4.0",
+    "@types/morgan": "^1.9.10",
     "@types/qs": "^6.14.0",
     "@types/yargs": "^17.0.8",
     "@typescript-eslint/eslint-plugin": "8.31.1",
diff --git a/packages/mcp-server/src/headers.ts b/packages/mcp-server/src/headers.ts
index 477066a..14e5f68 100644
--- a/packages/mcp-server/src/headers.ts
+++ b/packages/mcp-server/src/headers.ts
@@ -3,7 +3,7 @@
 import { IncomingMessage } from 'node:http';
 import { ClientOptions } from 'brand.dev';
 
-export const parseAuthHeaders = (req: IncomingMessage): Partial<ClientOptions> => {
+export const parseAuthHeaders = (req: IncomingMessage, required?: boolean): Partial<ClientOptions> => {
   if (req.headers.authorization) {
     const scheme = req.headers.authorization.split(' ')[0]!;
     const value = req.headers.authorization.slice(scheme.length + 1);
@@ -15,6 +15,8 @@ export const parseAuthHeaders = (req: IncomingMessage): Partial<ClientOptions> =
           'Unsupported authorization scheme. Expected the "Authorization" header to be a supported scheme (Bearer).',
         );
     }
+  } else if (required) {
+    throw new Error('Missing required Authorization header; see WWW-Authenticate header for details.');
   }
 
   const apiKey =
diff --git a/packages/mcp-server/src/http.ts b/packages/mcp-server/src/http.ts
index dcfeba6..42eb500 100644
--- a/packages/mcp-server/src/http.ts
+++ b/packages/mcp-server/src/http.ts
@@ -2,8 +2,8 @@
 
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp';
 import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
-
 import express from 'express';
+import morgan from 'morgan';
 import { McpOptions } from './options';
 import { ClientOptions, initMcpServer, newMcpServer } from './server';
 import { parseAuthHeaders } from './headers';
@@ -20,7 +20,7 @@ const newServer = ({
   const server = newMcpServer();
 
   try {
-    const authOptions = parseAuthHeaders(req);
+    const authOptions = parseAuthHeaders(req, false);
     initMcpServer({
       server: server,
       clientOptions: {
@@ -75,14 +75,15 @@ const del = async (req: express.Request, res: express.Response) => {
 
 export const streamableHTTPApp = ({
   clientOptions = {},
-  mcpOptions = {},
+  mcpOptions,
 }: {
   clientOptions?: ClientOptions;
-  mcpOptions?: McpOptions;
+  mcpOptions: McpOptions;
 }): express.Express => {
   const app = express();
   app.set('query parser', 'extended');
   app.use(express.json());
+  app.use(morgan('combined'));
 
   app.get('/', get);
   app.post('/', post({ clientOptions, mcpOptions }));
diff --git a/packages/mcp-server/src/options.ts b/packages/mcp-server/src/options.ts
index c66ad8c..025280e 100644
--- a/packages/mcp-server/src/options.ts
+++ b/packages/mcp-server/src/options.ts
@@ -35,6 +35,7 @@ export function parseCLIOptions(): CLIOptions {
     })
     .option('port', {
       type: 'number',
+      default: 3000,
       description: 'Port to serve on if using http transport',
     })
     .option('socket', {

From 8dcedeb141df02789f5693034f8508d6f5d649ee Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Thu, 5 Feb 2026 03:12:49 +0000
Subject: [PATCH 04/10] chore(client): restructure abort controller binding

---
 src/client.ts | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/src/client.ts b/src/client.ts
index fdbd738..82bf6f9 100644
--- a/src/client.ts
+++ b/src/client.ts
@@ -521,7 +521,7 @@ export class BrandDev {
     controller: AbortController,
   ): Promise<Response> {
     const { signal, method, ...options } = init || {};
-    const abort = controller.abort.bind(controller);
+    const abort = this._makeAbort(controller);
     if (signal) signal.addEventListener('abort', abort, { once: true });
 
     const timeout = setTimeout(abort, ms);
@@ -547,6 +547,7 @@ export class BrandDev {
       return await this.fetch.call(undefined, url, fetchOptions);
     } finally {
       clearTimeout(timeout);
+      if (signal) signal.removeEventListener('abort', abort);
     }
   }
 
@@ -691,6 +692,12 @@ export class BrandDev {
     return headers.values;
   }
 
+  private _makeAbort(controller: AbortController) {
+    // note: we can't just inline this method inside `fetchWithTimeout()` because then the closure
+    //       would capture all request options, and cause a memory leak.
+    return () => controller.abort();
+  }
+
   private buildBody({ options: { body, headers: rawHeaders } }: { options: FinalRequestOptions }): {
     bodyHeaders: HeadersLike;
     body: BodyInit | undefined;

From fc3bcca431450e2cb886638003a1aeaebf41a210 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Thu, 5 Feb 2026 03:14:09 +0000
Subject: [PATCH 05/10] chore(internal): refactor flag parsing for MCP servers
 and add debug flag

---
 packages/mcp-server/package.json   |  1 +
 packages/mcp-server/src/http.ts    | 27 ++++++++++++++++++++++-----
 packages/mcp-server/src/index.ts   |  6 +++++-
 packages/mcp-server/src/options.ts | 28 +++++++++++++++-------------
 4 files changed, 43 insertions(+), 19 deletions(-)

diff --git a/packages/mcp-server/package.json b/packages/mcp-server/package.json
index 3c8e935..21a0b19 100644
--- a/packages/mcp-server/package.json
+++ b/packages/mcp-server/package.json
@@ -40,6 +40,7 @@
     "fuse.js": "^7.1.0",
     "jq-web": "https://github.com/stainless-api/jq-web/releases/download/v0.8.8/jq-web.tar.gz",
     "morgan": "^1.10.0",
+    "morgan-body": "^2.6.9",
     "qs": "^6.14.1",
     "typescript": "5.8.3",
     "yargs": "^17.7.2",
diff --git a/packages/mcp-server/src/http.ts b/packages/mcp-server/src/http.ts
index 42eb500..3d728ec 100644
--- a/packages/mcp-server/src/http.ts
+++ b/packages/mcp-server/src/http.ts
@@ -4,6 +4,7 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp';
 import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
 import express from 'express';
 import morgan from 'morgan';
+import morganBody from 'morgan-body';
 import { McpOptions } from './options';
 import { ClientOptions, initMcpServer, newMcpServer } from './server';
 import { parseAuthHeaders } from './headers';
@@ -76,14 +77,26 @@ const del = async (req: express.Request, res: express.Response) => {
 export const streamableHTTPApp = ({
   clientOptions = {},
   mcpOptions,
+  debug,
 }: {
   clientOptions?: ClientOptions;
   mcpOptions: McpOptions;
+  debug: boolean;
 }): express.Express => {
   const app = express();
   app.set('query parser', 'extended');
   app.use(express.json());
-  app.use(morgan('combined'));
+
+  if (debug) {
+    morganBody(app, {
+      logAllReqHeader: true,
+      logAllResHeader: true,
+      logRequestBody: true,
+      logResponseBody: true,
+    });
+  } else {
+    app.use(morgan('combined'));
+  }
 
   app.get('/', get);
   app.post('/', post({ clientOptions, mcpOptions }));
@@ -92,9 +105,13 @@ export const streamableHTTPApp = ({
   return app;
 };
 
-export const launchStreamableHTTPServer = async (options: McpOptions, port: number | string | undefined) => {
-  const app = streamableHTTPApp({ mcpOptions: options });
-  const server = app.listen(port);
+export const launchStreamableHTTPServer = async (params: {
+  mcpOptions: McpOptions;
+  debug: boolean;
+  port: number | string | undefined;
+}) => {
+  const app = streamableHTTPApp({ mcpOptions: params.mcpOptions, debug: params.debug });
+  const server = app.listen(params.port);
   const address = server.address();
 
   if (typeof address === 'string') {
@@ -102,6 +119,6 @@ export const launchStreamableHTTPServer = async (options: McpOptions, port: numb
   } else if (address !== null) {
     console.error(`MCP Server running on streamable HTTP on port ${address.port}`);
   } else {
-    console.error(`MCP Server running on streamable HTTP on port ${port}`);
+    console.error(`MCP Server running on streamable HTTP on port ${params.port}`);
   }
 };
diff --git a/packages/mcp-server/src/index.ts b/packages/mcp-server/src/index.ts
index 0f6dd42..d75968e 100644
--- a/packages/mcp-server/src/index.ts
+++ b/packages/mcp-server/src/index.ts
@@ -21,7 +21,11 @@ async function main() {
       await launchStdioServer();
       break;
     case 'http':
-      await launchStreamableHTTPServer(options, options.port ?? options.socket);
+      await launchStreamableHTTPServer({
+        mcpOptions: options,
+        debug: options.debug,
+        port: options.port ?? options.socket,
+      });
       break;
   }
 }
diff --git a/packages/mcp-server/src/options.ts b/packages/mcp-server/src/options.ts
index 025280e..7438083 100644
--- a/packages/mcp-server/src/options.ts
+++ b/packages/mcp-server/src/options.ts
@@ -4,6 +4,7 @@ import { hideBin } from 'yargs/helpers';
 import z from 'zod';
 
 export type CLIOptions = McpOptions & {
+  debug: boolean;
   transport: 'stdio' | 'http';
   port: number | undefined;
   socket: string | undefined;
@@ -15,17 +16,24 @@ export type McpOptions = {
 
 export function parseCLIOptions(): CLIOptions {
   const opts = yargs(hideBin(process.argv))
-    .option('tools', {
+    .option('debug', { type: 'boolean', description: 'Enable debug logging' })
+    .option('no-tools', {
       type: 'string',
       array: true,
       choices: ['code', 'docs'],
-      description: 'Use dynamic tools or all tools',
+      description: 'Tools to explicitly disable',
     })
-    .option('no-tools', {
+    .option('port', {
+      type: 'number',
+      default: 3000,
+      description: 'Port to serve on if using http transport',
+    })
+    .option('socket', { type: 'string', description: 'Unix socket to serve on if using http transport' })
+    .option('tools', {
       type: 'string',
       array: true,
       choices: ['code', 'docs'],
-      description: 'Do not use any dynamic or all tools',
+      description: 'Tools to explicitly enable',
     })
     .option('transport', {
       type: 'string',
@@ -33,15 +41,8 @@ export function parseCLIOptions(): CLIOptions {
       default: 'stdio',
       description: 'What transport to use; stdio for local servers or http for remote servers',
     })
-    .option('port', {
-      type: 'number',
-      default: 3000,
-      description: 'Port to serve on if using http transport',
-    })
-    .option('socket', {
-      type: 'string',
-      description: 'Unix socket to serve on if using http transport',
-    })
+    .env('MCP_SERVER')
+    .version(true)
     .help();
 
   const argv = opts.parseSync();
@@ -57,6 +58,7 @@ export function parseCLIOptions(): CLIOptions {
 
   return {
     ...(includeDocsTools !== undefined && { includeDocsTools }),
+    debug: !!argv.debug,
     transport,
     port: argv.port,
     socket: argv.socket,

From 26f830ef8a93862ba2902f9bdd0a2cd53a1865f3 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Thu, 5 Feb 2026 03:15:23 +0000
Subject: [PATCH 06/10] feat(mcp): add initial server instructions

Adds generated MCP server instructions, to help agents get easy tasks on the first try.
---
 packages/mcp-server/src/http.ts   | 10 +++----
 packages/mcp-server/src/server.ts | 48 +++++++++++++++++++++++++++----
 packages/mcp-server/src/stdio.ts  |  4 +--
 3 files changed, 49 insertions(+), 13 deletions(-)

diff --git a/packages/mcp-server/src/http.ts b/packages/mcp-server/src/http.ts
index 3d728ec..1f851cb 100644
--- a/packages/mcp-server/src/http.ts
+++ b/packages/mcp-server/src/http.ts
@@ -9,7 +9,7 @@ import { McpOptions } from './options';
 import { ClientOptions, initMcpServer, newMcpServer } from './server';
 import { parseAuthHeaders } from './headers';
 
-const newServer = ({
+const newServer = async ({
   clientOptions,
   req,
   res,
@@ -17,12 +17,12 @@ const newServer = ({
   clientOptions: ClientOptions;
   req: express.Request;
   res: express.Response;
-}): McpServer | null => {
-  const server = newMcpServer();
+}): Promise<McpServer | null> => {
+  const server = await newMcpServer();
 
   try {
     const authOptions = parseAuthHeaders(req, false);
-    initMcpServer({
+    await initMcpServer({
       server: server,
       clientOptions: {
         ...clientOptions,
@@ -46,7 +46,7 @@ const newServer = ({
 const post =
   (options: { clientOptions: ClientOptions; mcpOptions: McpOptions }) =>
   async (req: express.Request, res: express.Response) => {
-    const server = newServer({ ...options, req, res });
+    const server = await newServer({ ...options, req, res });
     // If we return null, we already set the authorization error.
     if (server === null) return;
     const transport = new StreamableHTTPServerTransport();
diff --git a/packages/mcp-server/src/server.ts b/packages/mcp-server/src/server.ts
index 14dc9ba..816de0e 100644
--- a/packages/mcp-server/src/server.ts
+++ b/packages/mcp-server/src/server.ts
@@ -17,23 +17,59 @@ import { HandlerFunction, McpTool } from './types';
 export { McpOptions } from './options';
 export { ClientOptions } from 'brand.dev';
 
-export const newMcpServer = () =>
+async function getInstructions() {
+  // This API key is optional; providing it allows the server to fetch instructions for unreleased versions.
+  const stainlessAPIKey = readEnv('STAINLESS_API_KEY');
+  const response = await fetch(
+    readEnv('CODE_MODE_INSTRUCTIONS_URL') ?? 'https://api.stainless.com/api/ai/instructions/brand.dev',
+    {
+      method: 'GET',
+      headers: { ...(stainlessAPIKey && { Authorization: stainlessAPIKey }) },
+    },
+  );
+
+  let instructions: string | undefined;
+  if (!response.ok) {
+    console.warn(
+      'Warning: failed to retrieve MCP server instructions. Proceeding with default instructions...',
+    );
+
+    instructions = `
+      This is the brand.dev MCP server. You will use Code Mode to help the user perform
+      actions. You can use search_docs tool to learn about how to take action with this server. Then, 
+      you will write TypeScript code using the execute tool take action. It is CRITICAL that you be 
+      thoughtful and deliberate when executing code. Always try to entirely solve the problem in code 
+      block: it can be as long as you need to get the job done! 
+    `;
+  }
+
+  instructions ??= ((await response.json()) as { instructions: string }).instructions;
+  instructions = `
+    The current time in Unix timestamps is ${Date.now()}.
+
+    ${instructions}
+  `;
+
+  return instructions;
+}
+
+export const newMcpServer = async () =>
   new McpServer(
     {
       name: 'brand_dev_api',
       version: '0.22.0',
     },
-    { capabilities: { tools: {}, logging: {} } },
+    {
+      instructions: await getInstructions(),
+      capabilities: { tools: {}, logging: {} },
+    },
   );
 
-// Create server instance
-export const server = newMcpServer();
-
 /**
  * Initializes the provided MCP Server with the given tools and handlers.
  * If not provided, the default client, tools and handlers will be used.
  */
-export function initMcpServer(params: {
+export async function initMcpServer(params: {
   server: Server | McpServer;
   clientOptions?: ClientOptions;
   mcpOptions?: McpOptions;
diff --git a/packages/mcp-server/src/stdio.ts b/packages/mcp-server/src/stdio.ts
index f07696f..47aeb0c 100644
--- a/packages/mcp-server/src/stdio.ts
+++ b/packages/mcp-server/src/stdio.ts
@@ -2,9 +2,9 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import { initMcpServer, newMcpServer } from './server';
 
 export const launchStdioServer = async () => {
-  const server = newMcpServer();
+  const server = await newMcpServer();
 
-  initMcpServer({ server });
+  await initMcpServer({ server });
 
   const transport = new StdioServerTransport();
   await server.connect(transport);

From 18599b7afc117f6fc533ab109183ef779208da83 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Fri, 6 Feb 2026 03:24:59 +0000
Subject: [PATCH 07/10] fix(client): avoid removing abort listener too early

---
 src/client.ts | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/client.ts b/src/client.ts
index 82bf6f9..ff11849 100644
--- a/src/client.ts
+++ b/src/client.ts
@@ -547,7 +547,6 @@ export class BrandDev {
       return await this.fetch.call(undefined, url, fetchOptions);
     } finally {
       clearTimeout(timeout);
-      if (signal) signal.removeEventListener('abort', abort);
     }
   }
 

From 66562a1949b45cac368d71004fb9238859011cb4 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sat, 7 Feb 2026 03:24:22 +0000
Subject: [PATCH 08/10] chore(internal): add health check to MCP server when
 running in HTTP mode

---
 packages/mcp-server/src/http.ts   | 3 +++
 packages/mcp-server/src/server.ts | 8 ++++----
 2 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/packages/mcp-server/src/http.ts b/packages/mcp-server/src/http.ts
index 1f851cb..b203136 100644
--- a/packages/mcp-server/src/http.ts
+++ b/packages/mcp-server/src/http.ts
@@ -98,6 +98,9 @@ export const streamableHTTPApp = ({
     app.use(morgan('combined'));
   }
 
+  app.get('/health', async (req: express.Request, res: express.Response) => {
+    res.status(200).send('OK');
+  });
   app.get('/', get);
   app.post('/', post({ clientOptions, mcpOptions }));
   app.delete('/', del);
diff --git a/packages/mcp-server/src/server.ts b/packages/mcp-server/src/server.ts
index 816de0e..3332ace 100644
--- a/packages/mcp-server/src/server.ts
+++ b/packages/mcp-server/src/server.ts
@@ -36,10 +36,10 @@ async function getInstructions() {
 
     instructions = `
       This is the brand.dev MCP server. You will use Code Mode to help the user perform
-      actions. You can use search_docs tool to learn about how to take action with this server. Then, 
-      you will write TypeScript code using the execute tool take action. It is CRITICAL that you be 
-      thoughtful and deliberate when executing code. Always try to entirely solve the problem in code 
-      block: it can be as long as you need to get the job done! 
+      actions. You can use search_docs tool to learn about how to take action with this server. Then,
+      you will write TypeScript code using the execute tool take action. It is CRITICAL that you be
+      thoughtful and deliberate when executing code. Always try to entirely solve the problem in code
+      block: it can be as long as you need to get the job done!
     `;
   }
 

From fc0f307bf17f59c98c78310ebc2ccecc2b5ac355 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sat, 7 Feb 2026 22:52:38 +0000
Subject: [PATCH 09/10] feat(api): api update

---
 .stats.yml                        |  4 ++--
 src/resources/brand.ts            | 13 +++++++++++--
 tests/api-resources/brand.test.ts | 13 ++-----------
 3 files changed, 15 insertions(+), 15 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index 69f3e77..ef7f019 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 15
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/brand-dev%2Fbrand.dev-737dbedd830e2c989387e90a9bb5baa3915306ecfef2e46b09d02cb1879f043c.yml
-openapi_spec_hash: 7bc21f4c6d5fd39c1a3b22626846ca87
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/brand-dev%2Fbrand.dev-73562e26b663cf10185b9e98966accf5f151c6d3cf99b5e060ce5a847045e383.yml
+openapi_spec_hash: bf5994966b84f9dda998ad5059ff8318
 config_hash: 6f10592c7d0c3bafefc1271472283217
diff --git a/src/resources/brand.ts b/src/resources/brand.ts
index abb78a0..a4cd9b4 100644
--- a/src/resources/brand.ts
+++ b/src/resources/brand.ts
@@ -4664,9 +4664,18 @@ export interface BrandRetrieveParams {
 
 export interface BrandAIProductsParams {
   /**
-   * The domain name to analyze
+   * A specific URL to use directly as the starting point for extraction without
+   * domain resolution. Useful when you want to extract products from a specific page
+   * rather than discovering the site's product pages automatically. Either 'domain'
+   * or 'directUrl' must be provided, but not both.
    */
-  domain: string;
+  directUrl?: string;
+
+  /**
+   * The domain name to analyze. Either 'domain' or 'directUrl' must be provided, but
+   * not both.
+   */
+  domain?: string;
 
   /**
    * Maximum number of products to extract.
diff --git a/tests/api-resources/brand.test.ts b/tests/api-resources/brand.test.ts
index 63302e7..a84bc09 100644
--- a/tests/api-resources/brand.test.ts
+++ b/tests/api-resources/brand.test.ts
@@ -31,8 +31,8 @@ describe('resource brand', () => {
   });
 
   // Prism tests are disabled
-  test.skip('aiProducts: only required params', async () => {
-    const responsePromise = client.brand.aiProducts({ domain: 'domain' });
+  test.skip('aiProducts', async () => {
+    const responsePromise = client.brand.aiProducts({});
     const rawResponse = await responsePromise.asResponse();
     expect(rawResponse).toBeInstanceOf(Response);
     const response = await responsePromise;
@@ -42,15 +42,6 @@ describe('resource brand', () => {
     expect(dataAndResponse.response).toBe(rawResponse);
   });
 
-  // Prism tests are disabled
-  test.skip('aiProducts: required and optional params', async () => {
-    const response = await client.brand.aiProducts({
-      domain: 'domain',
-      maxProducts: 1,
-      timeoutMS: 1,
-    });
-  });
-
   // Prism tests are disabled
   test.skip('aiQuery: only required params', async () => {
     const responsePromise = client.brand.aiQuery({

From 4f82218728dbe3f1261d19133ab44f24c123d0fc Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sat, 7 Feb 2026 22:52:55 +0000
Subject: [PATCH 10/10] release: 0.23.0

---
 .release-please-manifest.json     |  2 +-
 CHANGELOG.md                      | 24 ++++++++++++++++++++++++
 package.json                      |  2 +-
 packages/mcp-server/package.json  |  2 +-
 packages/mcp-server/src/server.ts |  2 +-
 src/version.ts                    |  2 +-
 6 files changed, 29 insertions(+), 5 deletions(-)

diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index 788b0fa..97bce11 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.22.0"
+  ".": "0.23.0"
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 99fbc8d..8d5a38c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,29 @@
 # Changelog
 
+## 0.23.0 (2026-02-07)
+
+Full Changelog: [v0.22.0...v0.23.0](https://github.com/brand-dot-dev/typescript-sdk/compare/v0.22.0...v0.23.0)
+
+### Features
+
+* **api:** api update ([fc0f307](https://github.com/brand-dot-dev/typescript-sdk/commit/fc0f307bf17f59c98c78310ebc2ccecc2b5ac355))
+* **mcp:** add initial server instructions ([26f830e](https://github.com/brand-dot-dev/typescript-sdk/commit/26f830ef8a93862ba2902f9bdd0a2cd53a1865f3))
+
+
+### Bug Fixes
+
+* **client:** avoid memory leak with abort signals ([60a5820](https://github.com/brand-dot-dev/typescript-sdk/commit/60a5820c6194a717c6a795b5c9aa40510f03c744))
+* **client:** avoid removing abort listener too early ([18599b7](https://github.com/brand-dot-dev/typescript-sdk/commit/18599b7afc117f6fc533ab109183ef779208da83))
+
+
+### Chores
+
+* **client:** do not parse responses with empty content-length ([00c1b99](https://github.com/brand-dot-dev/typescript-sdk/commit/00c1b991097b8681c8187edb2697259964d9f195))
+* **client:** restructure abort controller binding ([8dcedeb](https://github.com/brand-dot-dev/typescript-sdk/commit/8dcedeb141df02789f5693034f8508d6f5d649ee))
+* **internal:** add health check to MCP server when running in HTTP mode ([66562a1](https://github.com/brand-dot-dev/typescript-sdk/commit/66562a1949b45cac368d71004fb9238859011cb4))
+* **internal:** refactor flag parsing for MCP servers and add debug flag ([fc3bcca](https://github.com/brand-dot-dev/typescript-sdk/commit/fc3bcca431450e2cb886638003a1aeaebf41a210))
+* **internal:** support oauth authorization code flow for MCP servers ([55744a2](https://github.com/brand-dot-dev/typescript-sdk/commit/55744a2b31a70642e6338d615d7e20fa522d1181))
+
 ## 0.22.0 (2026-02-02)
 
 Full Changelog: [v0.21.0...v0.22.0](https://github.com/brand-dot-dev/typescript-sdk/compare/v0.21.0...v0.22.0)
diff --git a/package.json b/package.json
index 25533e1..bc39cdb 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "brand.dev",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "description": "The official TypeScript library for the Brand Dev API",
   "author": "Brand Dev <hello@brand.dev>",
   "types": "dist/index.d.ts",
diff --git a/packages/mcp-server/package.json b/packages/mcp-server/package.json
index 21a0b19..8aa690e 100644
--- a/packages/mcp-server/package.json
+++ b/packages/mcp-server/package.json
@@ -1,6 +1,6 @@
 {
   "name": "brand.dev-mcp",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "description": "The official MCP Server for the Brand Dev API",
   "author": "Brand Dev <hello@brand.dev>",
   "types": "dist/index.d.ts",
diff --git a/packages/mcp-server/src/server.ts b/packages/mcp-server/src/server.ts
index 3332ace..0bb5f2f 100644
--- a/packages/mcp-server/src/server.ts
+++ b/packages/mcp-server/src/server.ts
@@ -57,7 +57,7 @@ export const newMcpServer = async () =>
   new McpServer(
     {
       name: 'brand_dev_api',
-      version: '0.22.0',
+      version: '0.23.0',
     },
     {
       instructions: await getInstructions(),
diff --git a/src/version.ts b/src/version.ts
index db66d33..d77fad4 100644
--- a/src/version.ts
+++ b/src/version.ts
@@ -1 +1 @@
-export const VERSION = '0.22.0'; // x-release-please-version
+export const VERSION = '0.23.0'; // x-release-please-version