TgeBrowser MCP Operations

Use MCP tools to operate TgeBrowser environments, groups, proxies, and browser automation via the mcptgebrowser* tools.

When to Use This Skill

Apply when the user:

• - Asks to create, update, delete, or list TgeBrowser environments
• Mentions opening or closing browsers/profiles, fingerprint, UA, or proxy
• Wants to manage groups, proxies, or check API status
• Needs browser automation (navigate, click, fill forms, screenshot, etc.)
• Refers to TgeBrowser or tgebrowser operations

Ensure TgeBrowser is running (default port 50326). The MCP server connects to the TgeBrowser Local API.

Smart Defaults & Best Practices

When creating browsers:

• - Always use {"protocol": "direct"} for proxy if user doesn't specify one
• Default fingerprint OS to "Windows" if not specified
• Set webrtc: "disabled" by default for better privacy
• Use clearCacheOnStart: true for clean sessions

When opening browsers:

• - Use args: ["--headless"] for automation tasks unless user needs to see the browser
• Let the system auto-assign port unless user specifies one

When automating:

• - Always call mcp__tgebrowser__open-browser first and extract the ws URL from response
• Then call mcp__tgebrowser__connect-browser-with-ws with that ws URL
• After connection, you can use navigation and interaction tools

Error handling:

• - If browser open fails, check if TgeBrowser app is running via INLINECODE8
• If envId not found, list browsers first with INLINECODE9
• Before deleting cache, always close the browser first

Common Workflows

Quick Start: Create and Use a Browser

1. 1. Create: mcp__tgebrowser__create-browser with minimal params (name + proxy)
2. Open: mcp__tgebrowser__open-browser with returned envId
3. Connect: mcp__tgebrowser__connect-browser-with-ws with ws URL from step 2
4. Automate: Use navigation/interaction tools
5. Close: mcp__tgebrowser__close-browser when done

Find and Open Existing Browser

1. 1. List: mcp__tgebrowser__get-browser-list with keyword if needed
2. Open: Use envId from list
3. Connect and automate

Batch Operations

• - Use mcp__tgebrowser__get-browser-list to get all browsers
• Iterate through list for batch operations
• Use mcp__tgebrowser__close-all-profiles to close all at once

Essential MCP Tools

Browser Lifecycle (Most Common)

Create a browser:
CODEBLOCK0

Open a browser:
CODEBLOCK1

Connect for automation:
CODEBLOCK2

Close a browser:
CODEBLOCK3

Browser Management

List browsers:
CODEBLOCK4

Update browser:
CODEBLOCK5

Delete browser:
CODEBLOCK6

Get opened browsers:
CODEBLOCK7

Browser Automation (After Connection)

Navigate:
CODEBLOCK8

Take screenshot:
CODEBLOCK9

Get page content:
CODEBLOCK10

Interact with elements:
CODEBLOCK11

Execute JavaScript:
CODEBLOCK12

Utility Tools

Get cookies:
CODEBLOCK13

Get User-Agent:
CODEBLOCK14

Generate new fingerprint:
CODEBLOCK15

Clear cache:
CODEBLOCK16

Close all browsers:
CODEBLOCK17

Check system status:
CODEBLOCK18

Groups & Proxies

List groups:
CODEBLOCK19

List proxies:
CODEBLOCK20

Intelligent Automation Guide

Auto-detect and Handle Common Scenarios

Scenario 1: User wants to automate a website

1. 1. Check if any browser is open: INLINECODE17
2. If none, create one with smart defaults: INLINECODE18
3. Open it with headless mode: INLINECODE19
4. Connect using ws URL from response
5. Navigate and automate

Scenario 2: User mentions a website but no browser specified

• - Automatically create a temporary browser with optimal settings
• Use descriptive name like "Temp-{website_domain}"
• Clean up after task completion

Scenario 3: User wants to "open browser" without details

• - List existing browsers first
• If found, use the most recently created one
• If none exist, create one with defaults
• Always prefer reusing existing browsers over creating new ones

Scenario 4: Automation fails

• - Check connection status first
• Verify browser is still open: INLINECODE20
• If closed, reopen and reconnect automatically
• Retry the failed operation once

Scenario 5: User wants to "close everything"

• - Use mcp__tgebrowser__close-all-profiles - one command closes all

Smart Parameter Inference

When envId is missing:

• - List browsers and use the first/only one if count = 1
• If multiple, ask user or use most recent

When proxy is not specified:

• - Always default to {"protocol": "direct"} (no proxy)
• Never leave proxy undefined

