State

State — MCP tools exposed to agents.

24 tools in this group.

List cookies for the current session, optionally filtered by domain. Prints name/value plus domain/path and relevant flags.

ParameterTypeRequiredDefaultDescription
domainstringnoOptional: only list cookies whose domain matches (exact, leading-dot, or dot-boundary subdomain)
sessionstringnoOptional: named session to run this call in (default: current session).

Print the cookie(s) matching a name, optionally scoped by domain. Lists every matching domain/path variant. Errors when no cookie matches.

ParameterTypeRequiredDefaultDescription
domainstringnoOptional: restrict the match to this domain
namestringyesCookie name to look up
sessionstringnoOptional: named session to run this call in (default: current session).

Set a cookie (name/value, plus optional domain, path, secure, httpOnly, sameSite, expiry). Domain defaults to the current page host.

ParameterTypeRequiredDefaultDescription
domainstringnoCookie domain (optional, defaults to current page domain)
expiryintegernoOptional: expiry as unix seconds. Omit for a session cookie.
httpOnlybooleannoOptional: mark the cookie HttpOnly (invisible to page JavaScript). Defaults to false.
namestringyesCookie name
pathstringnoCookie path (optional, defaults to /)
sameSitestringnoOptional: SameSite policy. "none" requires secure=true. Omit for the browser default. (one of: strict, lax, none, default)
securebooleannoOptional: mark the cookie Secure (HTTPS-only). Defaults to false.
sessionstringnoOptional: named session to run this call in (default: current session).
valuestringyesCookie value

Delete the cookie(s) matching a name, optionally scoped by domain. A domain-scoped delete never removes a same-named cookie on another domain.

ParameterTypeRequiredDefaultDescription
domainstringnoOptional: restrict deletion to this domain
namestringyesCookie name to delete
sessionstringnoOptional: named session to run this call in (default: current session).

Clear all cookies, or only those matching a domain filter.

ParameterTypeRequiredDefaultDescription
domainstringnoOptional: only clear cookies whose domain matches
sessionstringnoOptional: 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.

ParameterTypeRequiredDefaultDescription
sessionstringnoOptional: 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.

ParameterTypeRequiredDefaultDescription
keystringyesStorage key to read
sessionstringnoOptional: 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.

ParameterTypeRequiredDefaultDescription
keystringyesStorage key to write
sessionstringnoOptional: named session to run this call in (default: current session).
valuestringyesString value to store

browser_localstorage_delete

Delete a localStorage key for the active page origin.

ParameterTypeRequiredDefaultDescription
keystringyesStorage key to remove
sessionstringnoOptional: named session to run this call in (default: current session).

browser_localstorage_clear

Clear all localStorage for the active page origin.

ParameterTypeRequiredDefaultDescription
sessionstringnoOptional: 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.

ParameterTypeRequiredDefaultDescription
sessionstringnoOptional: 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.

ParameterTypeRequiredDefaultDescription
keystringyesStorage key to read
sessionstringnoOptional: 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.

ParameterTypeRequiredDefaultDescription
keystringyesStorage key to write
sessionstringnoOptional: named session to run this call in (default: current session).
valuestringyesString value to store

browser_sessionstorage_delete

Delete a sessionStorage key for the active page origin.

ParameterTypeRequiredDefaultDescription
keystringyesStorage key to remove
sessionstringnoOptional: named session to run this call in (default: current session).

browser_sessionstorage_clear

Clear all sessionStorage for the active page origin.

ParameterTypeRequiredDefaultDescription
sessionstringnoOptional: 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.

ParameterTypeRequiredDefaultDescription
namestringyesSnapshot name: lowercase letters, digits, '_', '-', '.' (no whitespace or path separators)
sessionstringnoOptional: 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.

ParameterTypeRequiredDefaultDescription
namestringyesName of the saved snapshot to load
sessionstringnoOptional: 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.

ParameterTypeRequiredDefaultDescription
namestringyesName of the saved snapshot

browser_storage_delete

Delete a saved storage snapshot. Local registry operation — no browser required.

ParameterTypeRequiredDefaultDescription
namestringyesName 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.

ParameterTypeRequiredDefaultDescription
namestringyesName of the saved snapshot to export
pathstringyesDestination 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.

ParameterTypeRequiredDefaultDescription
namestringyesName to store the imported snapshot under
pathstringyesPath to the canonical storage JSON file to import

browser_download_set_dir

Set the download directory for the browser

ParameterTypeRequiredDefaultDescription
pathstringyesDirectory path for downloads
sessionstringnoOptional: 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

ParameterTypeRequiredDefaultDescription
sessionstringnoOptional: named session to run this call in (default: current session).
timeout_msintegerno30000Timeout in milliseconds (default: 30000)

On this page