cdp_send
Send a raw Chrome DevTools Protocol command to an active browser tab for debugging, enabling direct control of page behavior and inspection of runtime internals through automated Chrome sessions.
Instructions
Send a raw Chrome DevTools Protocol command to the active tab (or tab_id) via the browser's cdp tab capability, for developer/debugging use. Navigate the tab to its intended http(s) page first; raw CDP is scoped to the tab's current web origin and attaching shows Chrome's 'started debugging' bar. Prefer the higher-level tools for ordinary automation. To observe events for an action, capture a cursor with cdp_events, send the command, then read from that cursor. Requires full CDP access to be enabled (browser/config.toml full_cdp_access_enabled=true).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"method": "<method>"
},
"name": "cdp_send"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| method | Yes | CDP method, e.g. 'Page.navigate' or 'Runtime.evaluate'. | |
| params | No | CDP command params object. | |
| tab_id | No | Optional tab id. | |
| target_id | No | Attached child targetId (alternative to session_id). | |
| session_id | No | Attached child target sessionId (omit to target the tab itself). | |
| timeout_ms | No | Maximum command wait in milliseconds. |