Skip to main content
Glama
DICloak Local API MCP Server

DICloak Local API MCP Server

Official

updateEnv

Updates an existing DICloak browser environment with a complete request body; include the environment ID, name, browser type, and group ID to apply profile changes.

Instructions

Update environment

IMPORTANT: Server requires a complete request body. Full template (use as-is, replace required fields like name, browser, group_id): { "extensions_type": "ALLOW", "name": "", "browser": "CHROME", "group_id": "", "browser_version_id": "120", "ua_os": "WINDOWS", "os": { "windows": [ "windows-all" ], "mac": [], "android": [], "ios": [], "linux": [] }, "ua_type": "["all"]", "ua": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/121.0.6134.0 Safari/537.36", "proxy_way": "CUSTOM", "proxy_type": "NON_USE", "proxy_ip_type": "IPAPI", "proxy_ip_addr_type": "IPV4", "account_list": [], "urls": [], "fixed_urls": [], "restore_url_type": "GLOBAL", "config": "{"acceptLangType":"ip","acceptLangValue":["en-US","en"],"langType":"acceptLang","langValue":"local","timezoneType":"ip","timezoneValue":"local","geoType":"ask","geoSubType":"ip","geoValue":{},"fontType":"custom","fontValue":["default"],"webrtcType":"disable","webrtcValue":"","canvasType":"noise","canvasValue":78307,"ratioType":"truth","ratioValue":"","ratioWidth":"","webGLImageType":"noise","webGLImageValue":12684,"mediadeviceType":"noise","mediadeviceValue":13189,"webGLMetadataType":"custom","webglManufacturer":"Google Inc. (NVIDIA)","webglRender":"ANGLE (NVIDIA, NVIDIA GeForce GTX 1050 Direct3D11 vs_5_0 ps_5_0, D3D11-31.0.15.3161)","webGPUType":"inWebGL","webGPUTypeValue":82291,"audioContextType":"noise","audioContextValue":51461,"clientRectsType":"noise","clientRectsValue":75611,"speechVoicesType":"noise","speechVoicesValue":49546,"hardwareConcurrencyValue":"10","deviceMemoryValue":"2","trackType":"0","batteryType":"noise","batteryValue":67456,"portType":"1","portValue":"","accelerateType":"0","startParams":"","deviceNameType":"truth","deviceNameValue":"","macType":"truth","macValue":"","macTruthValue":"6c:1f:f7:0f:65:58"}", "data_config_option": [ 1 ], "browser_config_option": [ 1 ], "data_type": "global", "browser_type": "global", "env_mutil_open_type": "GLOBAL", "spoofing_video_type": "DISABLE", "local_data_config": "{"type":0,"browserType":"global","dataType":null}", "proxy_soft_enable": true, "proxy_soft": "NONE", "proxy_soft_info": { "ip": "", "country": "", "country_code": "", "region": "", "region_code": "", "city": "" }, "proxy_api_info": { "ip_method": "EVERY_TIME", "url": "", "ip": "", "port": "" }, "bookmark_config_val": { "bookmark_type": "global", "status": false, "file_content": [], "cover_rule": 1, "file_name": "", "type": 1 }, "access_limit_config_val": { "access_limit_type": "global", "status": false, "type": 1, "quick_selection_option": [], "quick_selection_type": 0, "url_list": "" }, "env_tag_ids": [], "extensions_group_id": "", "data_config": "{"type":0,"dataType":"global"}", "browser_config": "{"type":0,"browserType":"global"}", "bookmark_config": "{"bookmarkType":"global","status":false,"fileContent":[],"coverRule":1,"fileName":"","type":1}", "access_limit_config": "{"accessLimitType":"global","status":false,"type":1,"quickSelectionOption":[],"quickSelectionType":0,"urlList":""}" }

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "envId": "<envId>",
      "name": "<name>",
      "browser": "<browser>",
      "group_id": "<group_id>"
    },
    "name": "updateEnv"
  }
}

Input Schema

