Skill: tuguang2025/tgebrowser (version 1.0.0)

--- name: tgebrowser description: Operates TgeBrowser via MCP tools. Use when the user asks to create or manage TgeBrowser environments, groups, proxies, browser automation, or check status. Provides full browser control including automation capabilities. --- # TgeBrowser MCP Operations Use MCP tools to operate TgeBrowser environments, groups, proxies, and browser automation via the **mcp__tgebrowser__*** 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 [REDACTED_SECRET] 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 `mcp__tgebrowser__check-status` - If envId not found, list browsers first with [REDACTED_SECRET] - Before deleting cache, always close the browser first ## Common Workflows ### Quick Start: Create and Use a Browser 1. Create: `mcp__tgebrowser__create-browser` with minimal params (name + proxy) 2. Open: `mcp__tgebrowser__open-browser` with returned envId 3. Connect: [REDACTED_SECRET] 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. List: [REDACTED_SECRET] with keyword if needed 2. Open: Use envId from list 3. Connect and automate ### Batch Operations - Use [REDACTED_SECRET] to get all browsers - Iterate through list for batch operations - Use [REDACTED_SECRET] to close all at once ## Essential MCP Tools ### Browser Lifecycle (Most Common) **Create a browser:** ``` mcp__tgebrowser__create-browser Required: {"browserName": "MyBrowser", "proxy": {"protocol": "direct"}} Smart defaults applied: Windows OS, disabled WebRTC, clean cache on start ``` **Open a browser:** ``` mcp__tgebrowser__open-browser Required: {"envId": 123} OR {"userIndex": 1} Returns: ws URL for automation - save this! ``` **Connect for automation:** ``` mcp__tgebrowser__connect-browser-with-ws Required: {"wsUrl": "ws://127.0.0.1:xxxxx/devtools/browser/..."} Use ws URL from open-browser response ``` **Close a browser:** ``` mcp__tgebrowser__close-browser Required: {"envId": 123} OR {"userIndex": 1} ``` ### Browser Management **List browsers:** ``` mcp__tgebrowser__get-browser-list Optional: {"keyword": "search term", "pageSize": 50} Use this to find envId when you don't know it ``` **Update browser:** ``` mcp__tgebrowser__update-browser Required: {"envId": 123, "browserName": "NewName"} Optional: proxy, fingerprint, groupId, remark ``` **Delete browser:** ``` mcp__tgebrowser__delete-browser Required: {"envId": 123} OR {"userIndex": 1} Close it first if it's open ``` **Get opened browsers:** ``` mcp__tgebrowser__get-opened-browser No parameters needed Returns list of currently running browsers ``` ### Browser Automation (After Connection) **Navigate:** ``` mcp__tgebrowser__navigate Required: {"url": "https://example.com"} ``` **Take screenshot:** ``` mcp__tgebrowser__screenshot Optional: {"savePath": "./screenshot.png", "isFullPage": true} Defaults to full page screenshot ``` **Get page content:** ``` mcp__tgebrowser__get-page-visible-text - Get readable text mcp__tgebrowser__get-page-html - Get full HTML No parameters needed ``` **Interact with elements:** ``` mcp__tgebrowser__click-element {"selector": "#button"} mcp__tgebrowser__fill-input {"selector": "#email", "text": "[REDACTED_SECRET]"} mcp__tgebrowser__select-option {"selector": "#country", "value": "US"} mcp__tgebrowser__hover-element {"selector": ".menu"} mcp__tgebrowser__scroll-element {"selector": "#footer"} mcp__tgebrowser__press-key {"key": "Enter"} ``` **Execute JavaScript:** ``` mcp__tgebrowser__evaluate-script Required: {"script": "return document.title"} Returns script result ``` ### Utility Tools **Get cookies:** ``` mcp__tgebrowser__get-profile-cookies Required: {"envId": 123} ``` **Get User-Agent:** ``` mcp__tgebrowser__get-profile-ua Required: {"envId": 123} ``` **Generate new fingerprint:** ``` mcp__tgebrowser__new-fingerprint Required: {"envId": 123} Browser must be closed ``` **Clear cache:** ``` mcp__tgebrowser__delete-cache Required: {"envId": 123} Browser must be closed ``` **Close all browsers:** ``` mcp__tgebrowser__close-all-profiles No parameters needed Emergency stop for all browsers ``` **Check system status:** ``` mcp__tgebrowser__check-status No parameters needed Verify TgeBrowser app is running ``` ### Groups & Proxies **List groups:** ``` mcp__tgebrowser__get-group-list Optional: {"pageSize": 50} ``` **List proxies:** ``` mcp__tgebrowser__get-proxy-list Optional: {"pageSize": 50} ``` ## Intelligent Automation Guide ### Auto-detect and Handle Common Scenarios **Scenario 1: User wants to automate a website** 1. Check if any browser is open: [REDACTED_SECRET] 2. If none, create one with smart defaults: `{"browserName": "Auto-Browser", "proxy": {"protocol": "direct"}, "fingerprint": {"os": "Windows", "webrtc": "disabled"}}` 3. Open it with headless mode: `{"envId": <returned_id>, "args": ["--headless"]}` 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: [REDACTED_SECRET] - If closed, reopen and reconnect automatically - Retry the failed operation once **Scenario 5: User wants to "close everything"** - Use [REDACTED_SECRET] - 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: `{"os": "Windows", "webrtc": "disabled", "clearCacheOnStart": true}` **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: `./screenshots/{timestamp}_{envId}.png` - Create directory if needed ### Proactive Error Prevention **Before opening browser:** - Verify TgeBrowser is running: `mcp__tgebrowser__check-status` - If not running, inform user to start TgeBrowser app **Before deleting/clearing cache:** - Check if browser is open: [REDACTED_SECRET] - 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. Get full list: `mcp__tgebrowser__get-browser-list {"pageSize": 100}` 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. Close all: [REDACTED_SECRET] 2. List all: [REDACTED_SECRET] 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](references/environment-management.md) for mcp__tgebrowser__open-browser, mcp__tgebrowser__close-browser, mcp__tgebrowser__create-browser, mcp__tgebrowser__update-browser, mcp__tgebrowser__delete-browser, mcp__tgebrowser__get-browser-list, mcp__tgebrowser__get-opened-browser, mcp__tgebrowser__get-profile-cookies, mcp__tgebrowser__get-profile-ua, mcp__tgebrowser__close-all-profiles, mcp__tgebrowser__new-fingerprint, mcp__tgebrowser__delete-cache, mcp__tgebrowser__get-browser-active and their parameters. ### Group Management See [references/group.md](references/group.md) for mcp__tgebrowser__get-group-list parameters. ### System See [references/system.md](references/system.md) for mcp__tgebrowser__check-status parameters. ### Proxy Management See [references/proxy.md](references/proxy.md) for mcp__tgebrowser__get-proxy-list parameters. ### Proxy Config (proxy field for create-browser / update-browser) See [references/proxy-config.md](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](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 mcp__tgebrowser__open-browser or mcp__tgebrowser__connect-browser-with-ws. ## Deep-Dive Documentation Reference docs with full enum values and field lists: | Reference | Description | When to use | |-----------|-------------|-------------| | [references/environment-management.md](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](references/group.md) | **get-group-list** parameters. | Listing browser groups. | | [references/system.md](references/system.md) | **check-status** parameters. | Checking API availability. | | [references/proxy.md](references/proxy.md) | **get-proxy-list** parameters. | Listing proxies. | | [references/proxy-config.md](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](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](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](references/ua-version.md) | **ua_system_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.

