State
State — MCP tools exposed to agents.
24 tools in this group.
browser_cookie_list
List cookies for the current session, optionally filtered by domain. Prints name/value plus domain/path and relevant flags.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
domain | string | no | Optional: only list cookies whose domain matches (exact, leading-dot, or dot-boundary subdomain) | |
session | string | no | Optional: named session to run this call in (default: current session). |
browser_cookie_get
Print the cookie(s) matching a name, optionally scoped by domain. Lists every matching domain/path variant. Errors when no cookie matches.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
domain | string | no | Optional: restrict the match to this domain | |
name | string | yes | Cookie name to look up | |
session | string | no | Optional: named session to run this call in (default: current session). |
browser_cookie_set
Set a cookie (name/value, plus optional domain, path, secure, httpOnly, sameSite, expiry). Domain defaults to the current page host.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
domain | string | no | Cookie domain (optional, defaults to current page domain) | |
expiry | integer | no | Optional: expiry as unix seconds. Omit for a session cookie. | |
httpOnly | boolean | no | Optional: mark the cookie HttpOnly (invisible to page JavaScript). Defaults to false. | |
name | string | yes | Cookie name | |
path | string | no | Cookie path (optional, defaults to /) | |
sameSite | string | no | Optional: SameSite policy. "none" requires secure=true. Omit for the browser default. (one of: strict, lax, none, default) | |
secure | boolean | no | Optional: mark the cookie Secure (HTTPS-only). Defaults to false. | |
session | string | no | Optional: named session to run this call in (default: current session). | |
value | string | yes | Cookie value |
browser_cookie_delete
Delete the cookie(s) matching a name, optionally scoped by domain. A domain-scoped delete never removes a same-named cookie on another domain.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
domain | string | no | Optional: restrict deletion to this domain | |
name | string | yes | Cookie name to delete | |
session | string | no | Optional: named session to run this call in (default: current session). |
browser_cookie_clear
Clear all cookies, or only those matching a domain filter.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
domain | string | no | Optional: only clear cookies whose domain matches | |
session | string | no | Optional: named session to run this call in (default: current session). |
browser_localstorage_list
List all localStorage keys and values for the active page origin. Requires an http(s) page.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
session | string | no | Optional: named session to run this call in (default: current session). |
browser_localstorage_get
Read a localStorage value by key for the active page origin. Errors when the key is not set.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
key | string | yes | Storage key to read | |
session | string | no | Optional: named session to run this call in (default: current session). |
browser_localstorage_set
Set a localStorage key to a value for the active page origin.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
key | string | yes | Storage key to write | |
session | string | no | Optional: named session to run this call in (default: current session). | |
value | string | yes | String value to store |
browser_localstorage_delete
Delete a localStorage key for the active page origin.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
key | string | yes | Storage key to remove | |
session | string | no | Optional: named session to run this call in (default: current session). |
browser_localstorage_clear
Clear all localStorage for the active page origin.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
session | string | no | Optional: named session to run this call in (default: current session). |
browser_sessionstorage_list
List all sessionStorage keys and values for the active page origin. Requires an http(s) page.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
session | string | no | Optional: named session to run this call in (default: current session). |
browser_sessionstorage_get
Read a sessionStorage value by key for the active page origin. Errors when the key is not set.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
key | string | yes | Storage key to read | |
session | string | no | Optional: named session to run this call in (default: current session). |
browser_sessionstorage_set
Set a sessionStorage key to a value for the active page origin.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
key | string | yes | Storage key to write | |
session | string | no | Optional: named session to run this call in (default: current session). | |
value | string | yes | String value to store |
browser_sessionstorage_delete
Delete a sessionStorage key for the active page origin.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
key | string | yes | Storage key to remove | |
session | string | no | Optional: named session to run this call in (default: current session). |
browser_sessionstorage_clear
Clear all sessionStorage for the active page origin.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
session | string | no | Optional: named session to run this call in (default: current session). |
browser_storage_save
Save the current session's cookies, localStorage, and sessionStorage as a named snapshot. Only the active page's origin is captured for web storage; cookies span the whole session.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
name | string | yes | Snapshot name: lowercase letters, digits, '_', '-', '.' (no whitespace or path separators) | |
session | string | no | Optional: named session to run this call in (default: current session). |
browser_storage_load
Restore a named storage snapshot into the current session (cookies + per-origin localStorage/sessionStorage). Reports any origin-level restore failures.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
name | string | yes | Name of the saved snapshot to load | |
session | string | no | Optional: named session to run this call in (default: current session). |
browser_storage_list
List saved storage snapshots with redacted metadata (counts only, no values). Local registry operation — no browser required.
No parameters.
browser_storage_show
Show a saved snapshot's metadata and counts. Never prints raw cookie or storage values. Local registry operation — no browser required.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
name | string | yes | Name of the saved snapshot |
browser_storage_delete
Delete a saved storage snapshot. Local registry operation — no browser required.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
name | string | yes | Name of the saved snapshot to delete |
browser_storage_export
Export a saved snapshot's canonical JSON to a file path. Local registry operation — no browser required.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
name | string | yes | Name of the saved snapshot to export | |
path | string | yes | Destination file path for the canonical JSON |
browser_storage_import
Import a canonical storage JSON file into the registry under a name. Validates the JSON, rewrites the name, and updates timestamps. Local registry operation — no browser required.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
name | string | yes | Name to store the imported snapshot under | |
path | string | yes | Path to the canonical storage JSON file to import |
browser_download_set_dir
Set the download directory for the browser
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
path | string | yes | Directory path for downloads | |
session | string | no | Optional: named session to run this call in (default: current session). |
browser_wait_download
Wait for the next download to finish and return its status, URL, and filepath when available
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
session | string | no | Optional: named session to run this call in (default: current session). | |
timeout_ms | integer | no | 30000 | Timeout in milliseconds (default: 30000) |