jev-ultrafast-mcp

Execute one or more ops in order, then return a delta observation. Batch ops into a single call — each call is a round trip. op fields click ref (ref may be "e12", or "e12" of a combobox to open it) type ref, text, [clear=true], [submit=false] select ref, value (option value or label) toggle ref, [state] (checkbox/radio/switch; no state = flip) hover ref upload ref, path | paths[] keys key ("Enter", "Meta+A", "ArrowDown") | keys[] scroll [dir=down|up|left|right], [amount=600], [ref] nav url back | forward | reload wait [ms=500] wait_for_ref ref, [timeout_ms=8000] wait_for_text text, [timeout_ms=8000] wait_for_load [timeout_ms=20000] screenshot [path], [full=false], [format=jpeg] tab action=list|new|switch|close, [index], [url] eval js (only when JEVMCP_ALLOW_JS=1) Actions matching the confirmation rules (pay, delete account, …) return needs_confirmation; re-send that op with "confirm": true to proceed.

Verify the current page against deterministic checks. Returns pass/fail. checks {"type": "url_matches", "pattern": "*/checkout*"} {"type": "url_contains", "text": "/orders/"} {"type": "title_matches", "pattern": "*Order*"} {"type": "text_contains", "text": "Thanks", "regex": false} {"type": "text_absent", "text": "Error"} {"type": "element_exists", "role": "button", "name": "Continue"} {"type": "element_gone", "ref": "e12"} {"type": "value_equals", "ref": "e7", "value": "Zurich"} {"type": "checked", "ref": "e9", "state": true} {"type": "count_at_least", "role": "link", "min": 3} {"type": "js", "expr": "document.title.length > 3"}

Close a session's tab. Set shutdown_browser=True to stop the browser too. Only a browser this server launched is stopped. In attach mode the browser is yours: shutdown detaches and leaves it, and every other window, running.

Report environment: browser binary, connection, keys, and policy envelope. Call this when anything behaves unexpectedly — it separates "no browser" from "blocked by policy" from "no key".

Run a whole goal inside the server (turbo mode). Needs a decision-model key. Each step costs one request (operation + every target head in a single speculative fan-out). Use this when you want the browser driven end to end without spending a host turn per click. Without a key, use browser_observe + browser_act instead. The key is TYPESAFE_API_KEY, or OPENROUTER_API_KEY when TYPESAFE_BASE_URL points at https://openrouter.ai/api/alpha/decisions -- same model, same contract, no TypeSafe account needed. `verify` runs browser_assert-style checks on the final page, so the result is a fact rather than a model's claim of success.

Record, replay, list, or delete a macro — a discovered path with no model calls. action="record_start" begin capturing ops (needs the session to be driving the task) action="record_stop" finish and save under `name` action="run" replay `name`; `params` fills {{placeholders}} in text/url action="list" | "inspect" | "delete" Replay re-resolves each step by role + name against a fresh observation and refuses to act when the best match is weak or ambiguous.

Re-read the page: new element table, or a delta if little changed. `mode`: "auto" (delta when possible), "full" (whole table, e.g. after a big change), "delta" (force). `include_json=True` appends a machine-readable copy of the element table when you want to plan over it programmatically.

Open a URL in a new owned tab and return the element table. Use `hint` to restate the goal in one line; it is echoed back so the next step has the goal in context without re-reading this call.

List open sessions (independent owned tabs).

List, open, switch to, or close tabs. Tabs opened by the page show up in observations on their own. To act on one, prefer `target_id` (the `#handle` printed by action="list"): indexes are positional and get renumbered whenever the tab list changes, so an index read a call ago can address a different tab. `index` is a convenience when listing and acting in the same breath; omit both to mean "the current tab".