path: schema.json
content: {
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "TgeBrowser MCP Tools",
  "tools": {
    "mcp__tgebrowser__open-browser": {
      "description": "Open a browser environment",
      "parameters": {
        "type": "object",
        "properties": {
          "envId": {
            "type": "number",
            "description": "Environment id to open"
          },
          "userIndex": {
            "type": "number",
            "description": "Environment index to open"
          },
          "args": {
            "type": "array",
            "items": { "type": "string" },
            "description": "Extra browser launch args, e.g. [\"--headless\"]"
          },
          "port": {
            "type": "number",
            "description": "Custom remote debugging port"
          }
        }
      }
    },
    "mcp__tgebrowser__create-browser": {
      "description": "Create a browser environment",
      "parameters": {
        "type": "object",
        "required": ["browserName", "proxy"],
        "properties": {
          "browserName": {
            "type": "string",
            "description": "Environment name"
          },
          "proxy": {
            "type": "object",
            "required": ["protocol"],
            "properties": {
              "protocol": {
                "type": "string",
                "enum": ["http", "https", "socks5", "direct"],
                "description": "Proxy protocol"
              },
              "host": { "type": "string" },
              "port": { "type": "number" },
              "username": { "type": "string" },
              "password": { "type": "string" }
            }
          },
          "fingerprint": {
            "type": "object",
            "properties": {
              "os": {
                "type": "string",
                "enum": ["Windows", "macOS", "Android", "iOS"],
                "description": "Operating system"
              },
              "language": { "type": "string" },
              "timezone": { "type": "string" },
              "webrtc": { "type": "string" }
            }
          },
          "groupId": {
            "type": "number",
            "description": "Group id"
          },
          "remark": {
            "type": "string",
            "description": "Remarks"
          }
        }
      }
    },
    "mcp__tgebrowser__get-browser-list": {
      "description": "Get the list of browser environments",
      "parameters": {
        "type": "object",
        "properties": {
          "current": {
            "type": "number",
            "description": "Page number, default 1"
          },
          "pageSize": {
            "type": "number",
            "description": "Results per page"
          },
          "keyword": {
            "type": "string",
            "description": "Search keyword"
          },
          "groupId": {
            "type": "number",
            "description": "Filter by group id"
          }
        }
      }
    },
    "mcp__tgebrowser__close-browser": {
      "description": "Close a browser environment",
      "parameters": {
        "type": "object",
        "properties": {
          "envId": { "type": "number" },
          "userIndex": { "type": "number" }
        }
      }
    },
    "mcp__tgebrowser__delete-browser": {
      "description": "Delete a browser environment",
      "parameters": {
        "type": "object",
        "properties": {
          "envId": { "type": "number" },
          "userIndex": { "type": "number" }
        }
      }
    }
  }
}


