Integrations / AI agent clients / AutoGen
Browser tools for AutoGen agents.
AutoGen’s extension package talks to MCP servers through McpWorkbench. Give it the Browz server and an AssistantAgent can open, read and act on pages in isolated profiles on your computer.
pip install "autogen-agentchat" "autogen-ext[openai,mcp]"Setup
Set it up.
Install Browz and open it
Download Browz on the computer that runs the agent.
Install the packages
Terminalpip install "autogen-agentchat" "autogen-ext[openai,mcp]"Connect the agent
Set
OPENAI_API_KEYfirst. Page loads can take longer than the default 5-second read timeout, so raise it.agent.pyimport asyncio from autogen_agentchat.agents import AssistantAgent from autogen_ext.models.openai import OpenAIChatCompletionClient from autogen_ext.tools.mcp import McpWorkbench, StdioServerParams params = StdioServerParams(command="/Applications/Browz.app/Contents/Resources/browz-mcp", args=[], read_timeout_seconds=60) async def main(): async with McpWorkbench(params) as browz: agent = AssistantAgent("browser_agent", workbench=browz, model_client=OpenAIChatCompletionClient(model="gpt-4.1-mini")) result = await agent.run(task="Using Browz, open a throwaway session, go to https://example.com, tell me the page title, then close the session.") print(result.messages[-1].content) asyncio.run(main())
API from autogen_ext.tools.mcp reference.
Example
List the tools first.
Before giving the agent a task, check what the workbench sees.
import asyncio
from autogen_ext.tools.mcp import McpWorkbench, StdioServerParams
async def main():
async with McpWorkbench(StdioServerParams(command="/Applications/Browz.app/Contents/Resources/browz-mcp", args=[])) as browz:
for tool in await browz.list_tools():
print(tool["name"])
asyncio.run(main())It should print the Browz tools, such as browz_session_open, browz_navigate and browz_snapshot.
Good to know
Notes and tips.
- Microsoft has archived the AutoGen repository and points new projects to Microsoft Agent Framework; AutoGen still works with MCP servers as shown. For a framework under active development, see LangGraph, CrewAI or the OpenAI Agents SDK.
- The remote server at
https://mcp.gobrowz.com/mcpis in free public beta: it needs the Browz app open with Remote control on, on a computer with a hardware security chip, and offers the profile, tab and page tools. See what it needs and what it offers. - Browz has to be installed and open on the same computer: the local MCP server drives the app’s own profiles through its local API, and reads the app’s credentials itself, so no token goes in the config.
- A person completes sign-ins, 2FA codes and CAPTCHAs. The agent can pause with
browz_request_humanand hand you the profile’s window, then carry on in the same session. Browz never solves or bypasses CAPTCHAs. - Use agents only where each site’s terms allow automated use, on accounts you are entitled to use. Our acceptable use policy applies to agents the same as to people.
- The MCP server is on every plan, Free included (5 profiles). How many agent sessions can be open at once depends on the plan: see pricing.
FAQ
AutoGen and Browz.
Is AutoGen still maintained?
Its repository is archived: Microsoft points new users to Microsoft Agent Framework. The MCP support shown here works in the last release.
Can I use mcp_server_tools instead of McpWorkbench?
Yes. Older AutoGen code loads the tools with mcp_server_tools(params) and passes them to AssistantAgent(tools=...); McpWorkbench keeps one session open, which suits a browser better.
Which model should I use?
Any model client AutoGen supports with tool calling. The example uses an OpenAI model; Browz does not care which.
Get started
Download Browz. Every task, its own browser.
curl -fsSL https://gobrowz.com/agents/install.sh | sh