Documentation

Scout docs

Connect an agent, make your first call, and find the reference you need.

DocsTool reference

Tool reference

Find a tool, inspect its parameters, and check what it returns.

https://mcp.scout.i.ng/browser

Extension

Sideload an extension, open its pages, drive the background worker, manage storage, and reload.

extension-launch

Launch Chromium with an unpacked extension via --load-extension. Returns sessionRef and extensionId.

Parameter	Type	Description
`extensionPath` Required	`string`	Absolute path to the unpacked extension directory. Must contain a manifest.json.
`userDataDir` Required	`string`	Persistent browser profile directory used to launch the extension. Use a dedicated automation profile, not your everyday browser profile.
`headless` Optional	`boolean`	Whether to run the browser headlessly. Defaults to false because extension service workers and popups require a non-old-headless environment. Default: false
`url` Optional	`string`	URL to navigate to after launch. Defaults to about:blank.
`waitUntil` Optional	`'commit' \| 'domcontentloaded' \| 'load' \| 'networkidle'`	Navigation completion condition (only used when url is provided): commit, domcontentloaded, load, networkidle Default: load
`timeout` Optional	`number`	Maximum time in milliseconds to wait for the browser to launch and the extension to initialize its background context. Default: 30000
`windowSize` Optional	`{ height: number, width: number } \| null`	Initial browser window dimensions ({ height, width }). Null uses Chromium's default sizing.
`chromiumFlags` Optional	`string[]`	Additional Chromium launch flags.

Returns: sessionRef and extensionId

extension-open

Open an extension HTML page (popup, sidepanel, options) in a new tab. Returns a tabRef for browser-* tools.

Parameter	Type	Description
`extensionId` Required	`string`	The 32-character Chrome extension ID returned by extension-launch.
`page` Required	`string`	Extension HTML file to open relative to the extension root. Common values: popup.html, sidepanel.html, options.html.
`waitUntil` Optional	`'commit' \| 'domcontentloaded' \| 'load' \| 'networkidle'`	Navigation completion condition. Default: load
`timeout` Optional	`number`	Maximum time in milliseconds to wait for the extension page to load. Default: 15000

Returns: tabRef and accessibility snapshot of the extension UI

extension-background

Evaluate JavaScript in the extension background service worker. Full chrome.* API access with promises auto-awaited.

Parameter	Type	Description
`extensionId` Required	`string`	The 32-character Chrome extension ID returned by extension-launch.
`expression` Required	`string`	JavaScript expression to evaluate in the extension background context.

Returns: Serialized evaluation result

extension-reload

Reload the extension via chrome.runtime.reload(). Waits for the service worker to re-register by default.

Parameter	Type	Description
`extensionId` Required	`string`	The 32-character Chrome extension ID returned by extension-launch.
`waitForServiceWorker` Optional	`boolean`	After reloading, wait for the extension's service worker or background page to re-register before returning. Default: true
`waitTimeout` Optional	`number`	Maximum time in milliseconds to wait for the background context to re-register after reload. Default: 10000

Returns: Confirmation

extension-storage

Read or write chrome.storage areas (local, sync, session, managed). Supports get, set, remove, and clear.

Parameter	Type	Description
`extensionId` Required	`string`	The 32-character Chrome extension ID returned by extension-launch.
`action` Required	`'get' \| 'set' \| 'remove' \| 'clear'`	Storage action: get, set, remove, or clear.
`area` Optional	`'local' \| 'sync' \| 'session' \| 'managed'`	Chrome storage area to target: local, sync, session, or managed (read-only enterprise policy storage). Default: local
`keys` Optional	`string[]`	Storage keys to read (get) or delete (remove). Omit to read the full area.
`data` Optional	`Record<string, unknown>`	Key-value pairs to write. Values must be JSON-serialisable (set action).

Returns: Storage values or confirmation