path: references/country-code.md
content: # Country Code

Use the two-letter lowercase code in the `country` field for create-browser / update-browser.

| Code | Country |
|------|---------|
| ad | Andorra |
| ae | United Arab Emirates |
| af | Afghanistan |
| ag | Antigua & Barbuda |
| ai | Anguilla |
| al | Albania |
| am | Armenia |
| ao | Angola |
| aq | Antarctica |
| ar | Argentina |
| as | American Samoa |
| at | Austria |
| au | Australia |
| aw | Aruba |
| ax | Åland Islands |
| az | Azerbaijan |
| ba | Bosnia & Herzegovina |
| bb | Barbados |
| bd | Bangladesh |
| be | Belgium |
| bf | Burkina |
| bg | Bulgaria |
| bh | Bahrain |
| bi | Burundi |
| bj | Benin |
| bl | Saint Barthélemy |
| bm | Bermuda |
| bn | Brunei |
| bo | Bolivia |
| bq | Caribbean Netherlands |
| br | Brazil |
| bs | The Bahamas |
| bt | Bhutan |
| bv | Bouvet Island |
| bw | Botswana |
| by | Belarus |
| bz | Belize |
| ca | Canada |
| cc | Cocos (Keeling) Islands |
| cd | Democratic Republic of the Congo |
| cf | Central African Republic |
| cg | Republic of the Congo |
| ch | Switzerland |
| ci | Côte d'Ivoire |
| cl | Chile |
| cm | Cameroon |
| cn | China |
| co | Colombia |
| cr | Costa Rica |
| cu | Cuba |
| cv | Cape Verde |
| cx | Christmas Island |
| cy | Cyprus |
| cz | Czech Republic |
| de | Germany |
| dj | Djibouti |
| dk | Denmark |
| dm | Dominica |
| do | Dominican Republic |
| dz | Algeria |
| ec | Ecuador |
| ee | Estonia |
| eg | Egypt |
| eh | Western Sahara |
| er | Eritrea |
| es | Spain |
| et | Ethiopia |
| fi | Finland |
| fj | Fiji |
| fk | Falkland Islands |
| fm | Federated States of Micronesia |
| fo | Faroe Islands |
| fr | France |
| ga | Gabon |
| gb | Great Britain |
| gd | Grenada |
| ge | Georgia |
| gf | French Guiana |
| gg | Guernsey |
| gh | Ghana |
| gi | Gibraltar |
| gl | Greenland |
| gm | Gambia |
| gn | Guinea |
| gp | Guadeloupe |
| gq | Equatorial Guinea |
| gr | Greece |
| gs | South Georgia and the South Sandwich Islands |
| gt | Guatemala |
| gu | Guam |
| gw | Guinea-Bissau |
| gy | Guyana |
| hk | China Hong Kong |
| hm | Heard Island and McDonald Islands |
| hn | Honduras |
| hr | Croatia |
| ht | Haiti |
| hu | Hungary |
| id | Indonesia |
| ie | Ireland |
| il | Israel |
| im | Isle of Man |
| in | India |
| io | British Indian Ocean Territory |
| iq | Iraq |
| ir | Iran |
| is | Iceland |
| it | Italy |
| je | Jersey |
| jm | Jamaica |
| jo | Jordan |
| jp | Japan |
| ke | Kenya |
| kg | Kyrgyzstan |
| kh | Cambodia |
| ki | Kiribati |
| km | The Comoros |
| kn | St. Kitts & Nevis |
| kp | North Korea |
| kr | South Korea |
| kw | Kuwait |
| ky | Cayman Islands |
| kz | Kazakhstan |
| la | Laos |
| lb | Lebanon |
| lc | St. Lucia |
| li | Liechtenstein |
| lk | Sri Lanka |
| lr | Liberia |
| ls | Lesotho |
| lt | Lithuania |
| lu | Luxembourg |
| lv | Latvia |
| ly | Libya |
| ma | Morocco |
| mc | Monaco |
| md | Moldova |
| me | Montenegro |
| mf | Saint Martin (France) |
| mg | Madagascar |
| mh | Marshall islands |
| mk | Republic of Macedonia (FYROM) |
| ml | Mali |
| mm | Myanmar (Burma) |
| mn | Mongolia |
| mo | China Macao |
| mp | Northern Mariana Islands |
| mq | Martinique |
| mr | Mauritania |
| ms | Montserrat |
| mt | Malta |
| mu | Mauritius |
| mv | Maldives |
| mw | Malawi |
| mx | Mexico |
| my | Malaysia |
| mz | Mozambique |
| na | Namibia |
| nc | New Caledonia |
| ne | Niger |
| nf | Norfolk Island |
| ng | Nigeria |
| ni | Nicaragua |
| nl | Netherlands |
| no | Norway |
| np | Nepal |
| nr | Nauru |
| nu | Niue |
| nz | New Zealand |
| om | Oman |
| pa | Panama |
| pe | Peru |
| pf | French polynesia |
| pg | Papua New Guinea |
| ph | The Philippines |
| pk | Pakistan |
| pl | Poland |
| pm | Saint-Pierre and Miquelon |
| pn | Pitcairn Islands |
| pr | Puerto Rico |
| ps | Palestinian territories |
| pt | Portugal |
| pw | Palau |
| py | Paraguay |
| qa | Qatar |
| re | Réunion |
| ro | Romania |
| rs | Serbia |
| ru | Russian Federation |
| rw | Rwanda |
| sa | Saudi Arabia |
| sb | Solomon Islands |
| sc | Seychelles |
| sd | Sudan |
| se | Sweden |
| sg | Singapore |
| sh | St. Helena & Dependencies |
| si | Slovenia |
| sj | Template:Country data SJM Svalbard |
| sk | Slovakia |
| sl | Sierra Leone |
| sm | San Marino |
| sn | Senegal |
| so | Somalia |
| sr | Suriname |
| ss | South Sudan |
| st | Sao Tome & Principe |
| sv | El Salvador |
| sy | Syria |
| sz | Swaziland |
| tc | Turks & Caicos Islands |
| td | Chad |
| tf | French Southern Territories |
| tg | Togo |
| th | Thailand |
| tj | Tajikistan |
| tk | Tokelau |
| tl | Timor-Leste (East Timor) |
| tm | Turkmenistan |
| tn | Tunisia |
| to | Tonga |
| tr | Turkey |
| tt | Trinidad & Tobago |
| tv | Tuvalu |
| tw | China Taiwan |
| tz | Tanzania |
| ua | Ukraine |
| ug | Uganda |
| um | United States Minor Outlying Islands |
| us | United States of America (USA) |
| uy | Uruguay |
| uz | Uzbekistan |
| va | Vatican City (The Holy See) |
| vc | St. Vincent & the Grenadines |
| ve | Venezuela |
| vg | British Virgin Islands |
| vi | United States Virgin Islands |
| vn | Vietnam |
| vu | Vanuatu |
| wf | Wallis and Futuna |
| ws | Samoa |
| ye | Yemen |
| yt | Mayotte |
| za | South Africa |
| zm | Zambia |
| zw | Zimbabwe |
| ck | Cook Islands |


