Ui.Vision MCP Server: Setup for Claude Code, Cursor and Other Apps

• Checks that the Ui.Vision extension is connected

  Tells you whether the Ui.Vision side panel is open and linked to the bridge, and lists each connected browser. Call it first when other tools fail.

  Try: “Is Ui.Vision connected to my browser?”

  Read · bridge_status

• Shows what the macro runner is doing right now

  Reports whether a macro is running, which one is open, and the latest log lines. It answers even while a long run is in progress.

  Try: “What is the macro doing right now?”

  Read · run_status

• Picks which connected browser gets the commands

  When several browsers are linked, this chooses which one the other tools act on, by label such as chrome#2 or by browser family.

  Try: “Switch Ui.Vision to my Firefox browser.”

  Write · select_browser

• Opens the Ui.Vision panel in a closed browser

  Wakes a browser whose Ui.Vision panel is closed and opens it in a tab, even when the browser has no windows. It is the only way the panel opens without a click from you.

  Try: “Open the Ui.Vision panel in Chrome.”

  Runs code · open_panel

• Lists the saved macros

  Returns the name and id of every macro stored in Ui.Vision.

  Try: “List my Ui.Vision macros.”

  Read · list_macros

• Opens a saved macro in the editor

  Loads the named macro into the editor and returns its content. Unsaved changes in the editor can be lost.

  Try: “Open the macro "invoice download".”

  Read · open_macro

• Returns the guide for writing macros

  Returns the reference for the uiv.* JavaScript commands, the classic command table and locator rules. The assistant reads it once before writing its first macro.

  Try: “Read the Ui.Vision macro guide before you start.”

  Read · get_authoring_guide

• Shows the macro open in the editor

  Returns the macro that is currently open, as Ui.Vision JSON.

  Try: “Show me the macro that is open now.”

  Read · get_macro

• Sends a message to the built-in Ui.Vision AI chat

  Types a message into Ui.Vision's own AI chat, which then runs it with its own tools. It returns at once and the chat can take minutes.

  Try: “Ask the Ui.Vision chat to open example.com and read the heading.”

  Runs code · send_chat

• Reads the built-in AI chat

  Returns the text of the Ui.Vision chat and whether a run is still going. Use it after send_chat.

  Try: “Is the Ui.Vision chat done yet?”

  Read · get_chat

• Reloads the Ui.Vision extension

  Reloads the extension from disk, like the reload button on the browser extensions page. The panel reconnects by itself.

  Try: “Reload the Ui.Vision extension.”

  Runs code · reload_extension

• Runs the desktop automation self-tests

  Runs all the desktop automation checks in Settings: native host, image search, screenshots, mouse input and file access. It moves the real mouse while it runs and returns one report.

  Try: “Run the Ui.Vision self-test.”

  Runs code · run_selftest

• Shows the AI provider settings

  Reports the active AI provider and model, which providers have keys stored (yes or no only), and the OCR engine. Keys are never shown.

  Try: “Which AI provider is Ui.Vision using?”

  Read · get_ai_settings

• Switches the AI provider settings

  Changes the AI provider, model, vision scope or OCR engine among those you already set up. It cannot set or read API keys.

  Try: “Switch Ui.Vision to the anthropic provider.”

  Write · set_ai_settings

• Edits the macro in the editor

  Replaces the open macro with the JSON you give it. A macro of yours is never overwritten: the first change is saved as a copy in the "AI Generated" folder.

  Try: “Fix the login step in this macro.”

  Write · set_macro

• Creates a new macro

  Saves a new macro under a unique name in the "AI Generated" folder and opens it in the editor.

  Try: “Create a macro that logs into example.com and downloads the report.”

  Write · create_macro

• Deletes a macro from the "AI Generated" folder

  Deletes one macro, and only from the "AI Generated" folder. Anything outside that folder is refused.

  Try: “Delete the scratch macros you made.”

  Delete · delete_macro

• Runs a macro or a script in your browser

  Runs a saved macro, or JavaScript you give it, in the browser tab and waits until it ends. It returns the log and a marked picture of the page. It clicks and types for real, so what it does can have effects.

  Try: “Run the "invoice download" macro.”

  Runs code · run_macro

• Reads the structure of the current page

  Returns the page as a list of buttons, fields and links, each with a reference the macro can click or fill. Can open a URL first.

  Try: “Show me the form fields on this page.”

  Network · browser_snapshot

• Older name for browser_snapshot

  An alias of browser_snapshot kept for older prompts. It behaves the same.

  Try: “Get the page structure.”

  Network · get_page

• Clicks a point on the last screenshot

  Clicks the point you name on the most recent screenshot, in the browser tab or on the desktop. It is meant for exploring, not for saved macros.

  Try: “Click the Save button in the screenshot.”

  Runs code · click_at

• Clicks a point and types text

  Clicks a point on the latest screenshot and types text there. Key names such as Enter and Tab are honoured.

  Try: “Click the search box and type "invoices".”

  Runs code · type_at

• Takes a screenshot of the browser or the screen

  Captures the visible tab, or the whole screen when you ask for the desktop. It can zoom into a region or number the clickable elements.

  Try: “Take a screenshot of the page.”

  Read · screenshot

• Saves a crop as a reference image

  Crops a box from the latest screenshot and stores it as an image the macro can find on screen later. Saving the same name overwrites the old image.

  Try: “Save the logo as an image called logo.”

  Write · save_element_image

• Saves an anchor and click target as an image

  Saves an anchor box plus a click offset from the latest screenshot, so a macro can click next to something it recognises.

  Try: “Save the label as an anchor and click the field beside it.”

  Write · save_relative_image

Watch out for

• It runs scripts in your logged-in browser

  run_macro runs macros and inline JavaScript with real clicks and typing in your browser, where you may be signed in to email or banking. Use a separate browser profile and press STOP if it goes wrong. github.com

• It can control your whole screen

  With the desktop add-on, click_at, type_at and run_selftest move the real mouse and type on your desktop. Do not leave other apps open with private data while it runs. github.com

• It deletes macros in one folder

  delete_macro removes only macros inside "AI Generated". Your own macros are refused, and set_macro saves a copy instead of overwriting them. github.com

• It can open your browser

  open_panel wakes a closed browser, and the README says the assistant may start the browser from its shell. This only happens when the assistant asks for it. github.com

Security advisories