👌 IMPROVE: agent.run with mcp support

.editorconfig

@@ -0,0 +1,12 @@
+root = true
+
+[*]
+indent_style = tab
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.yml]
+indent_style = space
+indent_size = 2

.prettierrc.json

@@ -0,0 +1,9 @@
+{
+	"trailingComma": "none",
+	"arrowParens": "avoid",
+	"singleQuote": true,
+	"printWidth": 80,
+	"useTabs": true,
+	"tabWidth": 4,
+	"semi": true
+}

packages/cli/README.md

@@ -3,56 +3,63 @@
 The Langbase CLI is a command-line interface for Langbase. It provides a set of commands to interact with the Langbase SDK and perform various tasks related to AI development.
 
 ## Usage
+
 ### Langbase Docs MCP Server
 
 Integrate the Langbase Docs MCP server into your IDEs and Claude Desktop.
 
 #### Cursor
+
 - Open Cursor settings
 - Navigate to the MCP settings
 - Click on the `+` button to add a new global MCP server
 - Paste the following configuration in the `mcp.json` file:
+
 ```json
 {
-    "mcpServers": {
-        "Langbase": {
-        "command": "npx",
-        "args": ["@langbase/cli","docs-mcp-server"]
-        }
-    }
+	"mcpServers": {
+		"Langbase": {
+			"command": "npx",
+			"args": ["@langbase/cli", "docs-mcp-server"]
+		}
+	}
 }
 ```
 
 #### Windsurf
+
 - Navigate to Windsurf - Settings > Advanced Settings
 - You will find the option to Add Server
 - Click “Add custom server +”
 - Paste the following configuration in the `mcp_config.json` file:
+
 ```json
 {
-    "mcpServers": {
-        "Langbase": {
-            "command": "npx",
-            "args": ["@langbase/cli", "docs-mcp-server"]
-        }
-    }
+	"mcpServers": {
+		"Langbase": {
+			"command": "npx",
+			"args": ["@langbase/cli", "docs-mcp-server"]
+		}
+	}
 }
 ```
 
 #### Claude Desktop
+
 - Open Claude Desktop File Menu
 - Navigate to the settings
 - Go to Developer Tab
 - Click on the Edit Config button
 - Paste the following configuration in the `claude_desktop_config.json` file:
+
 ```json
 {
-    "mcpServers": {
-        "Langbase": {
-            "command": "npx",
-            "args": ["@langbase/cli", "docs-mcp-server"]
-        }
-    }
+	"mcpServers": {
+		"Langbase": {
+			"command": "npx",
+			"args": ["@langbase/cli", "docs-mcp-server"]
+		}
+	}
 }
 ```
 

packages/langbase/src/langbase/langbase.ts

@@ -43,6 +43,7 @@ export interface AgentRunOptionsBase {
 	max_completion_tokens?: number;
 	response_format?: ResponseFormat;
 	customModelParams?: Record<string, any>;
+	mcp_servers?: McpServerSchema[];
 }
 
 export interface AgentRunOptions extends AgentRunOptionsBase {
@@ -96,6 +97,18 @@ export interface AgentRunResponse {
 	};
 }
 
+export interface McpServerSchema {
+	name: string;
+	type: 'url';
+	url: string;
+	authorization_token?: string | null;
+	tool_configuration?: {
+		allowed_tools?: string[] | null;
+		enabled?: boolean;
+	} | null;
+	custom_headers?: any | null;
+}
+
 export interface RunResponseStream {
 	stream: ReadableStream<any>;
 	threadId: string | null;