path: references/environment-management.md
content: # Environment Management

**mcp__tgebrowser__open-browser** — Open a browser environment.

- **envId** (optional): Environment id to open.
- **userIndex** (optional): Environment index to open. One of envId or userIndex is required.
- **args** (optional): Extra browser launch args, e.g. `["--headless"]`.
- **port** (optional): Custom remote debugging port.

Returns: `envId`, `userIndex`, WebSocket URL (`ws`), `http`, `port`. Use the ws URL with mcp__tgebrowser__connect-browser-with-ws to enable automation.

**mcp__tgebrowser__close-browser** — Close a browser environment.

- **envId** (optional): Environment id to close.
- **userIndex** (optional): Environment index to close. One of envId or userIndex is required.

**mcp__tgebrowser__create-browser** — Create a browser environment.

- **browserName** (required): Environment name.
- **proxy** (required): Proxy config. Must include at minimum `protocol`. Use `{"protocol":"direct"}` for no proxy. See [proxy-config.md](proxy-config.md).
- **groupId** (optional): Group id (number). Omit for ungrouped.
- **remark** (optional): Remarks.
- **fingerprint** (optional): Fingerprint config. `os` is required when provided (e.g. `"Windows"`, `"macOS"`, `"Android"`, `"iOS"`). See [fingerprint.md](fingerprint.md).
- **startInfo** (optional): Startup config with `startPage` and `otherConfig`.
- **Cookie** (optional): Cookie data.

