# Bytedance Browser (MCP server)

> Bytedance Browser is an MCP server that adds web browsing tools to AI assistants such as Claude Desktop, Claude Code and Cursor. MCP server for browser use access. It has 39,206 GitHub stars, is released under the Apache-2.0 license and runs locally with npx -y @agent-infra/mcp-server-browser.

A fast, lightweight Model Context Protocol (MCP) server that empowers LLMs with browser automation via Puppeteer’s structured accessibility data, featuring optional vision mode for complex visual understanding and flexible, cross-platform configuration.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/bytedance/UI-TARS-desktop |
| GitHub stars | 39,206 |
| License | Apache-2.0 |
| Language | TypeScript |
| Transport | stdio |
| Packages | npm: @agent-infra/mcp-server-browser |
| Remote URL | none |
| Needs API key | no |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Web & browsing |
| Latest release | v0.3.0 (Nov 4, 2025) |
| Last commit | Sep 24, 2026 |
| MCP registry name | io.github.bytedance/mcp-server-browser |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "bytedance-browser": {
      "command": "npx",
      "args": [
        "-y",
        "@agent-infra/mcp-server-browser"
      ],
      "env": {
        "DISPLAY": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env DISPLAY=your-value --transport stdio bytedance-browser -- npx -y @agent-infra/mcp-server-browser
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "bytedance-browser": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@agent-infra/mcp-server-browser"
      ],
      "env": {
        "DISPLAY": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "bytedance-browser": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@agent-infra/mcp-server-browser"
      ],
      "env": {
        "DISPLAY": "your-value"
      }
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `DISPLAY`: DISPLAY environment variable for browser rendering

## Tools

- `browser_click`: Click an element on the page, before using the tool, use browsergetclickableelements to get the index of the element,…
- `browser_close`: Close the browser when the task is done and the browser is not needed anymore
- `browser_close_tab`: Close the current tab
- `browser_evaluate`: Execute JavaScript in the browser console
- `browser_form_input_fill`: Fill out an input field, before using the tool, Either 'index' or 'selector' must be provided
- `browser_get_clickable_elements`: Get the clickable or hoverable or selectable elements on the current page, don't call this tool multiple times
- `browser_get_download_list`: Get the list of downloaded files
- `browser_get_markdown`: Get the markdown content of the current page
- `browser_get_text`: Get the text content of the current page
- `browser_go_back`: Go back to the previous page
- `browser_go_forward`: Go forward to the next page
- `browser_hover`: Hover an element on the page, Either 'index' or 'selector' must be provided
- `browser_navigate`: Navigate to a URL
- `browser_new_tab`: Open a new tab
- `browser_press_key`: Press a key on the keyboard
- `browser_read_links`: Get all links on the current page
- `browser_screenshot`: Take a screenshot of the current page or a specific element
- `browser_scroll`: Scroll the page
- `browser_select`: Select an element on the page with index, Either 'index' or 'selector' must be provided
- `browser_switch_tab`: Switch to a specific tab
- `browser_tab_list`: Get the list of tabs
- `browser_vision_screen_capture`: Take a screenshot of the current page for vision mode
- `browser_vision_screen_click`: Click left mouse button on the page with vision and snapshot, before calling this tool, you should call…

## Similar MCP servers

- [Browser Use](https://appsgit.com/mcp-servers/browser-use): Control a real Chrome browser to complete any task: fill forms, extract data, book flights. (117,307 stars, MIT, official)
- [Scrapling MCP Server](https://appsgit.com/mcp-servers/scrapling-mcp-server): Web scraping with stealth HTTP, real browsers, and Cloudflare bypass. (86,017 stars, BSD-3-Clause)
- [Chrome DevTools MCP](https://appsgit.com/mcp-servers/chrome-devtools-mcp): MCP server for Chrome DevTools. (53,049 stars, Apache-2.0)
- [Playwright MCP](https://appsgit.com/mcp-servers/playwright-mcp): A Model Context Protocol (MCP) server that provides browser automation capabilities using Playwright. (37,886 stars, Apache-2.0, official)
- [AIHawk](https://appsgit.com/mcp-servers/aihawk): AI browser agent: browses, clicks, types, and reads real web pages from plain-English instructions. (31,781 stars, MIT)
- [invisible_playwright_mcp](https://appsgit.com/mcp-servers/invisible-playwright-mcp): AI browser agent: browses, clicks, types, and reads real web pages from plain-English instructions. (31,781 stars, MIT)

---

Canonical page: https://appsgit.com/mcp-servers/bytedance-browser
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.