Skip to main content
Use the Firmware Browser MCP server to let AI agents browse the web through your Chrome browser. Agents get their own isolated tab group — you can watch what they do in real time.

​
Prerequisites

​
Connect your agent

Add the Firmware Browser MCP server to your agent’s configuration. The endpoint is: 
https://app.firmware.ai/api/mcp/browser

{
  "mcpServers": {
    "firmware-browser": {
      "type": "remote",
      "url": "https://app.firmware.ai/api/mcp/browser",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
Replace YOUR_API_KEY with your Firmware API key from Account > API Keys.

​
How it works

When an agent calls a browser tool:
  1. The MCP server creates a session tied to the agent’s connection
  2. The Firmware extension opens a “FrogBot Agent” tab group in your Chrome window
  3. All browser actions (navigation, clicks, typing) happen inside that tab group
  4. The tab group stays open so you can inspect results after the agent finishes
Each agent connection gets its own isolated tab group. Multiple agents can run simultaneously without interfering with each other or your personal browsing.

​
Available tools

ToolDescription
readPageGet a screenshot and all visible text/elements from the current page
goToWebsiteNavigate to a URL
clickClick an element by its ID from the page DOM
fillOrTypeFill form fields — text inputs, dropdowns, checkboxes, etc.
scrollPageScroll the page or a specific container
pressKeyPress keyboard keys or combinations
openNewTabOpen a new tab with an optional URL
switchTabSwitch to a different tab by ID
getOpenTabsList all open tabs in the session
closeThisTabClose the current tab
closeTabByIdClose a specific tab by ID
refreshPageRefresh the current page
waitForPageWait for the page to finish loading
endBrowserSessionClose the tab group and clean up the session

​
Session lifecycle

  • Automatic creation — The first tool call creates a new tab group in Chrome
  • Persistent — The tab group stays open between tool calls and after the agent disconnects
  • Resumable — Reconnecting with the same session picks up the existing tab group
  • Manual cleanup — Call endBrowserSession or close the tab group manually in Chrome

​
Troubleshooting

“Browser extension not connected” The Firmware Chrome extension isn’t connected. Make sure:
  • Chrome is open
  • The Firmware extension is installed
  • You’re logged in to Firmware in the extension
“Tool timed out” The extension didn’t respond within 30 seconds. The page may be loading slowly or the extension became unresponsive. Try refreshing the extension or restarting Chrome. “No active window found” Chrome has no focused window. Click on any Chrome window and retry. “Unauthorized” Your API key is invalid or missing. Check that the Authorization header is set correctly with a valid API key.