chrome-mcp
Tools

Navigation

Move a tab between pages and wait for the page to settle.

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

Navigate a tab to a URL, REPLACING its current page. Acts on the active tab unless tabId is given — to open a site without losing the current page, use tab_new instead.

ArgumentTypeRequiredDescription
urlstringyes
tabIdstringnoTab id (default: active tab)
waitUntil"load" | "domcontentloaded" | "networkidle"noWhen to consider navigation done
failOnAuthWallbooleannoError with [AUTH_REQUIRED] if this lands on a sign-in wall (expired session)
{
  "tool": "navigate",
  "args": {
    "url": "<url>"
  }
}

back

Go back in history.

ArgumentTypeRequiredDescription
tabIdstringnoTab id (default: active tab)
failOnAuthWallbooleannoError with [AUTH_REQUIRED] if this lands on a sign-in wall (expired session)
{
  "tool": "back",
  "args": {}
}

forward

Go forward in history.

ArgumentTypeRequiredDescription
tabIdstringnoTab id (default: active tab)
failOnAuthWallbooleannoError with [AUTH_REQUIRED] if this lands on a sign-in wall (expired session)
{
  "tool": "forward",
  "args": {}
}

reload

Reload the active (or given) tab.

ArgumentTypeRequiredDescription
tabIdstringnoTab id (default: active tab)
waitUntil"load" | "domcontentloaded" | "networkidle"noWhen to consider navigation done
failOnAuthWallbooleannoError with [AUTH_REQUIRED] if this lands on a sign-in wall (expired session)
{
  "tool": "reload",
  "args": {
    "waitUntil": "load"
  }
}

wait_for

Wait for a selector or text to appear/disappear.

ArgumentTypeRequiredDescription
selectorstringno
textContainsstringno
gonebooleanno
timeoutMsnumberno
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)
failOnAuthWallbooleannoError with [AUTH_REQUIRED] if this lands on a sign-in wall (expired session)
{
  "tool": "wait_for",
  "args": {
    "selector": "<selector>"
  }
}

On this page