# MCP setup

Part of the Oya Browser docs. All of it: https://oyabrowser.com/docs.md

## MCP Setup

One endpoint for everything you have. It starts browsers itself, so there is no id to look up first:

```
https://oyabrowser.com/mcp/pool
```

Seventeen tools: fourteen that act on a page, round-robined across your browsers, plus `start_browser`, `stop_browser` and `pool_status`. Tab tools and `read_elements` are not on this endpoint; to use those, point at one browser instead, `/mcp/{BROWSER_ID}`, with the id from the [dashboard](https://oyabrowser.com/dashboard), which serves nineteen.

### Cursor

Add to `.cursor/mcp.json` in your project:

```
{
  "mcpServers": {
    "oya-browser": {
      "url": "https://oyabrowser.com/mcp/pool",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

### Claude Desktop

Add to Claude Desktop's MCP config (Settings → Developer → Edit Config):

```
{
  "mcpServers": {
    "oya-browser": {
      "url": "https://oyabrowser.com/mcp/pool",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

### Claude Code

Same config in `.claude/mcp.json`, or install the plugin, which brings the MCP server and a skill that teaches the workflow:

```
claude plugin marketplace add OyadotAI/oya-browser
claude plugin install oya-browser@oya

# any agent that reads skills, without the plugin:
npx skills add OyadotAI/oya-browser
```