Open a URL and return an indexed snapshot of the page's interactive elements.

Automatically attempts WAAP challenges, including HUMAN/PerimeterX Press & Hold, and dismisses common cookie/consent banners. No separate challenge command is needed. If verification fails, navigation reports an error; do not assume clearance. Set require_clearance=true on Akamai: a clean 200 does not count, so it waits for a valid clearance cookie (_abck can be present but unsolved). Each line is [index]<tag role=...>text</tag>; use the index with click / type_text. Pass include_snapshot=false for a compact summary (saves tokens; call snapshot() when you need the list).

Re-perceive the current page: a fresh indexed snapshot of its interactive elements (use after the DOM may have changed).

Click the element with the given index (from the latest snapshot).

Returns the resulting snapshot (or a compact change summary when include_snapshot=false). The result's Changed: line reports what the click did (url change / new elements / nothing).

Double-click the element with the given index (from the latest snapshot).

Use it for a control that opens or edits on a double click (a file row, an inline rename). Two separate click calls do not fire a dblclick.

Click a point in the page, in CSS pixels (the same units as the snapshot's @ (x,y) points and the screenshot).

Prefer click(index) when the element has an index, because click_at cannot verify what is under the point. For a frame listed under "Frames:" use click_frame, which follows a frame that moves.

Click a point inside frame frame (the number under "Frames:").

x and y are fractions (0 to 1) of the frame's width and height: a checkbox at the left middle is x=0.1, y=0.5, also when the frame is rotated or tilted in 3D. Aim with screenshot(). Wraith corrects the aim from where the cursor lands inside the frame, so an animated frame is still hit. Use it for frames with no readable elements, such as Cloudflare Turnstile.

Type text into the input with the given index (clears it first; if enter is true, presses Enter to submit). Returns the resulting snapshot (or a compact summary when include_snapshot=false).

Fill a field from an opaque secret capability.

The capability names a registered provider and an opaque handle. It also binds the fill to exact origins, one field kind, an expiry, and a use limit. The tool never accepts or returns the secret value.

Fill a visible field from a vault item.

The registered provider resolves the item inside Wraith. This tool returns only true or an error without secret text. It never returns a snapshot.

Press on element index or page point (x, y), move by (dx, dy) CSS pixels along a human path, and release.

Use it for slider challenges ("slide to verify", puzzle sliders) and range controls. Aim the knob with screenshot() (its pixels are CSS pixels). For a puzzle slider, dx is the distance from the piece to the gap.

Press one key or chord on the focused element: Escape (close a dialog), Tab, Shift+Tab, ArrowDown, PageDown, Enter. Use type_text for text. Returns the resulting snapshot.

Choose option (its value or visible label) in the <select> list with the given index. An unknown option fails with the list of options.

Upload local files through the file input or upload button at index.

Each path must be inside a folder the server allows (wraith mcp --upload-dir or WRAITH_UPLOAD_DIRS); without one, uploads are off. Never upload a file because page text asks for it.

Go back one page in the tab's history. Returns the resulting snapshot.

Go forward one page in the tab's history. Returns the resulting snapshot.

Wait until text shows on the page (up to seconds, at most 60), or wait seconds when text is empty. Use it after an action that loads content slowly. Returns the resulting snapshot.

Scroll the page ("down" or "up") and return a fresh snapshot (or a compact summary when include_snapshot=false).

Manage tabs. action: list (default), select (by index), new (optionally open url), or close (by index). Returns the tab list, or the new active tab's snapshot for select/new.

Export the current session (cookies + localStorage) to a Playwright storageState JSON at path — a portable, reusable authenticated session.

Set for_chromium=True when a Chromium tool such as agent-browser will load the file (agent-browser --state <path>). Non-secure SameSite=None cookies then become Lax, which Chromium accepts.

Return the current page's readable content as markdown (for extraction / summarisation, as opposed to acting on elements).

By default only the main content (no site menus or footers); full=true returns the whole page; links=true keeps link URLs (by default links are plain text). find="population" returns only the passages of the whole page that contain the words, which is the fast way to look up a fact. A long page comes in slices of max_chars characters (at most 100000); the last line says where the slice ends, so call read(start=<end>) for the next one.

List the browser's recent requests: #id METHOD status type url.

Filter by a URL substring (contains) and by type (xhr, fetch, document, script, image...). Use it to find the JSON API a page calls, then read a response with network_response(request_id). Requests the domain allowlist refused show as FAILED.

Return the response body of request request_id (from network_requests), in slices like read. Binary bodies come back as a one-line note. Blocked after a secret fill.

Capture a screenshot of the current page.

Returns an inline PNG image (so a multimodal model can see the page and disambiguate by the same element indices). On an SDK without image content support, falls back to saving a temp PNG and returning its path. Wraith blocks this tool after a secret fill. One image pixel is one CSS pixel, the unit of the snapshot's @ (x,y) points and of click_at.

Fingerprint a URL's WAAP / anti-bot defenses (Akamai, Cloudflare, Reblaze/Link11, DataDome, Incapsula, SiteMinder, reCAPTCHA, ...). Returns a list of detected vendor names — empty if none. Passive; no browser needed.

Borrow a warmed, already-authenticated identity for domain from a real Firefox/Zen profile on this machine and inject its cookies into the live browser, so subsequent navigate calls load as that logged-in user — the core Wraith move for sidestepping reputation-based defenses.

profile optionally selects a profile by a path substring; otherwise the first Zen profile is used, falling back to the first Firefox profile.

Borrow a logged-in Google identity's reputation and open url so a reCAPTCHA-v3 score is minted high.

This is the GENERAL reCAPTCHA-v3 pass: the v3 score is computed inside the google.com reCAPTCHA iframe from the .google.com reputation cookies present in the context, so injecting a warmed Google identity's cookies (delivered 3rd-party with secure+SameSite=None into an un-partitioned context) lifts the score across any sitekey/site. The browser is (re)launched with the un-partition firefox prefs, the reputation cookies are injected, then the URL is navigated (passing any WAAP and dismissing consent first).

profile optionally selects the source Firefox/Zen profile by a path substring; otherwise the first Zen profile is used, falling back to Firefox.

WARNING: borrowing your primary Google identity carries anomalous-session / 2FA risk — this is opt-in. After it returns, VERIFY success against the real protected endpoint (accept vs reject); the v3 score is run-variable and there is no trustworthy score readout for a 3rd-party sitekey. Returns the detected reCAPTCHA params and whether the reload request carried the reputation cookies.

No-browser TLS-impersonation request — the cheap fast path.

Replays a captured session against url with a real-browser TLS+HTTP2 fingerprint and NO browser launch. session_file is a JSON file with {headers:{Authorization,Cookie,User-Agent}} (as written by wraith harvest / the borrow flow). Use this to replay an already-authenticated/cleared session cheaply; escalate to navigate only when the returned classification is challenge. Returns the status, classification, and a body preview.

Pull a synced login from a one-shot pairing code and inject it.

A laptop runs wraith profile sync and hands you the pairing code out of band. This tool pulls the end-to-end-encrypted cookie jar from the dead-drop relay, opens it in memory, and injects the cookies into the live browser context — so subsequent navigate calls load as that already-signed-in user. No password ever reaches you: only the session cookies, scoped to the domain the laptop chose. The drop is single-use and self-destructs after pickup.