When fingerprint is not specified:

• - Use safe defaults: INLINECODE23

When selector fails:

• - Try common alternatives (id, class, name, xpath)
• Wait a few seconds and retry
• Get page HTML to help debug

When screenshot path not specified:

• - Auto-generate: INLINECODE24
• Create directory if needed

Proactive Error Prevention

Before opening browser:

• - Verify TgeBrowser is running: INLINECODE25
• If not running, inform user to start TgeBrowser app

Before deleting/clearing cache:

• - Check if browser is open: INLINECODE26
• If open, close it first automatically

Before creating browser:

• - Validate proxy format if provided
• Ensure browserName is not empty
• Check if name already exists (list first)

Before automation:

• - Ensure browser is connected
• Verify page is loaded (check URL or title)
• Wait for elements before interacting

Batch Operations Intelligence

When user wants to operate on multiple browsers:

1. 1. Get full list: INLINECODE27
2. Filter by keyword if user mentioned specific criteria
3. Process in parallel when possible (open, close, update)
4. Report progress and errors clearly

When user wants to clean up:

1. 1. Close all: INLINECODE28
2. List all: INLINECODE29
3. Delete unwanted ones based on criteria (name pattern, age, etc.)

Context Awareness

Remember across operations:

• - Last opened browser envId
• Last used ws URL
• Current page URL after navigation
• Recently created browsers

Infer user intent:

• - "Open browser" → open existing or create new
• "Go to website" → navigate if connected, or open→connect→navigate
• "Click button" → find best selector automatically
• "Get data" → extract visible text or specific elements
• "Take screenshot" → full page by default
• "Close" → close current browser or all if multiple mentioned

All parameter names are camelCase in JSON objects passed to MCP tools.

Environment Management

See references/environment-management.md for mcptgebrowseropen-browser, mcptgebrowserclose-browser, mcptgebrowsercreate-browser, mcptgebrowserupdate-browser, mcptgebrowserdelete-browser, mcptgebrowserget-browser-list, mcptgebrowserget-opened-browser, mcptgebrowserget-profile-cookies, mcptgebrowserget-profile-ua, mcptgebrowserclose-all-profiles, mcptgebrowsernew-fingerprint, mcptgebrowserdelete-cache, mcptgebrowserget-browser-active and their parameters.

Group Management

See references/group.md for mcptgebrowserget-group-list parameters.

System

See references/system.md for mcptgebrowsercheck-status parameters.

Proxy Management

See references/proxy.md for mcptgebrowserget-proxy-list parameters.

Proxy Config (proxy field for create-browser / update-browser)

See references/proxy-config.md for all fields (protocol, host, port, username, password, etc.) and example.

Fingerprint Config (fingerprint field for create-browser / update-browser)

See references/fingerprint.md for all fields (os, kernel, timezone, language, webrtc, TLS, etc.) and example.

Browser Automation

Browser automation tools (navigate, click-element, fill-input, screenshot, etc.) are fully supported via MCP. These tools require an active browser connection established via mcptgebrowseropen-browser or mcptgebrowserconnect-browser-with-ws.

Deep-Dive Documentation

Reference docs with full enum values and field lists:

Reference	Description	When to use
references/environment-management.md	open-browser, close-browser, create-browser, update-browser, delete-browser, get-browser-list, get-opened-browser, get-profile-cookies, get-profile-ua, close-all-profiles, new-fingerprint, delete-cache, get-browser-active parameters.	Any browser environment operation (open, create, update, delete, list, cookies, UA, cache, status).
references/group.md

get-group-list parameters. | Listing browser groups. |
| references/system.md | check-status parameters. | Checking API availability. |
| references/proxy.md | get-proxy-list parameters. | Listing proxies. |
| references/proxy-config.md | Full proxy field list (protocol, host, port, username, password, etc.) and example. | Building proxy config for create-browser / update-browser. |
| references/fingerprint.md | fingerprint field list (os, kernel, timezone, language, webrtc, canvas, TLS, etc.) and example. | Building or editing fingerprint config for create-browser / update-browser. |
| references/kernel-config.md | Supported kernel version values for fingerprint.kernel. | Pinning a specific Chrome version when creating or updating a browser. |
| references/ua-version.md | uasystem_version enum for fingerprint.random_ua: specific OS versions, generic “any version” per system, and omit behavior. | Constraining or randomizing UA by OS (e.g. Android only, or “any macOS version”) when creating or updating a browser. |

Use these when you need the exact allowed values or semantics; the main skill text above only summarizes.