@brave/brave-search-mcp-server 2.0.68 → 2.0.69

package/README.md

@@ -114,11 +114,12 @@ The server supports the following environment variables:
 
 - `BRAVE_API_KEY`: Your Brave Search API key (required)
 - `BRAVE_MCP_TRANSPORT`: Transport mode ("http" or "stdio", default: "stdio")
-- `BRAVE_MCP_PORT`: HTTP server port (default: 8080)
+- `BRAVE_MCP_PORT`: HTTP server port (default: 8000)
 - `BRAVE_MCP_HOST`: HTTP server host (default: "0.0.0.0")
 - `BRAVE_MCP_LOG_LEVEL`: Desired logging level("debug", "info", "notice", "warning", "error", "critical", "alert", or "emergency", default: "info")
 - `BRAVE_MCP_ENABLED_TOOLS`: When used, specifies a whitelist for supported tools
 - `BRAVE_MCP_DISABLED_TOOLS`: When used, specifies a blacklist for supported tools
+- `BRAVE_MCP_STATELESS`: HTTP stateless mode (default: "true").  When running on Amazon Bedrock Agentcore, set to "true".
 
 ### Command Line Options
 
@@ -133,6 +134,7 @@ Options:
   --logging-level <string>    Desired logging level (one of _debug_, _info_, _notice_, _warning_, _error_, _critical_, _alert_, or _emergency_)
   --enabled-tools             Tools whitelist (only the specified tools will be enabled)
   --disabled-tools            Tools blacklist (included tools will be disabled)
+  --stateless  <boolean>      HTTP Stateless flag
 ```
 
 ## Installation

package/dist/config.js

@@ -32,6 +32,11 @@ export const configSchema = z.object({
         .default('info')
         .describe('Desired logging level')
         .optional(),
+    stateless: z
+        .boolean()
+        .default(false)
+        .describe('Whether the server should be stateless')
+        .optional(),
 });
 const state = {
     transport: 'stdio',
@@ -42,6 +47,7 @@ const state = {
     ready: false,
     enabledTools: [],
     disabledTools: [],
+    stateless: false,
 };
 export function isToolPermittedByUser(toolName) {
     return state.enabledTools.length > 0
@@ -53,10 +59,11 @@ export function getOptions() {
         .option('--brave-api-key <string>', 'Brave API key', process.env.BRAVE_API_KEY ?? '')
         .option('--logging-level <string>', 'Logging level', process.env.BRAVE_MCP_LOG_LEVEL ?? 'info')
         .option('--transport <stdio|http>', 'transport type', process.env.BRAVE_MCP_TRANSPORT ?? 'stdio')
-        .option('--enabled-tools <names...>', 'tools to enable', process.env.BRAVE_MCP_ENABLED_TOOLS?.split(' ') ?? [])
-        .option('--disabled-tools <names...>', 'tools to disable', process.env.BRAVE_MCP_DISABLED_TOOLS?.split(' ') ?? [])
+        .option('--enabled-tools <names...>', 'tools to enable', process.env.BRAVE_MCP_ENABLED_TOOLS?.trim().split(' ') ?? [])
+        .option('--disabled-tools <names...>', 'tools to disable', process.env.BRAVE_MCP_DISABLED_TOOLS?.trim().split(' ') ?? [])
         .option('--port <number>', 'desired port for HTTP transport', process.env.BRAVE_MCP_PORT ?? '8080')
         .option('--host <string>', 'desired host for HTTP transport', process.env.BRAVE_MCP_HOST ?? '0.0.0.0')
+        .option('--stateless <boolean>', 'whether the server should be stateless', process.env.BRAVE_MCP_STATELESS === 'true' ? true : false)
         .allowUnknownOption()
         .parse(process.argv);
     const options = program.opts();
@@ -67,7 +74,7 @@ export function getOptions() {
         console.error('Error: --enabled-tools and --disabled-tools cannot be used together');
         return false;
     }
-    if ([...enabledTools, ...disabledTools].some((t) => !toolNames.includes(t))) {
+    if ([...enabledTools, ...disabledTools].some((t) => t.trim().length > 0 && !toolNames.includes(t.trim()))) {
         console.error(`Invalid tool name used. Must be one of: ${toolNames.join(', ')}`);
         return false;
     }
@@ -94,6 +101,8 @@ export function getOptions() {
             return false;
         }
     }
+    // Normalize stateless to boolean (CLI passes it as string)
+    options.stateless = options.stateless === true || options.stateless === 'true';
     // Update state
     state.braveApiKey = options.braveApiKey;
     state.transport = options.transport;
@@ -102,6 +111,7 @@ export function getOptions() {
     state.loggingLevel = options.loggingLevel;
     state.enabledTools = options.enabledTools;
     state.disabledTools = options.disabledTools;
+    state.stateless = options.stateless;
     state.ready = true;
     return options;
 }

package/dist/protocols/http.js

@@ -28,13 +28,22 @@ const getTransport = async (request) => {
         await mcpServer.connect(transport);
         return transport;
     }
-    // Otherwise, start a new transport/session
-    const transport = new StreamableHTTPServerTransport({
-        sessionIdGenerator: () => randomUUID(),
-        onsessioninitialized: (sessionId) => {
-            transports.set(sessionId, transport);
-        },
-    });
+    let transport;
+    if (config.stateless) {
+        // Some contexts (e.g. AgentCore) may prefer or require a stateless transport
+        transport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: undefined,
+        });
+    }
+    else {
+        // Otherwise, start a new transport/session
+        transport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: () => randomUUID(),
+            onsessioninitialized: (sessionId) => {
+                transports.set(sessionId, transport);
+            },
+        });
+    }
     const mcpServer = createMcpServer();
     await mcpServer.connect(transport);
     return transport;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@brave/brave-search-mcp-server",
   "mcpName": "io.github.brave/brave-search-mcp-server",
-  "version": "2.0.68",
+  "version": "2.0.69",
   "description": "Brave Search MCP Server: web results, images, videos, rich results, AI summaries, and more.",
   "keywords": [
     "api",