# Connecting an LLM Agent to a Real Browser With Playwright MCP

> Source: <https://dev.to/basavaraj_sh_1ea7d95f0f2e/connecting-an-llm-agent-to-a-real-browser-with-playwright-mcp-4onj>
> Published: 2026-07-27 10:20:43+00:00

Browser-capable agents have gone from research demos to something you can wire up in an afternoon. If you've wanted an AI agent that actually clicks, reads, and navigates - not just simulates it - Playwright MCP is the practical path right now.

MCP (Model Context Protocol) is a standardized interface that enables LLM agents to call external tools like file access, APIs, or in this case, a live browser. Playwright is a well-established browser automation library; the Playwright MCP server wraps it so an agent can send natural-language-style instructions that get translated into real browser actions: navigate, click, fill a form, extract text.

The agent operates a real Chromium (or Firefox) instance, reading rendered pages and handling JavaScript-heavy sites, and can adapt mid-task if a page changes - because it's reading the live DOM, not a static response.

Here's a minimal working scaffold using the OpenAI Agents SDK and the Playwright MCP server:

``` python
from agents import Agent, Runner
from agents.mcp import MCPServerStdio

async def main():
 playwright_server = MCPServerStdio(
 command="npx",
 args=["@playwright/mcp@latest", "--headless"]
 )
 async with playwright_server as browser_tool:
 agent = Agent(
 name="BrowserAgent",
 instructions="You are a web research assistant. Navigate pages and extract information accurately.",
 mcp_servers=[browser_tool],
 model="gpt-4o"
 )
 result = await Runner.run(
 agent,
 input="Go to news.ycombinator.com and return the top 3 post titles."
 )
 print(result.final_output)
```

The `MCPServerStdio`

call spins up the Playwright server as a subprocess. The agent receives browser-control tools automatically - no manual tool definitions needed. The `--headless`

flag keeps it serverless-friendly. Swap in any task via the `input`

string: form filling, data extraction, multi-step navigation.

One practical note: run this in an environment where `npx`

and Node.js are available alongside your Python runtime. A Docker image works cleanly here.

`mcp_servers`

- the surface area to learn is smaller than it looks.Have you hit a case where browser-capable agents broke down on a specific site type (single-page apps, captchas, login flows) - and what was your workaround?

*Sources referenced: Towards Data Science - "How to Give an LLM Agent a Browser", OpenAI Agents SDK documentation, Playwright MCP GitHub*