**mcp__tgebrowser__update-browser** — Update a browser environment.

- **envId** (required): Environment id to update.
- **browserName** (required): Environment name.
- **groupId**, **remark**, **proxy**, **fingerprint**, **startInfo**, **Cookie** (all optional).

**mcp__tgebrowser__delete-browser** — Delete a browser environment.

- **envId** (optional): Environment id to delete.
- **userIndex** (optional): Environment index to delete. One of envId or userIndex is required.

**mcp__tgebrowser__get-browser-list** — Get the list of browser environments.

- **current** (optional): Page number, default 1.
- **pageSize** (optional): Results per page.
- **keyword** (optional): Search keyword.
- **groupId** (optional): Filter by group id (number).

**mcp__tgebrowser__get-opened-browser** — Get the list of currently opened browser environments.

- No parameters.

**mcp__tgebrowser__get-profile-cookies** — Get cookies of a browser environment.

- **envId** (optional): Environment id.
- **userIndex** (optional): Environment index. One of envId or userIndex is required.

**mcp__tgebrowser__get-profile-ua** — Get User-Agent of a browser environment.

- **envId** (optional): Environment id.
- **userIndex** (optional): Environment index. One of envId or userIndex is required.

**mcp__tgebrowser__close-all-profiles** — Close all opened browser environments on the current device.

- No parameters.

**mcp__tgebrowser__new-fingerprint** — Generate a new random fingerprint for a browser environment.

- **envId** (optional): Environment id.
- **userIndex** (optional): Environment index. One of envId or userIndex is required.

**mcp__tgebrowser__delete-cache** — Clear local cache of a browser environment. Ensure the browser is closed before using.

- **envId** (optional): Environment id.
- **userIndex** (optional): Environment index. One of envId or userIndex is required.

**mcp__tgebrowser__get-browser-active** — Get active (opened) browser environment information.

- **profileId** (optional): Profile ID.
- **profileNo** (optional): Profile number.


path: references/fingerprint.md
content: # FingerprintConfig (fingerprint config for create-browser / update-browser)

**fingerprint** is passed under `create-browser` / `update-browser`. All fields are optional unless noted.

