Skip to main content
Kernel logo
  • Category: developer tools
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 35
  • Triggers: 0
  • Slug: KERNEL
  • Version: 00000000_00

Tools

Slug: KERNEL_BATCH_COMPUTER_ACTIONSExecute 1-100 computer actions sequentially in a Kernel browser, stopping on the first error. Actions can click, type, press keys, and submit forms or cause other irreversible external effects.

Input Parameters

array
required
Ordered computer actions (1-100); execution stops on the first error.
string
required
Browser session ID or name to control.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: KERNEL_BROWSER_CURLSend a read-only GET, HEAD, or OPTIONS request through a Kernel browser’s network stack, inheriting its cookies, TLS fingerprint, proxy settings, and default headers. For POST, PUT, PATCH, or DELETE, use Browser HTTP Request.

Input Parameters

string
required
Target HTTP or HTTPS URL.
string ("GET" | "HEAD" | "OPTIONS")
Read-only HTTP method for the target URL.
object
Custom request headers merged with the browser’s defaults.
string
required
Browser session ID or name.
integer
Target request timeout in milliseconds (1000-60000).
string ("utf8" | "base64")
Return the response body as UTF-8 text or base64 for binary content.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: KERNEL_BROWSER_HTTP_REQUESTSend a state-changing POST, PUT, PATCH, or DELETE request through a Kernel browser’s network stack, inheriting its cookies, TLS fingerprint, proxy settings, and default headers. The target may change external systems irreversibly. For GET, HEAD, or OPTIONS, use Browser Curl.

Input Parameters

string
required
Target HTTP or HTTPS URL.
string
Request body for POST, PUT, or PATCH requests.
string ("POST" | "PUT" | "PATCH" | "DELETE")
required
State-changing HTTP method for the target URL.
object
Custom request headers merged with the browser’s defaults.
string
required
Browser session ID or name.
integer
Target request timeout in milliseconds (1000-60000).
string ("utf8" | "base64")
Return the response body as UTF-8 text or base64 for binary content.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: KERNEL_CLICKClick at browser viewport coordinates with an optional mouse button, click phase, modifiers, and repetition count. A click can submit forms, place orders, or cause other irreversible external effects.

Input Parameters

integer
required
Horizontal viewport coordinate.
integer
required
Vertical viewport coordinate.
string ("left" | "right" | "middle" | "back" | "forward")
Mouse button to use; omit for Kernel’s default.
array
Modifier keys to hold during the click.
string ("down" | "up" | "click")
Mouse action phase; use click for a complete press and release.
string
required
Browser session ID or name to control.
integer
Number of click repetitions.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: KERNEL_CREATE_BROWSERCreate a Kernel browser session; defaults to a headless browser with a 60-second inactivity timeout.

Input Parameters

boolean
Enable GPU acceleration; requires headless=false, us-east, and an eligible plan.
string
Unique active-session name containing only letters, numbers, dots, underscores, and hyphens.
object
User-defined browser tags (maximum 50 key-value pairs).
object
Proxy selected by exactly one of mode, id, or name.
string ("1GiB" | "2GiB" | "4GiB" | "8GiB" | "16GiB")
Non-GPU memory: headless supports 1/2/4GiB and headful supports 8/16GiB.
string ("us-east" | "us-west" | "eu-west" | "ap-southeast")
Fixed browser region; omission uses us-east and explicit selection can require a higher plan.
array
Project-scoped vault references linked immutably at creation.
object
Network allowlist, private-host routing, and per-destination proxy routes.
object
Existing profile selected by exactly one of id or name, optionally saving changes.
boolean
Enable stealth mode and Kernel’s CAPTCHA solver; without a proxy this selects Kernel’s default stealth proxy.
boolean
Run without a GUI. Defaults to true in this tool; headless sessions do not provide Live View or replays.
object
Session-only timezone and locale overrides.
object
Initial browser viewport dimensions and optional refresh rate.
string
URL to open best-effort when the session starts; navigation failure does not fail creation.
object
Telemetry capture, category, export, and storage settings.
array
Extensions to load, each selected by exactly one of id or name.
boolean
Hide the address bar and tabs in headful Live View kiosk mode.
string ("2GiB" | "4GiB")
GPU video memory; valid only when gpu is true.
object
Chrome enterprise policy overrides, excluding Kernel-managed extension, proxy, CDP, and automation policies.
integer
Inactivity timeout in seconds (10-259200). Defaults to 60; Kernel checks inactivity about every five seconds.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: KERNEL_CREATE_PROFILECreate an empty persistent browser profile, optionally with a unique name, for reuse by later browser sessions.

Input Parameters

string
Optional profile name, unique within the logical project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: KERNEL_DELETE_BROWSERPermanently end and delete a Kernel browser session by ID or name.

Input Parameters

string
required
Browser session ID or active-session name to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: KERNEL_DELETE_PLAYWRIGHT_EXECUTORStop and permanently delete a named, non-default Playwright executor from a Kernel browser. Its running call fails, its name can be reused, and close_tab controls whether its tab is also closed. To restart the reserved default executor, use Restart Default Playwright Executor.

