Navigate to a specific URL in the browser

Open an isolated Chromium context, answer a bounded HTTP auth challenge, clean Fetch handlers, and retain the isolated authenticated tab until it is closed.

Go back to the previous page in browser history

Go forward to the next page in browser history

Refresh the current page

List browser tabs tracked by the current DrissionPage MCP session.

Switch the active browser tab by id from tab_list.

Close a browser tab by id from tab_list without closing the whole browser.

Resize the browser window to specified dimensions

Take an inline screenshot of the current page

Save a screenshot to a local path under DP_MCP_SCREENSHOT_ROOT

Generate one PDF or MHTML file under DP_MCP_ARTIFACT_ROOT and return checksum, safe relative path, and exact-once receipt evidence.

Return a bounded page outline with text excerpt, headings, links, buttons, inputs, forms, and recommended selectors.

Return a bounded Chromium accessibility tree for the page or a scoped selector/frame/shadow target.

Return a compact current-page fingerprint with URL, title, ready state, element counts, visible text samples, active element, and recent console summary.

Run a bounded JavaScript function body in the current page and return a JSON-safe result. This can mutate the page.

Move the viewport pointer to exact CSS pixel coordinates without pressing a button, using either one direct move or a bounded natural trajectory.

Perform one failure-safe viewport drag through optional ordered waypoints using direct or bounded natural movement while the button remains pressed. Always releases the button.

Resolve a source element and element, offset, or track-ratio destination immediately before one failure-safe drag. Supports CSS/XPath in the top document or one same-origin iframe, plus CSS paths through nested open Shadow DOM hosts; use coordinate drag for visual-only targets.

Move the viewport pointer to exact CSS pixel coordinates using a direct or bounded natural trajectory, optionally wait for an explicit delay, then press and release one mouse button.

Close the current page/browser

Get the current URL of the page

Replace extra HTTP request headers for the current tab. Successful results echo header values for MCP callbacks; an empty object clears them.

Override the current tab user agent and optional platform, returning the previous user agent so callers can restore it.

Clear HTTP cache without clearing cookies or Web Storage.

Query one browser permission state for the current document origin without opening an operating-system prompt.

Set one permission to granted, denied, or prompt for one bounded origin in the current Chromium context.

Reset all Chromium permission overrides in the current browser context.

Observe a pending native alert, confirm, or prompt and return its bounded message without handling it.

Accept or dismiss one pending alert, confirm, or prompt through a capability-probed native DrissionPage dialog path.

Perform one selector, coordinate, or keyboard trigger, await one completed download, and return an integrity-checked safe artifact receipt.

Read bounded browser console messages from the current tab. Supports level filtering, cursor pagination, and a maximum result limit.

Find an element on the page using CSS selector or XPath. Bare selectors are treated as CSS; use text:... for text matching.

Find multiple matching elements with bounded text/attribute summaries and recommended selectors for repeated lists, cards, and tables.

Click an element found by CSS selector or XPath. Bare selectors are treated as CSS; use text:... for text matching.

Type text into an input element

Get text from an element or the whole page

Get an attribute value from an element

Get a live DOM property value from an element, such as an input's current value

Get HTML from an element or the whole page

Return DrissionPage element state and page/viewport geometry for a selector or accessibility target.

Set files on an input[type=file]. Paths must exist under DP_MCP_UPLOAD_ROOT and response data only returns safe file names.

Arm Chromium's file chooser, click one trigger, inject approved files, and always remove interception without opening a native operating-system picker.

Scroll the current page by direction or to a position.

Scroll an element into the viewport before a later action.

Move the mouse over an element.

Send keyboard text/keys to the active page element without echoing the input in the result.

Select an option from a select element by value, text, or index.

Set a checkbox or radio element to checked/unchecked.

List iframe/frame contexts on the current page without changing global state.

Return a bounded page outline from a selected iframe/frame.

Find an element inside a selected iframe/frame without global frame state.

Find one element inside a shadow root exposed by the supported DrissionPage runtime.

Find repeated elements inside a shadow root exposed by the supported DrissionPage runtime.

Read normalized cookies with values redacted by default.

Set a bounded batch of browser cookies. The successful result echoes cookie values by default for MCP callbacks and verification.

Delete one named browser cookie with optional URL/domain/path scope.

Clear all cookies from the active browser context.

Read localStorage or sessionStorage by key or as a bounded map, with values redacted unless explicitly requested.

Set one localStorage/sessionStorage item. The value is not echoed.

Clear one key or all items from localStorage/sessionStorage.

Wait for an element to appear on the page. Bare selectors are treated as CSS; use text:... for text matching.

Wait for the current URL to contain a substring

Wait for a specific amount of time

Wait for observable page state: element present/visible/hidden/detached/clickable/stable, text contains/matches, or URL contains/matches.

Start beta HTTP/XHR/Fetch network observation for the active tab. This observes packets only; it does not intercept or modify requests.

Wait for observed HTTP/XHR/Fetch packets and return bounded metadata. Bodies and headers are opt-in and sensitive headers are redacted.

Stop beta network observation for the active tab and optionally clear it.

Replace URL patterns blocked for the current tab. Successful results echo patterns; an empty list clears them.