Oya Browser — MCP server for Claude Code: real Chrome for agents
Gives your agent a real Chrome: opens pages, reads them as numbered markdown, clicks and types. You watch the run and can take control.
claude mcp add --transport http oya-browser https://oyabrowser.com/mcp/poolWhat Oya Browser does
Oya Browser connects over one remote MCP endpoint, https://oyabrowser.com/mcp/pool, and authenticates with your Oya API key. If you self-host, swap in the address of your own deployment.
The agent gets browser control: navigate to a page, read its text with numbered elements, click and type. Agent activity stays in its own tabs. A run that worked can become a playbook, replayable with new inputs, and the generated Playwright module sits next to it for inspection.
The key is not optional. Without an Authorization: Bearer $OYA_API_KEY header the endpoint refuses the request, so create the key at oyabrowser.com first. The desktop app pairs with Claude, Codex, Cursor and VS Code, and a person can switch between AI Mode and Human Mode mid-task. You can also drive the browser from Node.js 20 or newer with the SDK, pointing it at Oya Cloud, your deployment, or another provider while keeping the same calls.
What it helps with
- Walk through a multi-step portal form and read back the result
- Fetch a page as numbered markdown the agent can act on
- Record a successful run into a playbook and replay it with new inputs
- Keep agent tabs separate from the ones you use by hand
Example prompts for the agent
- Connect Oya Browser, open
https://news.ycombinator.comand summarize the top stories - Go through the signup flow in Oya and fill the form from
data.json - Replay the authorization playbook with new inputs and show me the generated Playwright module
How to install Oya Browser
Platform CLI: remote server
claude mcp add --transport http oya-browser https://oyabrowser.com/mcp/poolPlatform CLI: remote server
codex mcp add oya-browser --url https://oyabrowser.com/mcp/poolConfig file
{
"mcpServers": {
"oya-browser": {
"url": "https://oyabrowser.com/mcp/pool"
}
}
}Config file
{
"servers": {
"oya-browser": {
"type": "http",
"url": "https://oyabrowser.com/mcp/pool"
}
}
}Platform CLI: remote server
gemini mcp add -t http oya-browser https://oyabrowser.com/mcp/poolStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Oya Browser
How do I install Oya Browser in Claude Code?
Run claude mcp add --transport http oya-browser https://oyabrowser.com/mcp/pool. Requests must carry Authorization: Bearer $OYA_API_KEY, so have your Oya API key ready. Running your own deployment? Use your server URL in place of the cloud one.
What does Oya Browser do?
It hands the agent a real Chrome to open pages, read them as numbered markdown, click and type. You watch the work in separate tabs and step into Human Mode when a task needs you.
What do I need to connect to the Oya MCP endpoint?
An Oya API key, since https://oyabrowser.com/mcp/pool authenticates with it. The Node.js SDK needs Node.js 20 or newer.