Input Parameters

boolean
Whether to close the named executor’s tab when deleting it.
string
required
Browser session ID or name whose Playwright executor should be deleted.
string
required
Named Playwright executor to stop and delete. The reserved name ‘default’ is rejected.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: KERNEL_DELETE_PROFILEPermanently delete a browser profile by ID or name.

Input Parameters

string
required
Profile ID or exact profile name to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: KERNEL_DOWNLOAD_PROFILEDownload a profile’s stored browser state. Current profiles return the requested tar.zst or uncompressed tar format; legacy profiles may return JSON regardless of the requested format. The profile must have captured state from a browser session.

Input Parameters

string ("tar.zst" | "tar")
Archive format requested for a current profile; Kernel defaults to tar.zst when omitted. Legacy profiles may return JSON regardless of this value.
string
required
Profile ID or name whose stored browser state archive will be downloaded.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: KERNEL_DRAG_MOUSEDrag a mouse button through an ordered path of browser viewport coordinates, with optional timing, linear-step, and modifier controls. A drag can move items, submit controls, or cause other irreversible external effects.

Input Parameters

array
required
Ordered path of at least two [x, y] viewport coordinate pairs.
integer
Delay in milliseconds between pressing the button and starting movement.
string ("left" | "middle" | "right")
Mouse button to hold while dragging; omit for Kernel’s default.
boolean
Use human-like Bezier curves; when true, linear step settings are ignored.
array
Modifier keys to hold during the drag.
string
required
Browser session ID or name to control.
integer
Total smooth drag duration in milliseconds (50-10000); omit for automatic timing.
integer
Delay in milliseconds between linear drag steps, excluding the initial delay.
integer
Number of linear movement steps per path segment.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: KERNEL_EXECUTE_PLAYWRIGHTExecute arbitrary TypeScript or JavaScript with Playwright access to the browser; the code may navigate, mutate pages, submit forms, or cause irreversible external effects.

Input Parameters

string
required
TypeScript or JavaScript function body with page, context, browser, and webmcp variables; use return to populate result.
string
Persistent executor name; omission uses default. Distinct named executors can run concurrently, with at most eight per browser.
string
required
Browser session ID or name to automate.
integer
Maximum code execution time in seconds (1-300).
string
Stable key that makes retries return the first execution result instead of running the code again.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: KERNEL_GET_BROWSERGet safe operational details for one browser session by ID or name, optionally including a deleted session.

Input Parameters

string
required
Browser session ID or name.
boolean
Allow lookup of a soft-deleted browser session.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: KERNEL_GET_MOUSE_POSITIONGet the current mouse cursor coordinates in a Kernel browser session.

Input Parameters

string
required
Browser session ID or name whose mouse position to read.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: KERNEL_GET_PROFILEGet one browser profile by its ID or exact name.

Input Parameters

string
required
Profile ID or exact profile name.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: KERNEL_GET_REPLAYDownload a completed browser replay as MP4. If the replay is still processing, the action asks the caller to retry later.

Input Parameters

string
required
Replay recording ID returned by List Replays.
string
required
Headful browser session ID or name that owns the replay.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: KERNEL_LIST_BROWSERSList browser sessions, optionally filtered by lifecycle state, search text, tags, or region, one offset page at a time.

Input Parameters

object
Tag key-value pairs that every returned browser must match exactly.
integer
Maximum browser sessions to return in this page (1-100).
string
Search browser name, session ID, profile name or ID, proxy ID, or pool name.
string ("us-east" | "us-west" | "eu-west" | "ap-southeast")
Geographic region to match; omit to include every region.
string ("active" | "deleted" | "all")
Browser lifecycle state to return: active, deleted, or all.
integer
Continuation offset returned by a previous call; omit for the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: KERNEL_LIST_PLAYWRIGHT_EXECUTORSList the default and named Playwright executors for a Kernel browser, including whether each is busy and its owned tab when available.

Input Parameters

string
required
Browser session ID or name whose Playwright executors to list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: KERNEL_LIST_PROFILESList browser profiles, optionally filtered by substring or exact name, one offset page at a time.

Input Parameters

string
Exact profile-name match using Kernel’s case- and accent-insensitive production collation.
integer
Maximum profiles to return in this page (1-100).
string
Case-insensitive substring match against profile name or ID.
integer
Continuation offset returned by a previous call; omit for the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: KERNEL_LIST_REPLAYSList replay recordings for a headful browser session without returning signed viewer URLs.

Input Parameters

string
required
Headful browser session ID or name. Headless sessions do not support replays.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: KERNEL_MOVE_MOUSEMove the cursor to browser viewport coordinates, optionally using a timed human-like path and held modifier keys.

Input Parameters

integer
required
Horizontal viewport coordinate to move the cursor to.
integer
required
Vertical viewport coordinate to move the cursor to.
boolean
Use a human-like Bezier path instead of moving instantly.
array
Modifier keys to hold during the movement.
string
required
Browser session ID or name to control.
integer
Total smooth movement duration in milliseconds (50-5000); omit for automatic timing.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: KERNEL_PRESS_KEYPress an ordered sequence of X11 keys or key chords in a browser, optionally holding modifiers or holding the sequence for a duration. Key presses may submit forms, activate controls, or trigger other irreversible external effects.

