Browser MCP tools disappear mid-session (mcp__browsermcp__* become unavailable)
Problem
Browser MCP server tools (mcp__browsermcp__browser_navigate, mcp__browsermcp__browser_click, etc.) become unavailable mid-session even though the MCP server process is still configured and the browser extension shows "Connected".
Steps to Reproduce
- Start Claude Code session with Browser MCP configured in
~/.claude/config.json:
``json``
"browser": {
"command": "/home/user/.npm-global/bin/mcp-server-browsermcp"
}
- Tools are available at session start (listed as deferred tools in system-reminder)
- Use the browser tools successfully (navigate, click, type, etc.)
- After some time or after heavy tool usage, the tools disappear
ToolSearchreturns "No matching deferred tools found" for anybrowsermcpquery- Direct invocation returns
Error: No such tool available: mcp__browsermcp__browser_snapshot - The browser extension still shows "Connected" status
Expected Behavior
Browser MCP tools should remain available for the entire session as long as the MCP server is running.
Actual Behavior
- Tools work initially, then silently disconnect
- No error message or notification when tools become unavailable
ToolSearchstops finding them- Direct calls fail with "No such tool available"
- No way to reconnect the MCP server from within the session
Additional Context
- The MCP server name in config.json is
browserbut tools are registered asmcp__browsermcp__*(the server self-reports as "browsermcp") ListMcpResourcesToolreturns empty even when other MCP servers (computer-use, excel-mcp) still work- The
ps aux | grep browsermcpshows no process running after disconnect, suggesting the server process died silently - Claude Code version: 2.1.76
- OS: Ubuntu Linux 5.15.0-170-generic
Workaround
None found within the session. User must restart Claude Code or run /mcp to reconnect.
Impact
This blocks any workflow that requires sustained browser interaction (e.g., creating GitHub Apps, filling web forms, multi-step browser automation). The disconnect often happens at critical moments during multi-step browser tasks.
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