- **os** (required for create-browser): Operating system. e.g. `"Windows"`, `"macOS"`, `"Android"`, `"iOS"`
- **kernel** (optional): Browser kernel version string, e.g. `"143"`. See [kernel-config.md](kernel-config.md) for valid values.
- **userAgent** (optional): Custom User-Agent string.
- **resolution** (optional): Screen resolution, e.g. `"1920_1080"`. Use `"none"` to follow computer.
- **windowWidth** / **windowHeight** (optional): Window size in pixels.
- **language** (optional): Language string, e.g. `"en-US"`.
- **languageBaseIp** (optional): Auto-set language by IP. `true` / `false`.
- **uiLanguage** (optional): UI language, e.g. `"en-US"`.
- **uiLanguageBaseIp** (optional): Auto-set UI language by IP. `true` / `false`.
- **timezone** (optional): Timezone, e.g. `"America/New_York"`.
- **timezoneBaseIp** (optional): Auto-set timezone by IP. `true` / `false`.
- **geolocationBaseIp** (optional): Auto-set geolocation by IP. `true` / `false`.
- **lat** / **lng** (optional): Custom latitude/longitude strings when geolocationBaseIp is false.
- **canvas** (optional): Canvas fingerprint noise. `true` add noise / `false` computer default.
- **audioContext** (optional): Audio fingerprint noise. `true` / `false`.
- **speechVoices** (optional): Replace speech voices. `true` / `false`.
- **clientRects** (optional): ClientRects noise. `true` / `false`.
- **fonts** (optional): Font list, e.g. `["Arial", "Times New Roman"]`.
- **webrtc** (optional): WebRTC policy. e.g. `"disabled"` / `"forward"` / `"proxy"` / `"local"`.
- **ram** (optional): Device memory (GB), e.g. `4`.
- **cpu** (optional): CPU cores, e.g. `4`.
- **hardwareAcceleration** (optional): `true` / `false`.
- **disableSandbox** (optional): `true` / `false`.
- **startupParams** (optional): Extra browser startup params string.
- **deviceName** (optional): Custom device name string.
- **deviceMedia** (optional): Media device noise. `true` / `false`.
- **portScanProtection** (optional): Port scan protection. e.g. `"1"` enable / `"0"` disable.
- **randomFingerprint** (optional): Randomize all fingerprint fields. `true` / `false`.
- **blockLargeImages** (optional): `true` / `false`.
- **maxImageKB** (optional): Max image size in KB.
- **syncCookies** (optional): `true` / `false`.
- **clearCacheOnStart** (optional): `true` / `false`.
- **clearCachePreserveExtensionsOnStart** (optional): `true` / `false`.
- **clearCookiesOnStart** (optional): `true` / `false`.
- **clearHistoryOnStart** (optional): `true` / `false`.
- **disableMediaAutoplay** (optional): `true` / `false`.
- **muteAllMedia** (optional): `true` / `false`.
- **disableGoogleTranslate** (optional): `true` / `false`.
- **disableSavePasswordPrompt** (optional): `true` / `false`.
- **disableNotifications** (optional): `true` / `false`.
- **blockClipboardRead** (optional): `true` / `false`.
- **stopOnNetworkIssue** (optional): `true` / `false`.
- **stopOnIPChange** (optional): `true` / `false`.
- **stopOnCountryChange** (optional): `true` / `false`.
- **disableTLS** (optional): Array of TLS cipher hex codes to disable. See [tls-cipher.md](tls-cipher.md).
- **mobileDeviceId** (optional): Mobile device id (number).
- **platformVersion** (optional): Platform version (number).

Example: `"fingerprint":{"os":"Windows","kernel":"143","timezone":"America/New_York","language":"en-US","webrtc":"disabled"}`


path: references/group.md
content: # Group Management

**mcp__tgebrowser__get-group-list** — Get the list of groups.

- **current** (optional): Page number, default 1.
- **pageSize** (optional): Results per page.


path: references/kernel-config.md
content: # Browser kernel config

Used under **fingerprint** → **kernel** (version string) for create-browser / update-browser.

Only Chrome is supported. Pass the version as a string.

## Supported values

`133`, `135`, `137`, `139`, `141`, `143`, `ua_auto` (default)

## Example

`"fingerprint": { "os": "Windows", "kernel": "143" }`


path: references/proxy-config.md
content: # Proxy Config (proxy field for create-browser / update-browser)

The **proxy** field is **required** for `create-browser`. Pass an object with the following fields:

