Verify that the FlashID desktop client is reachable and that the Local API and API key are set up. Call this first when any other tool fails, to diagnose the setup.

List browser profiles (environments) with pagination and search. Note: running state is not part of this list — use list_running_browsers for that.

Get the full configuration of a profile, including its fingerprint (browser_config), proxy and folder. cookie_data is omitted unless include_cookie is true (cookies can be very large).

Create a browser profile. Only system is required — everything else has sensible defaults and omitted fingerprint fields are auto-generated as a coherent random fingerprint. Bind a proxy via proxy (static = saved proxy from list_proxies; rotating = dynamic residential). Fine-grained fingerprint control goes in advanced. Returns the new profile_uuid.

Partial update of a profile — send only the fields to change; omitted fields keep their current value (fingerprint, proxy, name, everything). For just name / note / folder / proxy prefer quick_update_profile.

Lightweight partial update of non-fingerprint info: name, note, folder and/or proxy. Send only the fields to change. folder_uuid "0" moves the profile out of its folder (root).

Move a profile to Trash. Recoverable with restore_from_trash.

Toggle the star (favorite) flag of a profile. Returns the new stars_status (1 = starred).

List the selectable values for a fingerprint field (for manual fingerprint configuration). For type=webgl both system and gpu_vendor are required.

Generate a coherent set of random fingerprint values for an OS. Rarely needed — create_profile auto-generates omitted fingerprint fields already. Useful to preview values or fill advanced manually.

Launch the browser for a profile and wait until it is ready. Returns automation endpoints: ws.puppeteer (CDP WebSocket — connect Playwright/Puppeteer or a browser-automation MCP to drive pages), ws.selenium (host:port) and debug_port. Usually takes a few seconds; the first launch can take minutes while the browser kernel downloads.

Close one or more running browsers by profile UUID.

List currently running browsers with their automation endpoints (ws.puppeteer / ws.selenium / debug_port).

List saved proxies. Use the returned proxy_uuid to bind a proxy to a profile (create_profile / quick_update_profile with proxy.mode=static).

Save one or more proxies (max 500 per call). Only proxy_type / proxy_host / proxy_port are required. Duplicates already in the account are detected and skipped.

Partial update of a saved proxy — send only the fields to change.

Delete a saved proxy. This cannot be undone.

Test connectivity of a proxy (saved or not) and return its detected exit IP and geo info. May take up to a minute for slow proxies.

Regions for rotating (dynamic residential) proxies. Without arguments returns countries (name + code); pass country to get its states/cities. In create_profile / quick_update_profile use the country code as proxy.region and the state/city value as proxy.state / proxy.city.

List profile folders.

Create a profile folder.

Rename a folder.

Delete a folder.

List profiles currently in the trash (recycle bin).

Restore profiles from trash — specific ones via profile_uuids, or everything via all=true.

PERMANENTLY delete profiles from trash — specific ones via profile_uuids, or empty the whole trash via all=true. This cannot be undone. Only affects profiles already in trash.