Skip to main content
This example demonstrates how to use the Playwright MCP server to give agents web browsing capabilities.

​
What You’ll Learn

  • How to set up and use MCP servers
  • How to create a web browsing assistant
  • How to handle streaming responses with tools
  • Security considerations for MCP servers

​
Prerequisites

1

Install AutoGen and MCP

pip install -U "autogen-agentchat" "autogen-ext[openai]" "autogen-ext[tools]"
2

Install Playwright MCP Server

npm install -g @playwright/mcp@latest
3

Set your OpenAI API key

export OPENAI_API_KEY="sk-..."

​
Code Example

import asyncio
from autogen_agentchat.agents import AssistantAgent
from autogen_agentchat.ui import Console
from autogen_ext.models.openai import OpenAIChatCompletionClient
from autogen_ext.tools.mcp import McpWorkbench, StdioServerParams


async def main() -> None:
    model_client = OpenAIChatCompletionClient(model="gpt-4o")
    
    # Configure the MCP server
    server_params = StdioServerParams(
        command="npx",
        args=[
            "@playwright/mcp@latest",
            "--headless",
        ],
    )
    
    # Create agent with MCP workbench
    async with McpWorkbench(server_params) as mcp:
        agent = AssistantAgent(
            "web_browsing_assistant",
            model_client=model_client,
            workbench=mcp,  # For multiple MCP servers, put them in a list
            model_client_stream=True,
            max_tool_iterations=10,
        )
        
        # Run web browsing task
        await Console(
            agent.run_stream(
                task="Find out how many contributors for the microsoft/autogen repository"
            )
        )
    
    await model_client.close()


asyncio.run(main())

​
Run the Example

python web_browsing.py

​
Expected Output

---------- web_browsing_assistant ----------
[Opening browser...]
[Navigating to GitHub...]
[Extracting contributor count...]
The microsoft/autogen repository has 487 contributors.

​
How It Works

  1. MCP Server: Playwright MCP server provides web automation tools
  2. McpWorkbench: Manages the connection to the MCP server
  3. Tool Discovery: Agent automatically discovers available tools from the server
  4. Execution: Agent uses tools like navigate, screenshot, click to browse the web
  5. Context Manager: async with ensures proper cleanup of resources

​
Available MCP Tools

The Playwright MCP server provides several tools:
  • navigate(url): Navigate to a URL
  • screenshot(): Take a screenshot of the current page
  • click(selector): Click an element
  • fill(selector, value): Fill a form field
  • evaluate(script): Execute JavaScript
  • get_text(selector): Extract text from elements

​
Using Multiple MCP Servers

You can connect to multiple MCP servers simultaneously: 
async def main() -> None:
    model_client = OpenAIChatCompletionClient(model="gpt-4o")
    
    # Configure multiple servers
    browser_server = StdioServerParams(
        command="npx",
        args=["@playwright/mcp@latest", "--headless"],
    )
    
    filesystem_server = StdioServerParams(
        command="npx",
        args=["-y", "@modelcontextprotocol/server-filesystem", "/path/to/directory"],
    )
    
    # Create multiple workbenches
    async with McpWorkbench(browser_server) as browser_mcp, \
               McpWorkbench(filesystem_server) as fs_mcp:
        
        agent = AssistantAgent(
            "multi_tool_assistant",
            model_client=model_client,
            workbench=[browser_mcp, fs_mcp],  # List of workbenches
            model_client_stream=True,
            max_tool_iterations=20,
        )
        
        await Console(
            agent.run_stream(
                task="Browse example.com and save the content to a file"
            )
        )

​
Security Warning

Only connect to trusted MCP servers as they may:
  • Execute commands in your local environment
  • Access your filesystem
  • Expose sensitive information
  • Make network requests
Always review the MCP server’s source code before use in production.

​
Common Use Cases

Research

Gather information from multiple websites automatically.

Testing

Automate web application testing and validation.

Data Extraction

Scrape structured data from web pages.

Monitoring

Track changes on websites over time.

​
Troubleshooting

​
Browser Not Found

If you get a “browser not found” error: 
npx playwright install chromium

​
Connection Timeout

Increase the timeout in server parameters: 
server_params = StdioServerParams(
    command="npx",
    args=["@playwright/mcp@latest", "--headless"],
    env={"PLAYWRIGHT_TIMEOUT": "60000"},
)

​
Next Steps

Code Execution

Execute code safely within agent workflows

Research Assistant

Build a complete research assistant application

Build docs developers (and LLMs) love

Get started for freeTalk to us