- **protocol** (required): Proxy protocol. e.g. `"http"`, `"socks5"`, `"direct"` (no proxy)
- **host** (optional): Proxy host, e.g. `"127.0.0.1"`
- **port** (optional): Proxy port, e.g. `8080`
- **username** (optional): Proxy username
- **password** (optional): Proxy password
- **proxyId** (optional): Saved proxy id (number)
- **timezone** (optional): Timezone override for this proxy

Example (no proxy): `"proxy":{"protocol":"direct"}`

Example (HTTP proxy): `"proxy":{"protocol":"http","host":"127.0.0.1","port":8080,"username":"user","password":"pass"}`


path: references/proxy.md
content: # Proxy Management

**mcp__tgebrowser__get-proxy-list** — Get the list of proxies.

- **current** (optional): Page number, default 1.
- **pageSize** (optional): Results per page.


path: references/system.md
content: # System

**mcp__tgebrowser__check-status** — Check the availability of the current device API interface.

- No parameters.


path: references/tls-cipher.md
content: # Chrome TLS Cipher Suites (tls enum)

**tls** is only supported when the browser kernel is **Chrome**. Use comma-separated hex codes in **fingerprint.disableTLS**, e.g. `["0xC02C","0xC030"]`.

| Name | Hex code |
|------|----------|
| TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 | 0xC02C |
| TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 | 0xC030 |
| TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 | 0xC02B |
| TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 | 0xC02F |
| TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256 | 0xCCA9 |
| TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256 | 0xCCA8 |
| TLS_DHE_RSA_WITH_AES_256_GCM_SHA384 | 0x009F |
| TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 | 0x009E |
| TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 | 0xC024 |
| TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 | 0xC028 |
| TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA | 0xC00A |
| TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA | 0xC014 |
| TLS_DHE_RSA_WITH_AES_256_CBC_SHA256 | 0x006B |
| TLS_DHE_RSA_WITH_AES_256_CBC_SHA | 0x0039 |
| TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 | 0xC023 |
| TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 | 0xC027 |
| TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA | 0xC009 |
| TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA | 0xC013 |
| TLS_DHE_RSA_WITH_AES_128_CBC_SHA256 | 0x0067 |
| TLS_DHE_RSA_WITH_AES_128_CBC_SHA | 0x0033 |
| TLS_RSA_WITH_AES_256_GCM_SHA384 | 0x009D |
| TLS_RSA_WITH_AES_128_GCM_SHA256 | 0x009C |
| TLS_RSA_WITH_AES_256_CBC_SHA256 | 0x003D |
| TLS_RSA_WITH_AES_128_CBC_SHA256 | 0x003C |
| TLS_RSA_WITH_AES_256_CBC_SHA | 0x0035 |
| TLS_RSA_WITH_AES_128_CBC_SHA | 0x002F |
| TLS_AES_128_CCM_8_SHA256 | 0x1305 |
| TLS_AES_128_CCM_SHA256 | 0x1304 |


path: references/ua-version.md
content: # Random UA — `ua_system_version` enum

Used under **fingerprint** → **random_ua** → **ua_system_version**.

## Specific versions (fixed OS version)

| System   | Values |
|----------|--------|
| Android  | `Android 9`, `Android 10`, `Android 11`, `Android 12`, `Android 13`, `Android 14`, `Android 15` |
| iOS      | `iOS 14`, `iOS 15`, `iOS 16`, `iOS 17`, `iOS 18`, `iOS 26` |
| Windows  | `Windows 7`, `Windows 8`, `Windows 10`, `Windows 11` |
| Mac OS X | `Mac OS X 10`, `Mac OS X 11`, `Mac OS X 12`, `Mac OS X 13`, `Mac OS X 14`, `Mac OS X 15`, `Mac OS X 26` |
| Linux    | `Linux` |

## Generic (random any version of that system)

- `Mac OS X` — random any macOS version  
- `Windows` — random any Windows version  
- `iOS` — random any iOS version  
- `Android` — random any Android version  
- `Linux` — random any Linux (same as specific `Linux` here)

## Behavior

- **Omit** `ua_system_version`: UA is chosen at random across **all** systems.
- **Provide** an array: UA is chosen only from the listed system/versions (specific and/or generic can be mixed).

## Examples

- `["Android 9", "iOS 14"]` — only Android 9 or iOS 14
- `["Android", "Mac OS X"]` — any Android version or any macOS version
- `["Windows 11", "Mac OS X 15"]` — only Windows 11 or Mac OS X 15


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)