Input Parameters

array
required
Ordered X11 key symbols or chords to press. Use names such as Return, Shift, Ctrl, Alt, or F5; chords such as Ctrl+t or Ctrl+Shift+Tab; and X11 punctuation names such as Ctrl+minus or Ctrl+plus. Ctrl+- is also accepted as an alias for Ctrl+minus.
integer
Duration to hold the keys down in milliseconds; zero taps them.
array
Modifier keys to hold during the key press sequence.
string
required
Browser session ID or name to control.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: KERNEL_READ_CLIPBOARDRead the current text from a Kernel browser session’s clipboard.

Input Parameters

string
required
Browser session ID or name whose clipboard to read.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: KERNEL_RENAME_PROFILERename a Kernel browser profile by ID or exact name. Rename profiles only when they are not in use because sessions referencing the old name may fail to save their changes.

Input Parameters

string
required
New profile name, unique within the logical project.
string
required
Profile ID or exact name to rename.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: KERNEL_RESTART_DEFAULT_PLAYWRIGHT_EXECUTORRestart a Kernel browser’s reserved default Playwright executor. Its process is stopped and any running call fails irreversibly; queued and later calls run on the new process. This does not delete a named executor or close a tab.

Input Parameters

string
required
Browser session ID or name whose default Playwright executor should be restarted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: KERNEL_SAVE_BROWSER_PROFILESave a running browser’s current state to exactly one destination profile ID or name, creating a named profile when needed and overwriting an existing destination. This restarts the browser, closes all active connections, reloads pages, and loses in-memory page state; reconnect after completion. It does not attach the profile or enable save_changes.

Input Parameters

string
required
Browser session ID or name whose current state will be saved.
object
required
Required destination containing exactly one profile ID or profile name.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: KERNEL_SCROLLScroll horizontally or vertically at browser viewport coordinates, optionally while holding modifier keys.

Input Parameters

integer
required
Horizontal viewport coordinate where scrolling occurs.
integer
required
Vertical viewport coordinate where scrolling occurs.
integer
Horizontal scroll amount in wheel units; positive scrolls right and negative scrolls left.
integer
Vertical scroll amount in wheel units; positive scrolls down and negative scrolls up.
array
Modifier keys to hold while scrolling.
string
required
Browser session ID or name to control.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: KERNEL_SET_CURSOR_VISIBILITYHide or show the cursor in a Kernel browser session.

Input Parameters

boolean
required
Whether to hide the cursor; set false to make it visible.
string
required
Browser session ID or name whose cursor visibility to set.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: KERNEL_START_REPLAYStart recording a headful Kernel browser session and return its replay identifier and recording metadata without exposing its signed viewer URL.

Input Parameters

integer
Recording framerate in frames per second (1-60); values above 20 require GPU to be enabled on the browser session.
string
required
Headful browser session ID or name to record. Headless sessions do not support replays.
boolean
Record audio with the video; defaults to false for video-only recording.
integer
Maximum recording duration in seconds.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: KERNEL_STOP_REPLAYStop an active replay recording for a Kernel browser identified by ID or name.

Input Parameters

string
required
Replay recording ID to stop.
string
required
Browser session ID or name that owns the replay recording.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: KERNEL_TAKE_SCREENSHOTCapture the full browser viewport or a rectangular region as a PNG download.

Input Parameters

object
Optional crop rectangle; omit to capture the full browser viewport.
string
required
Browser session ID or name to capture.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: KERNEL_TYPE_TEXTType text into the currently focused browser element with an optional per-keystroke delay.

Input Parameters

string
required
Text to type into the currently focused element.
integer
Delay in milliseconds between keystrokes.
string
required
Browser session ID or name to control.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: KERNEL_UPDATE_BROWSERUpdate mutable settings on an existing Kernel browser session.

Input Parameters

string
New unique session name; use an empty string or null to clear it.
object
Full replacement tag map; use an empty object to clear all tags.
object
Replacement proxy egress configuration.
object
Changes to the running session’s egress allowlist.
object
Profile to load when the session does not already have one attached.
object
Session-only timezone and locale overrides.
object
Replacement browser viewport configuration.
string
URL to open best-effort after the update; an empty string leaves the current page unchanged.
object
Telemetry capture configuration updates.
string
required
Browser session ID or name to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: KERNEL_UPLOAD_BROWSER_EXTENSIONSUpload and activate one or more unpacked Chromium extension ZIP archives in an existing running browser. This ad-hoc operation does not add extensions to Kernel’s reusable extension catalog. Chromium may restart, disrupting active browser connections.

Input Parameters

array
required
Extensions to upload and activate in the running browser.
string
required
Running browser session ID or name to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: KERNEL_WRITE_CLIPBOARDWrite text to the system clipboard of a Kernel browser session.

Input Parameters

string
required
Text to write to the browser system clipboard.
string
required
Browser session ID or name to control.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not