MCP server that provides browser automation tools with session and tab management to Large Language Models
MCPBrowserServer has 24 well-organized tools with consistent naming (verb_noun pattern) and complete input schemas. All tools have descriptions and parameters are typed. However, descriptions are often generic (10-50 chars), output schemas are not documented, error handling lacks recovery guidance, and no tool annotations (readOnlyHint/destructiveHint) are present despite clear risk classifications. The codebase shows defensive error handling with try-catch blocks, but error messages are minimal and don't guide LLM recovery. Parameter descriptions are adequate but lack format constraints (e.g., selector patterns, timeout ranges). No pagination support visible for list operations.
Clicks on an element identified by selector
Closes a browser session and cleans up resources
Closes a tab in the browser session
Creates a new browser session with optional configuration
Creates a new tab in a browser session
Finds elements on the page using CSS selectors, XPath, ID, etc.
Gets information about the currently active session
Output schemas not documented. Tools return JSON strings but LLMs cannot see the structure of ElementSearchResponse, ElementResponse, etc. This forces LLMs to parse unstructured output and guess field names for downstream tool chaining.
Error messages lack recovery guidance. Catch blocks return ex.Message and ex.StackTrace, but do not tell LLMs what to do next (retry, call a different tool, ask user). Per pattern:recovery-guide, errors must be actionable.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 52 | 2026-07-28+ | v2 |
Gets information about the currently active tab in a session
Gets an attribute value from an element
Gets the text content from an element
Gets information about the current page (URL, title, meta data)
Gets detailed information about a specific session
Gets detailed information about a specific tab
Goes back in browser history for the specified session and tab
Goes forward in browser history for the specified session and tab
Lists all active browser sessions
Lists all tabs in a browser session
Navigates to a URL in the specified session and tab
Refreshes the current page in the specified session and tab
Renames a tab in the browser session
Switches to a different browser session
Switches to a different tab in the browser session
Takes a screenshot of the current page
Types text into an input element (textbox, textarea, etc.)
No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk classifications. Tools marked DESTRUCTIVE (close_session, close_tab) should have destructiveHint=true to warn agents. READ_ONLY tools should have readOnlyHint=true.
Descriptions are too short (50-70 chars average). Current descriptions like 'Clicks on an element identified by selector' lack context on WHEN to use this tool vs alternatives, prerequisites, or side effects.
No pagination support for list_sessions and list_tabs. If many sessions/tabs exist, returning all results could exhaust context. Per pattern:paginated-result, list tools should accept limit/offset and return total count.