Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.
Python ai-agentsai-toolsbrowser-agentbrowser-automationbrowser-usecdpcloud-browsercomputer-useheadless-browserllmmcpplaywrightpythonremote-browserstealth-browserweb-automationweb-scraping
chore: pin release dependencies for 0.13.10
MagMuellerb1ae95ec8158
diff --git a/browser_use/mcp/cli_mcp.py b/browser_use/mcp/cli_mcp.pyindex e1aa86105..b3c3d7543 100644--- a/browser_use/mcp/cli_mcp.py+++ b/browser_use/mcp/cli_mcp.py@@ -12,8 +12,7 @@ from typing import Anyimport mcp.server.stdioimport mcp.types as types-from mcp.server import NotificationOptions, Server-from mcp.server.models import InitializationOptions+from mcp.server import Serverfrom browser_use.utils import get_browser_use_version@@ -34,7 +33,11 @@ class CLIMCPServer:"""Stateful stdio MCP server wrapping the browser-harness exec model."""def __init__(self):- self.server: Server = Server('browser-use')+ self.server: Server = Server(+ 'browser-use',+ version=get_browser_use_version(),+ instructions=self._instructions(),+ )self._namespace: dict[str, Any] | None = Noneself._exec_lock = asyncio.Lock()self._register_handlers()@@ -50,7 +53,7 @@ class CLIMCPServer:'persists across calls. Returns whatever the code prints. First navigation ''should be new_tab(url).'),- inputSchema={+ input_schema={'type': 'object','properties': {'code': {'type': 'string', 'description': 'Python code to execute'},@@ -61,7 +64,7 @@ class CLIMCPServer:types.Tool(name='browser_screenshot',description='Capture the current page and return it as an image. Prefer this over capture_screenshot() in browser_exec.',- inputSchema={+ input_schema={'type': 'object','properties': {'full': {'type': 'boolean', 'description': 'Capture beyond the viewport (full page)', 'default': False},@@ -76,28 +79,40 @@ class CLIMCPServer:]def _register_handlers(self):- @self.server.list_tools()- async def handle_list_tools() -> list[types.Tool]:- return self._tool_definitions()+ async def handle_list_tools(_context: Any, _params: types.PaginatedRequestParams) -> types.ListToolsResult:+ return types.ListToolsResult(tools=self._tool_definitions())- @self.server.call_tool()- async def handle_call_tool(name: str, arguments: dict[str, Any] | None) -> list[types.TextContent | types.ImageContent]:- arguments = arguments or {}+ async def handle_call_tool(_context: Any, params: types.CallToolRequestParams) -> types.CallToolResult:+ name = params.name+ arguments = params.arguments or {}if name == 'browser_exec':code = arguments.get('code')if not isinstance(code, str) or not code.strip():- return [types.TextContent(type='text', text="Error: 'code' must be a non-empty string")]+ return types.CallToolResult(+ content=[types.TextContent(type='text', text="Error: 'code' must be a non-empty string")],+ is_error=True,+ )async with self._exec_lock:output = await asyncio.to_thread(self._execute, code)- return [types.TextContent(type='text', text=output or '(no output)')]+ return types.CallToolResult(content=[types.TextContent(type='text', text=output or '(no output)')])if name == 'browser_screenshot':max_dim = arguments.get('max_dim')if max_dim is not None and (isinstance(max_dim, bool) or not isinstance(max_dim, int) or max_dim < 1):- return [types.TextContent(type='text', text="Error: 'max_dim' must be a positive integer")]+ return types.CallToolResult(+ content=[types.TextContent(type='text', text="Error: 'max_dim' must be a positive integer")],+ is_error=True,+ )async with self._exec_lock:png = await asyncio.to_thread(self._screenshot, bool(arguments.get('full', False)), max_dim)- return [types.ImageContent(type='image', data=png, mimeType='image/png')]- return [types.TextContent(type='text', text=f'Unknown tool: {name}')]+ content: list[types.ContentBlock] = [types.ImageContent(type='image', data=png, mime_type='image/png')]+ return types.CallToolResult(content=content)+ return types.CallToolResult(+ content=[types.TextContent(type='text', text=f'Unknown tool: {name}')],+ is_error=True,+ )++ self.server.add_request_handler('tools/list', types.PaginatedRequestParams, handle_list_tools)+ self.server.add_request_handler('tools/call', types.CallToolRequestParams, handle_call_tool)def _ensure_namespace(self) -> dict[str, Any]:if self._namespace is None:@@ -151,15 +166,7 @@ class CLIMCPServer:await self.server.run(read_stream,write_stream,- InitializationOptions(- server_name='browser-use',- server_version=get_browser_use_version(),- instructions=self._instructions(),- capabilities=self.server.get_capabilities(- notification_options=NotificationOptions(),- experimental_capabilities={},- ),- ),+ self.server.create_initialization_options(),)except BrokenPipeError:passdiff --git a/browser_use/mcp/client.py b/browser_use/mcp/client.pyindex 36dbf9856..40363c716 100644--- a/browser_use/mcp/client.py+++ b/browser_use/mcp/client.py@@ -256,10 +256,10 @@ class MCPClient:# Parse tool parameters to create Pydantic modelparam_fields = {}- if tool.inputSchema:+ if tool.input_schema:# MCP tools use JSON Schema for parameters- properties = tool.inputSchema.get('properties', {})- required = set(tool.inputSchema.get('required', []))+ properties = tool.input_schema.get('properties', {})+ required = set(tool.input_schema.get('required', []))for param_name, param_schema in properties.items():# Convert JSON Schema type to Python type@@ -326,7 +326,7 @@ class MCPClient:# Convert MCP result to ActionResultextracted_content = self._format_mcp_result(result)- if getattr(result, 'isError', False):+ if result.is_error:error_msg = f"MCP tool '{tool.name}' reported an error: {extracted_content}"return ActionResult(error=error_msg, success=False)@@ -374,7 +374,7 @@ class MCPClient:# Convert MCP result to ActionResultextracted_content = self._format_mcp_result(result)- if getattr(result, 'isError', False):+ if result.is_error:error_msg = f"MCP tool '{tool.name}' reported an error: {extracted_content}"return ActionResult(error=error_msg, success=False)diff --git a/browser_use/mcp/controller.py b/browser_use/mcp/controller.pyindex 11c06e8e0..8f140ec91 100644--- a/browser_use/mcp/controller.py+++ b/browser_use/mcp/controller.py@@ -101,10 +101,10 @@ class MCPToolWrapper:# Parse tool parameters to create Pydantic modelparam_fields = {}- if tool.inputSchema:+ if tool.input_schema:# MCP tools use JSON Schema for parameters- properties = tool.inputSchema.get('properties', {})- required = set(tool.inputSchema.get('required', []))+ properties = tool.input_schema.get('properties', {})+ required = set(tool.input_schema.get('required', []))for param_name, param_schema in properties.items():# Convert JSON Schema type to Python typediff --git a/browser_use/mcp/server.py b/browser_use/mcp/server.pyindex e896c580b..3b5672822 100644--- a/browser_use/mcp/server.py+++ b/browser_use/mcp/server.py@@ -133,8 +133,7 @@ _ensure_all_loggers_use_stderr()try:import mcp.server.stdioimport mcp.types as types- from mcp.server import NotificationOptions, Server- from mcp.server.models import InitializationOptions+ from mcp.server import ServerMCP_AVAILABLE = True@@ -191,7 +190,7 @@ class BrowserUseServer:# Ensure all logging goes to stderr (in case new loggers were created)_ensure_all_loggers_use_stderr()- self.server = Server('browser-use')+ self.server = Server('browser-use', version=get_browser_use_version())self.config = load_browser_use_config()self.agent: Agent | None = Noneself.browser_session: BrowserSession | None = None@@ -212,271 +211,276 @@ class BrowserUseServer:def _setup_handlers(self):"""Setup MCP server handlers."""- @self.server.list_tools()- async def handle_list_tools() -> list[types.Tool]:+ async def handle_list_tools(_context: Any, _params: types.PaginatedRequestParams) -> types.ListToolsResult:"""List all available browser-use tools."""- return [- # Agent tools- # Direct browser control tools- types.Tool(- name='browser_navigate',- description='Navigate to a URL in the browser',- inputSchema={- 'type': 'object',- 'properties': {- 'url': {'type': 'string', 'description': 'The URL to navigate to'},- 'new_tab': {'type': 'boolean', 'description': 'Whether to open in a new tab', 'default': False},- },- 'required': ['url'],- },- ),- types.Tool(- name='browser_click',- description='Click an element by index or at specific viewport coordinates. Use index for elements from browser_get_state, or coordinate_x/coordinate_y for pixel-precise clicking.',- inputSchema={- 'type': 'object',- 'properties': {- 'index': {- 'type': 'integer',- 'description': 'The index of the element to click (from browser_get_state). Provide this OR coordinate_x+coordinate_y.',- },- 'coordinate_x': {- 'type': 'integer',- 'description': 'X coordinate in pixels from the left edge of the viewport. Must be used together with coordinate_y. Provide this OR index.',+ return types.ListToolsResult(+ tools=[+ # Agent tools+ # Direct browser control tools+ types.Tool(+ name='browser_navigate',+ description='Navigate to a URL in the browser',+ input_schema={+ 'type': 'object',+ 'properties': {+ 'url': {'type': 'string', 'description': 'The URL to navigate to'},+ 'new_tab': {'type': 'boolean', 'description': 'Whether to open in a new tab', 'default': False},},- 'coordinate_y': {- 'type': 'integer',- 'description': 'Y coordinate in pixels from the top edge of the viewport. Must be used together with coordinate_x. Provide this OR index.',+ 'required': ['url'],+ },+ ),+ types.Tool(+ name='browser_click',+ description='Click an element by index or at specific viewport coordinates. Use index for elements from browser_get_state, or coordinate_x/coordinate_y for pixel-precise clicking.',+ input_schema={+ 'type': 'object',+ 'properties': {+ 'index': {+ 'type': 'integer',+ 'description': 'The index of the element to click (from browser_get_state). Provide this OR coordinate_x+coordinate_y.',+ },+ 'coordinate_x': {+ 'type': 'integer',+ 'description': 'X coordinate in pixels from the left edge of the viewport. Must be used together with coordinate_y. Provide this OR index.',+ },+ 'coordinate_y': {+ 'type': 'integer',+ 'description': 'Y coordinate in pixels from the top edge of the viewport. Must be used together with coordinate_x. Provide this OR index.',+ },+ 'new_tab': {+ 'type': 'boolean',+ 'description': 'Whether to open any resulting navigation in a new tab',+ 'default': False,+ },},- 'new_tab': {- 'type': 'boolean',- 'description': 'Whether to open any resulting navigation in a new tab',- 'default': False,+ },+ ),+ types.Tool(+ name='browser_type',+ description='Type text into an input field. Clears existing text by default; pass text="" to clear only.',+ input_schema={+ 'type': 'object',+ 'properties': {+ 'index': {+ 'type': 'integer',+ 'description': 'The index of the input element (from browser_get_state)',+ },+ 'text': {+ 'type': 'string',+ 'description': 'The text to type. Pass an empty string ("") to clear the field without typing.',+ },},+ 'required': ['index', 'text'],},- },- ),- types.Tool(- name='browser_type',- description='Type text into an input field. Clears existing text by default; pass text="" to clear only.',- inputSchema={- 'type': 'object',- 'properties': {- 'index': {- 'type': 'integer',- 'description': 'The index of the input element (from browser_get_state)',+ ),+ types.Tool(+ name='browser_get_state',+ description='Get the current state of the page including all interactive elements',+ input_schema={+ 'type': 'object',+ 'properties': {+ 'include_screenshot': {+ 'type': 'boolean',+ 'description': 'Whether to include a screenshot of the current page',+ 'default': False,+ }},- 'text': {- 'type': 'string',- 'description': 'The text to type. Pass an empty string ("") to clear the field without typing.',+ },+ annotations=types.ToolAnnotations(read_only_hint=True),+ ),+ types.Tool(+ name='browser_extract_content',+ description='Extract structured content from the current page based on a query',+ input_schema={+ 'type': 'object',+ 'properties': {+ 'query': {'type': 'string', 'description': 'What information to extract from the page'},+ 'extract_links': {+ 'type': 'boolean',+ 'description': 'Whether to include links in the extraction',+ 'default': False,+ },},+ 'required': ['query'],},- 'required': ['index', 'text'],- },- ),- types.Tool(- name='browser_get_state',- description='Get the current state of the page including all interactive elements',- inputSchema={- 'type': 'object',- 'properties': {- 'include_screenshot': {- 'type': 'boolean',- 'description': 'Whether to include a screenshot of the current page',- 'default': False,- }+ ),+ types.Tool(+ name='browser_get_html',+ description='Get the raw HTML of the current page or a specific element by CSS selector',+ input_schema={+ 'type': 'object',+ 'properties': {+ 'selector': {+ 'type': 'string',+ 'description': 'Optional CSS selector to get HTML of a specific element. If omitted, returns full page HTML.',+ },+ },},- },- annotations=types.ToolAnnotations(readOnlyHint=True),- ),- types.Tool(- name='browser_extract_content',- description='Extract structured content from the current page based on a query',- inputSchema={- 'type': 'object',- 'properties': {- 'query': {'type': 'string', 'description': 'What information to extract from the page'},- 'extract_links': {- 'type': 'boolean',- 'description': 'Whether to include links in the extraction',- 'default': False,+ annotations=types.ToolAnnotations(read_only_hint=True),+ ),+ types.Tool(+ name='browser_screenshot',+ description='Take a screenshot of the current page. Returns viewport metadata as text and the screenshot as an image.',+ input_schema={+ 'type': 'object',+ 'properties': {+ 'full_page': {+ 'type': 'boolean',+ 'description': 'Whether to capture the full scrollable page or just the visible viewport',+ 'default': False,+ },},},- 'required': ['query'],- },- ),- types.Tool(- name='browser_get_html',- description='Get the raw HTML of the current page or a specific element by CSS selector',- inputSchema={- 'type': 'object',- 'properties': {- 'selector': {- 'type': 'string',- 'description': 'Optional CSS selector to get HTML of a specific element. If omitted, returns full page HTML.',+ annotations=types.ToolAnnotations(read_only_hint=True),+ ),+ types.Tool(+ name='browser_scroll',+ description='Scroll the page',+ input_schema={+ 'type': 'object',+ 'properties': {+ 'direction': {+ 'type': 'string',+ 'enum': ['up', 'down'],+ 'description': 'Direction to scroll',+ 'default': 'down',+ }},},- },- annotations=types.ToolAnnotations(readOnlyHint=True),- ),- types.Tool(- name='browser_screenshot',- description='Take a screenshot of the current page. Returns viewport metadata as text and the screenshot as an image.',- inputSchema={- 'type': 'object',- 'properties': {- 'full_page': {- 'type': 'boolean',- 'description': 'Whether to capture the full scrollable page or just the visible viewport',- 'default': False,+ ),+ types.Tool(+ name='browser_go_back',+ description='Go back to the previous page',+ input_schema={'type': 'object', 'properties': {}},+ ),+ # Tab management+ types.Tool(+ name='browser_list_tabs',+ description='List all open tabs',+ input_schema={'type': 'object', 'properties': {}},+ annotations=types.ToolAnnotations(read_only_hint=True),+ ),+ types.Tool(+ name='browser_switch_tab',+ description='Switch to a different tab',+ input_schema={+ 'type': 'object',+ 'properties': {+ 'tab_id': {'type': 'string', 'description': '4 Character Tab ID of the tab to switch to'}},+ 'required': ['tab_id'],},- },- annotations=types.ToolAnnotations(readOnlyHint=True),- ),- types.Tool(- name='browser_scroll',- description='Scroll the page',- inputSchema={- 'type': 'object',- 'properties': {- 'direction': {- 'type': 'string',- 'enum': ['up', 'down'],- 'description': 'Direction to scroll',- 'default': 'down',- }+ ),+ types.Tool(+ name='browser_close_tab',+ description='Close a tab',+ input_schema={+ 'type': 'object',+ 'properties': {'tab_id': {'type': 'string', 'description': '4 Character Tab ID of the tab to close'}},+ 'required': ['tab_id'],},- },- ),- types.Tool(- name='browser_go_back',- description='Go back to the previous page',- inputSchema={'type': 'object', 'properties': {}},- ),- # Tab management- types.Tool(- name='browser_list_tabs',- description='List all open tabs',- inputSchema={'type': 'object', 'properties': {}},- annotations=types.ToolAnnotations(readOnlyHint=True),- ),- types.Tool(- name='browser_switch_tab',- description='Switch to a different tab',- inputSchema={- 'type': 'object',- 'properties': {'tab_id': {'type': 'string', 'description': '4 Character Tab ID of the tab to switch to'}},- 'required': ['tab_id'],- },- ),- types.Tool(- name='browser_close_tab',- description='Close a tab',- inputSchema={- 'type': 'object',- 'properties': {'tab_id': {'type': 'string', 'description': '4 Character Tab ID of the tab to close'}},- 'required': ['tab_id'],- },- ),- # types.Tool(- # name="browser_close",- # description="Close the browser session",- # inputSchema={- # "type": "object",- # "properties": {}- # }- # ),- types.Tool(- name='retry_with_browser_use_agent',- description='Retry a task using the browser-use agent. Only use this as a last resort if you fail to interact with a page multiple times.',- inputSchema={- 'type': 'object',- 'properties': {- 'task': {- 'type': 'string',- 'description': 'The high-level goal and detailed step-by-step description of the task the AI browser agent needs to attempt, along with any relevant data needed to complete the task and info about previous attempts.',- },- 'max_steps': {- 'type': 'integer',- 'description': 'Maximum number of steps an agent can take.',- 'default': 100,- },- 'model': {- 'type': 'string',- 'description': 'LLM model to use (e.g., gpt-4o, claude-3-opus-20240229). Defaults to the configured model.',- },- 'allowed_domains': {- 'type': 'array',- 'items': {'type': 'string'},- 'description': (- 'List of domains the agent is allowed to visit (security feature). '- 'Omit to use the server-configured profile defaults. '- 'An empty list is treated the same as omitting the argument and '- 'will NOT disable server-configured restrictions.'- ),- },- 'use_vision': {- 'type': 'boolean',- 'description': 'Whether to use vision capabilities (screenshots) for the agent',- 'default': True,+ ),+ # types.Tool(+ # name="browser_close",+ # description="Close the browser session",+ # input_schema={+ # "type": "object",+ # "properties": {}+ # }+ # ),+ types.Tool(+ name='retry_with_browser_use_agent',+ description='Retry a task using the browser-use agent. Only use this as a last resort if you fail to interact with a page multiple times.',+ input_schema={+ 'type': 'object',+ 'properties': {+ 'task': {+ 'type': 'string',+ 'description': 'The high-level goal and detailed step-by-step description of the task the AI browser agent needs to attempt, along with any relevant data needed to complete the task and info about previous attempts.',+ },+ 'max_steps': {+ 'type': 'integer',+ 'description': 'Maximum number of steps an agent can take.',+ 'default': 100,+ },+ 'model': {+ 'type': 'string',+ 'description': 'LLM model to use (e.g., gpt-4o, claude-3-opus-20240229). Defaults to the configured model.',+ },+ 'allowed_domains': {+ 'type': 'array',+ 'items': {'type': 'string'},+ 'description': (+ 'List of domains the agent is allowed to visit (security feature). '+ 'Omit to use the server-configured profile defaults. '+ 'An empty list is treated the same as omitting the argument and '+ 'will NOT disable server-configured restrictions.'+ ),+ },+ 'use_vision': {+ 'type': 'boolean',+ 'description': 'Whether to use vision capabilities (screenshots) for the agent',+ 'default': True,+ },},+ 'required': ['task'],},- 'required': ['task'],- },- ),- # Browser session management tools- types.Tool(- name='browser_list_sessions',- description='List all active browser sessions with their details and last activity time',- inputSchema={'type': 'object', 'properties': {}},- annotations=types.ToolAnnotations(readOnlyHint=True),- ),- types.Tool(- name='browser_close_session',- description='Close a specific browser session by its ID',- inputSchema={- 'type': 'object',- 'properties': {- 'session_id': {- 'type': 'string',- 'description': 'The browser session ID to close (get from browser_list_sessions)',- }+ ),+ # Browser session management tools+ types.Tool(+ name='browser_list_sessions',+ description='List all active browser sessions with their details and last activity time',+ input_schema={'type': 'object', 'properties': {}},+ annotations=types.ToolAnnotations(read_only_hint=True),+ ),+ types.Tool(+ name='browser_close_session',+ description='Close a specific browser session by its ID',+ input_schema={+ 'type': 'object',+ 'properties': {+ 'session_id': {+ 'type': 'string',+ 'description': 'The browser session ID to close (get from browser_list_sessions)',+ }+ },+ 'required': ['session_id'],},- 'required': ['session_id'],- },- ),- types.Tool(- name='browser_close_all',- description='Close all active browser sessions and clean up resources',- inputSchema={'type': 'object', 'properties': {}},- ),- ]-- @self.server.list_resources()- async def handle_list_resources() -> list[types.Resource]:+ ),+ types.Tool(+ name='browser_close_all',+ description='Close all active browser sessions and clean up resources',+ input_schema={'type': 'object', 'properties': {}},+ ),+ ]+ )++ async def handle_list_resources(_context: Any, _params: types.PaginatedRequestParams) -> types.ListResourcesResult:"""List available resources (none for browser-use)."""- return []+ return types.ListResourcesResult(resources=[])- @self.server.list_prompts()- async def handle_list_prompts() -> list[types.Prompt]:+ async def handle_list_prompts(_context: Any, _params: types.PaginatedRequestParams) -> types.ListPromptsResult:"""List available prompts (none for browser-use)."""- return []+ return types.ListPromptsResult(prompts=[])- @self.server.call_tool()- async def handle_call_tool(name: str, arguments: dict[str, Any] | None) -> list[types.TextContent | types.ImageContent]:+ async def handle_call_tool(_context: Any, params: types.CallToolRequestParams) -> types.CallToolResult:"""Handle tool execution."""+ name = params.name+ arguments = params.argumentsstart_time = time.time()error_msg = Nonetry:result = await self._execute_tool(name, arguments or {})if isinstance(result, list):- return result- return [types.TextContent(type='text', text=result)]+ return types.CallToolResult(content=result)+ return types.CallToolResult(content=[types.TextContent(type='text', text=result)])except Exception as e:error_msg = str(e)logger.error(f'Tool execution failed: {e}', exc_info=True)- return [types.TextContent(type='text', text=f'Error: {str(e)}')]+ return types.CallToolResult(+ content=[types.TextContent(type='text', text=f'Error: {str(e)}')],+ is_error=True,+ )finally:# Capture telemetry for tool callsduration = time.time() - start_time@@ -490,9 +494,12 @@ class BrowserUseServer:))- async def _execute_tool(- self, tool_name: str, arguments: dict[str, Any]- ) -> str | list[types.TextContent | types.ImageContent]:+ self.server.add_request_handler('tools/list', types.PaginatedRequestParams, handle_list_tools)+ self.server.add_request_handler('resources/list', types.PaginatedRequestParams, handle_list_resources)+ self.server.add_request_handler('prompts/list', types.PaginatedRequestParams, handle_list_prompts)+ self.server.add_request_handler('tools/call', types.CallToolRequestParams, handle_call_tool)++ async def _execute_tool(self, tool_name: str, arguments: dict[str, Any]) -> str | list[types.ContentBlock]:"""Execute a browser-use tool. Returns str for most tools, or a content list for tools with image output."""# Agent-based tools@@ -537,9 +544,9 @@ class BrowserUseServer:elif tool_name == 'browser_get_state':state_json, screenshot_b64 = await self._get_browser_state(arguments.get('include_screenshot', False))- content: list[types.TextContent | types.ImageContent] = [types.TextContent(type='text', text=state_json)]+ content: list[types.ContentBlock] = [types.TextContent(type='text', text=state_json)]if screenshot_b64:- content.append(types.ImageContent(type='image', data=screenshot_b64, mimeType='image/png'))+ content.append(types.ImageContent(type='image', data=screenshot_b64, mime_type='image/png'))return contentelif tool_name == 'browser_get_html':@@ -547,9 +554,9 @@ class BrowserUseServer:elif tool_name == 'browser_screenshot':meta_json, screenshot_b64 = await self._screenshot(arguments.get('full_page', False))- content: list[types.TextContent | types.ImageContent] = [types.TextContent(type='text', text=meta_json)]+ content: list[types.ContentBlock] = [types.TextContent(type='text', text=meta_json)]if screenshot_b64:- content.append(types.ImageContent(type='image', data=screenshot_b64, mimeType='image/png'))+ content.append(types.ImageContent(type='image', data=screenshot_b64, mime_type='image/png'))return contentelif tool_name == 'browser_extract_content':@@ -1248,14 +1255,7 @@ class BrowserUseServer:await self.server.run(read_stream,write_stream,- InitializationOptions(- server_name='browser-use',- server_version='0.1.0',- capabilities=self.server.get_capabilities(- notification_options=NotificationOptions(),- experimental_capabilities={},- ),- ),+ self.server.create_initialization_options(),)except BrokenPipeError:logger.warning('MCP client disconnected while writing to stdio; shutting down server cleanly.')diff --git a/pyproject.toml b/pyproject.tomlindex 364f8fe1e..5c79c94fe 100644--- a/pyproject.toml+++ b/pyproject.toml@@ -2,7 +2,7 @@name = "browser-use"description = "Make websites accessible for AI agents"authors = [{ name = "Gregor Zunic" }]-version = "0.13.9"+version = "0.13.10"readme = "README.md"requires-python = ">=3.11,<4.0"classifiers = [@@ -21,7 +21,8 @@ dependencies = ["httpx==0.28.1","posthog==7.7.0","psutil==7.2.2",- "pydantic>=2.12.5,<2.14",+ "pydantic==2.13.5",+ "pydantic-settings==2.15.0","pyobjc==12.1; platform_system == 'darwin'","python-dotenv==1.2.2","requests==2.33.0",@@ -36,8 +37,8 @@ dependencies = ["google-api-python-client==2.188.0","google-auth==2.48.0","google-auth-oauthlib==1.2.4",- "mcp==1.28.1",- "pypdf==6.15.0",+ "mcp==2.1.1",+ "pypdf==6.16.2","reportlab==4.4.9","cdp-use==1.4.5","pyotp==2.9.0",@@ -46,7 +47,7 @@ dependencies = ["markdownify==1.2.2","python-docx==1.2.0","browser-use-sdk==3.4.2",- "browser-harness==0.1.12",+ "browser-harness==0.1.13",]# google-api-core: only used for Google LLM APIs# pyperclip: only used for examples that use copy/paste@@ -108,7 +109,7 @@ browser = "browser_use.cli:main" # Alias for browser-usebrowser-use-tui = "browser_use.cli:browser_use_tui_main" # Deprecated alias for browser-use[build-system]-requires = ["hatchling"]+requires = ["hatchling==1.32.0"]build-backend = "hatchling.build"@@ -242,5 +243,5 @@ dev-dependencies = ["lmnr[all]==0.7.42",# "pytest-playwright-asyncio>=0.7.0", # not actually needed I think"pytest-timeout==2.4.0",- "pydantic_settings==2.12.0",+ "pydantic_settings==2.15.0",]diff --git a/tests/ci/test_mcp_client_error_result.py b/tests/ci/test_mcp_client_error_result.pyindex e27a34611..cfbbcc498 100644--- a/tests/ci/test_mcp_client_error_result.py+++ b/tests/ci/test_mcp_client_error_result.py@@ -30,12 +30,12 @@ async def test_mcp_tool_isError_true_is_surfaced_as_action_result_error():client.session.call_tool = AsyncMock( # type: ignore[union-attr]return_value=types.CallToolResult(content=[types.TextContent(type='text', text='File not found: /tmp/does-not-exist.txt')],- isError=True,+ is_error=True,))tools = Tools()- tool = types.Tool(name='read_file', description='Read a file', inputSchema={'type': 'object', 'properties': {}})+ tool = types.Tool(name='read_file', description='Read a file', input_schema={'type': 'object', 'properties': {}})client._register_tool_as_action(tools.registry, 'read_file', tool)result = await tools.registry.execute_action('read_file', {})@@ -52,7 +52,7 @@ async def test_parameterized_mcp_tool_isError_true_is_surfaced_as_action_result_client.session.call_tool = AsyncMock( # type: ignore[union-attr]return_value=types.CallToolResult(content=[types.TextContent(type='text', text='File not found: /tmp/does-not-exist.txt')],- isError=True,+ is_error=True,))@@ -60,7 +60,7 @@ async def test_parameterized_mcp_tool_isError_true_is_surfaced_as_action_result_tool = types.Tool(name='read_file',description='Read a file',- inputSchema={+ input_schema={'type': 'object','properties': {'path': {'type': 'string'}},'required': ['path'],@@ -83,12 +83,12 @@ async def test_mcp_tool_isError_false_still_succeeds():client.session.call_tool = AsyncMock( # type: ignore[union-attr]return_value=types.CallToolResult(content=[types.TextContent(type='text', text='ok')],- isError=False,+ is_error=False,))tools = Tools()- tool = types.Tool(name='read_file', description='Read a file', inputSchema={'type': 'object', 'properties': {}})+ tool = types.Tool(name='read_file', description='Read a file', input_schema={'type': 'object', 'properties': {}})client._register_tool_as_action(tools.registry, 'read_file', tool)result = await tools.registry.execute_action('read_file', {})diff --git a/tests/ci/test_mcp_tool_annotations.py b/tests/ci/test_mcp_tool_annotations.pyindex 83a91aad9..2e1ab2272 100644--- a/tests/ci/test_mcp_tool_annotations.py+++ b/tests/ci/test_mcp_tool_annotations.py@@ -35,14 +35,13 @@ def server() -> BrowserUseServer:def _is_read_only(tool: types.Tool) -> bool:- return tool.annotations is not None and tool.annotations.readOnlyHint is True+ return tool.annotations is not None and tool.annotations.read_only_hint is Trueasync def _list_tools(server: BrowserUseServer) -> list[types.Tool]:- handler = server.server.request_handlers[types.ListToolsRequest]- result = await handler(types.ListToolsRequest(method='tools/list'))- assert isinstance(result, types.ServerResult), f'expected ServerResult, got {type(result).__name__}'- list_result = result.root+ handler = server.server.get_request_handler('tools/list')+ assert handler is not None, 'tools/list handler is not registered'+ list_result = await handler.handler(None, types.PaginatedRequestParams()) # type: ignore[arg-type]assert isinstance(list_result, types.ListToolsResult), f'expected ListToolsResult, got {type(list_result).__name__}'assert len(list_result.tools) > 0, 'tools/list returned an empty catalogue'return list_result.tools