chrome-mcp
Tools

Session and artifacts

Backend status, sign-in wall detection, and where downloads, results and screenshots are stored.

Generated from @mehmoodqureshi/chrome-mcp 0.9.11. 6 tools.

chrome_status

Report backend/session status: paired browser profiles and how each was named, and flags for switched-off capabilities.

No arguments.

{
  "tool": "chrome_status",
  "args": {}
}

auth_check

Is the tab sitting on a sign-in wall? Reads the page (URL, title, password fields, sign-in controls) and returns { authRequired, confidence, signals }. Use it after a navigate, or whenever a step fails unexpectedly, to tell "the session expired" apart from "the agent got lost". Pass failOnAuthWall:true to get an [AUTH_REQUIRED] error instead of a verdict, so a harness can bucket the run as an auth failure.

ArgumentTypeRequiredDescription
failOnAuthWallbooleannoError with [AUTH_REQUIRED] if this lands on a sign-in wall (expired session)
frameIdnumbernoFrame id from frames_list
allFramesbooleannoAct on the first match in ANY frame (the element may be in an iframe)
tabIdstringnoTab id (default: active tab)
{
  "tool": "auth_check",
  "args": {}
}

profile_use

Switch the active browser profile (identity). Subsequent downloads, results, screenshots, and the action log are stored under profiles//. Resets the active task to "default" unless you then call task_new.

ArgumentTypeRequiredDescription
namestringyesProfile name (becomes a folder; sanitized to a safe path segment).
{
  "tool": "profile_use",
  "args": {
    "name": "<name>"
  }
}

task_new

Start a new task (run) under the active profile. Creates profiles//tasks// with downloads/, results/, screenshots/ and makes it the active task so all captured artifacts land there.

ArgumentTypeRequiredDescription
namestringyesTask name (becomes a folder; sanitized to a safe path segment).
{
  "tool": "task_new",
  "args": {
    "name": "<name>"
  }
}

tasks_list

List every task across all profiles under the data dir, with sizes and download counts.

No arguments.

{
  "tool": "tasks_list",
  "args": {}
}

task_status

Report the active profile/task and the folder paths where this run's artifacts are stored.

No arguments.

{
  "tool": "task_status",
  "args": {}
}

On this page