NameRequiredDescriptionDefault
osNoSubset configuration for multi-platform support.
uaNoUser-Agent string. If omitted, a random UA is used. Random UAs follow formats like Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/121.0.6134.0 Safari/537.36.
nameYesEnvironment name (must be provided by the user, or use an auto-generated placeholder).
urlsNoStartup URL list (default: empty).
envIdYes
ua_osNoUA operating system used for UA selection.WINDOWS
configNoFingerprint configuration (JSON string). If using the default template, keep this field as the default JSON string. For numeric values (e.g. canvasValue) generate a reasonable 5-digit integer if randomized. Other types (truth or noise) can keep the default values.{}
browserYesBrowser type (e.g., CHROME).CHROME
ua_typeNoUA selection type.["all"]
group_idYesGroup ID (required). If unknown, call GET /v1/env/group and use the id of the group with is_default = true.
data_typeNoData type field.global
group_idsNoList of group IDs (for backward compatibility).
proxy_wayNoProxy usage method.CUSTOM
fixed_urlsNoFixed URL list (default: empty).
proxy_softNoProxy provider type.NONE
proxy_typeNoProxy type.NON_USE
data_configNoData configuration JSON string{"type":0,"dataType":"global"}
env_tag_idsNoList of environment tag IDs
account_listNoAccount list (default: empty array).
browser_typeNoBrowser configuration type.global
proxy_ip_typeNoProxy lookup/detection source.IPAPI
browser_configNoBrowser configuration JSON string{"type":0,"browserType":"global"}
proxy_api_infoNoAPI for fetching proxy information.
bookmark_configNoBookmark configuration JSON string{"bookmarkType":"global","status":false,"fileContent":[],"coverRule":1,"fileName":"","type":1}
extensions_typeNoExtension loading policy.ALLOW
proxy_soft_infoNoProxy provider information (default: empty strings/values).
restore_url_typeNoStartup page restore type.GLOBAL
local_data_configNoCompatibility field, usually a JSON string.DISABLE
proxy_soft_enableNoWhether the proxy provider reads configured accounts.
browser_version_idNoBrowser version ID.120
data_config_optionNoData configuration options, usually an array of integers.
proxy_ip_addr_typeNoProxy IP address type.IPV4
access_limit_configNoAccess limit configuration JSON string{"accessLimitType":"global","status":false,"type":1,"quickSelectionOption":[],"quickSelectionType":0,"urlList":""}
bookmark_config_valNoBookmark settings
env_mutil_open_typeNoMulti-open type field.GLOBAL
extensions_group_idNoExtensions group ID
spoofing_video_typeNoVideo stream spoofing type.DISABLE
browser_config_optionNoBrowser configuration options, usually an array of integers.
access_limit_config_valNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

B3.3/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations exist, so the description carries the full behavioral burden. It does disclose one important trait — a complete body is required, implying full-replace semantics that would overwrite existing configuration — which is real value. But it says nothing about irreversibility, side effects on running environments, permission requirements, or what happens to fields the caller leaves at defaults, which is a large remaining gap for a destructive 39-parameter mutation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The purpose statement and the IMPORTANT warning are properly front-loaded, and the template is functionally useful for a tool that demands a complete body. But roughly two kilobytes of JSON follow, much of it duplicating defaults already present in the schema, making the description a wall of text rather than a structured explanation.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 39-parameter mutation with no annotations and no output schema, the full-body template addresses the hardest part of invoking it correctly. It still leaves critical gaps: how envId is supplied (missing from the template despite being required), whether unspecified fields are reset or preserved, and what a successful response looks like.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 95%, so the baseline is 3 regardless. The template adds a concrete, valid full payload and names the fields most likely to need real values (name, browser, group_id), but it does not explain envId — a required parameter that notably does not even appear in the template — nor clarify the interplay between paired fields like data_config and data_config_option.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

"Update environment" gives a specific verb and resource, and the resource (environment) is distinct from the visible siblings (updateEnvGroup, updateProxy, updateMember). It stops short of differentiating when this is appropriate versus adjacent tools such as closeEnv or getEnvInfo, but an agent can identify the operation without opening the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The line "Server requires a complete request body. Full template (use as-is, replace required fields like name, browser, group_id)" is genuinely operational guidance: it tells the agent this is a full replace, not a partial patch, and to start from the template. However there is no when-to-use guidance, no note about prerequisites, and no mention of reading the environment first via getEnvInfo before overwriting it.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.