Connection check
local install
empir3-bridge
Local-first MCP bridge — orchestrate the AI CLIs you already pay for (Claude, Codex, Gemini, Grok) and drive a real browser + desktop, all from one agent.
Tools
77
GitHub stars
2
Installs / wk
18
Licence
MIT
Transport
stdio
Last checked
never
Tools & capabilities
77 toolsRead from the published package source — this server runs locally, so there is no endpoint to query. Names are taken from the code, not observed at runtime, and descriptions are often absent.
bridge_action_log
from source
Read recent bridge action receipts for debugging failed or uncertain tool calls. Read recent bridge action receipts for debugging failed or uncertain tool calls.
bridge_overlay_reinject
from source
Remove any legacy page-world overlay and return the trusted localhost control URL. Remove any legacy page-world overlay and return the trusted localhost control URL.
bridge_reliability_smoke
from source
Run monitor, desktop screenshot, and trusted browser coordinate-click checks. Run monitor, desktop screenshot, and trusted browser coordinate-click checks.
bridge_reliability_status
from source
Show bridge health, enabled tools, and recent action receipts. Show bridge health, enabled tools, and recent action receipts.
bridge_revoke_control
from source
Immediately disable browser interact, desktop, eval, and recording tools in bridge settings. Immediately disable browser interact, desktop, eval, and recording tools in bridge settings.
bridge_safety_status
from source
Show whether browser write controls, desktop controls, eval, or recordings are currently enabled. Show whether browser write controls, desktop controls, eval, or recordings are currently enabled.
bridge_scale
from source
bridge_setup_save
from source
Save the current first-use desktop setup checklist result to bridge-settings.json so MCP and empir3 agents can confirm the device was calibrated. Save the current first-use desktop setup checklist result to bridge-settings.json so MCP and empir3 agents can confirm the device was calibrated.
bridge_setup_status
from source
Report the first-use desktop setup checklist: trusted control surface, monitor detection, saved click calibration, recording/playback readiness, and saved completion state. Report the first-use desktop setup checklist: trusted control surface, monitor detection, saved click calibration, recording/playback readiness, and saved completion state.
bridge_tool_advisor
from source
Discoverability helper: given a one-line description of what you\ Discoverability helper: given a one-line description of what you\
browser_chat
from source
browser_click
from source
browser_click_ref
from source
browser_click_xy
from source
browser_emulate_device
from source
Switch the browser tab into a phone viewport (device metrics + touch + mobile user agent). Presets: Switch the browser tab into a phone viewport (device metrics + touch + mobile user agent). Presets:
browser_evaluate
from source
browser_highlight
from source
browser_navigate
from source
browser_play
from source
browser_press
from source
browser_read_chat
from source
browser_recordings
from source
browser_record_start
from source
browser_record_stop
from source
browser_refresh
from source
browser_screenshot
from source
browser_scroll
from source
browser_snapshot
from source
browser_status
from source
browser_swipe
from source
Dispatch a touch swipe/drag gesture from one viewport point to another (CSS px). Scrolls lists, dismisses bottom sheets, drags sliders in phone-emulation mode. Dispatch a touch swipe/drag gesture from one viewport point to another (CSS px). Scrolls lists, dismisses bottom sheets, drags sliders in phone-emulation mode.
browser_tab_focus
from source
Explicitly mark a browser tab as the user focus or hand control of that tab to the agent. This never happens automatically just because the user opens a new tab. Explicitly mark a browser tab as the user focus or hand control of that tab to the agent. This never happens automatically just because the user opens a new tab.
browser_tab_state
from source
List bridge browser tabs and report which tab is agent-controlled versus user-focused. Use this before switching tab control so browsing by the user does not interrupt an agent tab… List bridge browser tabs and report which tab is agent-controlled versus user-focused. Use this before switching tab control so browsing by the user does not interrupt an agent tab.
browser_tap
from source
Dispatch a real touch tap at viewport coordinates (CSS px). Use in phone-emulation mode where mouse clicks are ignored; coordinates are auto-calibrated against browser zoom. Dispatch a real touch tap at viewport coordinates (CSS px). Use in phone-emulation mode where mouse clicks are ignored; coordinates are auto-calibrated against browser zoom.
browser_text
from source
browser_type
from source
browser_type_ref
from source
cli_run
from source
Run another model\ Run another model\
cli_runs
from source
List recent cli_run invocations — id, model, status, duration, and transcript path. Use to see what lent-CLI runs are in flight or finished. List recent cli_run invocations — id, model, status, duration, and transcript path. Use to see what lent-CLI runs are in flight or finished.
cli_run_status
from source
Get the status and output of a cli_run by id. Use to poll a background run to completion (status goes running → done/error/timeout) and read its text + transcript. Get the status and output of a cli_run by id. Use to poll a background run to completion (status goes running → done/error/timeout) and read its text + transcript.
cli_status
from source
Discover which lent CLIs you can drive via cli_run RIGHT NOW. Returns one row per model (codex / grok / claude / agy) with available (installed), lent (owner toggled it on), authen… Discover which lent CLIs you can drive via cli_run RIGHT NOW. Returns one row per model (codex / grok / claude / agy) with available (installed), lent (owner toggled it on), authenticated (signed in), ready (all three), and blocker (cli_not_installed / not_lent / not_signed_in / null). Call this FIRST to route a task to a model that will actually run, instead of calling cli_run and getting a
custom_llm
from source
Send a chat-completion request to any custom LLM the user configured on the bridge\ Send a chat-completion request to any custom LLM the user configured on the bridge\
desktop_calibrate_pointer
from source
desktop_calibration_status
from source
Return the persisted desktop click calibration (per-monitor affine transforms in v2, uniform offset in v1) or null if uncalibrated. Use this to check which monitors are calibrated… Return the persisted desktop click calibration (per-monitor affine transforms in v2, uniform offset in v1) or null if uncalibrated. Use this to check which monitors are calibrated and inspect the residual pixel error.
desktop_click
from source
Click desktop coordinates using Windows DPI-aware physical virtual-screen coordinates. By default x/y are absolute virtual-screen. Pass monitor to use monitor-relative coords, or s… Click desktop coordinates using Windows DPI-aware physical virtual-screen coordinates. By default x/y are absolute virtual-screen. Pass monitor to use monitor-relative coords, or space:
desktop_click_cell
from source
desktop_click_page
from source
Perform a REAL OS-level mouse click on an element inside the bridge\ Perform a REAL OS-level mouse click on an element inside the bridge\
desktop_click_ref
from source
Click a desktop element by ref returned from desktop_snapshot (e.g. Click a desktop element by ref returned from desktop_snapshot (e.g.
desktop_cursor_position
from source
Get the current desktop cursor position in DPI-aware physical virtual-screen coordinates. Get the current desktop cursor position in DPI-aware physical virtual-screen coordinates.
desktop_drag
from source
Drag between desktop coordinates using Windows DPI-aware physical virtual-screen coordinates. By default endpoints are absolute. Pass monitor for monitor-relative or space: Drag between desktop coordinates using Windows DPI-aware physical virtual-screen coordinates. By default endpoints are absolute. Pass monitor for monitor-relative or space:
desktop_focus_grid
from source
Toggle an on-screen click-through grid overlay covering the active agent-focus region. Same chess-board grid (~16 cells, integer pill labels on top + left edges) that goes into the… Toggle an on-screen click-through grid overlay covering the active agent-focus region. Same chess-board grid (~16 cells, integer pill labels on top + left edges) that goes into the focus screenshot — but drawn live ON the user\
desktop_focus_status
from source
Report whether a desktop focus region is currently active, with bounds, mode ( Report whether a desktop focus region is currently active, with bounds, mode (
desktop_hover
from source
Move the desktop cursor using Windows DPI-aware physical virtual-screen coordinates. By default x/y are absolute. Pass monitor for monitor-relative or space: Move the desktop cursor using Windows DPI-aware physical virtual-screen coordinates. By default x/y are absolute. Pass monitor for monitor-relative or space:
desktop_hover_ref
from source
Move the cursor to the center of a desktop element by ref returned from desktop_snapshot. Useful for hover-revealed tooltips and menus. Move the cursor to the center of a desktop element by ref returned from desktop_snapshot. Useful for hover-revealed tooltips and menus.
desktop_monitors
from source
List desktop monitors with DPI-aware physical bounds, including negative coordinates and working areas. List desktop monitors with DPI-aware physical bounds, including negative coordinates and working areas.
desktop_overlay
from source
Toggle a click-through overlay that draws labeled rectangles over the elements from the most recent desktop_snapshot. The overlay is fully transparent to clicks/keys so it never bl… Toggle a click-through overlay that draws labeled rectangles over the elements from the most recent desktop_snapshot. The overlay is fully transparent to clicks/keys so it never blocks the user. Useful when an agent is driving the desktop and the human wants to see what is being targeted. The overlay auto-refreshes whenever a new snapshot is taken.
desktop_pick_point
from source
Ask the user to designate a point inside the agent-focus region. A semi-transparent capture overlay appears over the focus area with a banner prompt; user clicks anywhere inside; b… Ask the user to designate a point inside the agent-focus region. A semi-transparent capture overlay appears over the focus area with a banner prompt; user clicks anywhere inside; bridge returns the click position as focus-relative pixel, absolute pixel, AND chess-board cell coords (col/row/subX/subY matching the desktop_focus_grid overlay). Eliminates
desktop_pointer_cell
from source
Show the ghost cursor at the center of a focus-grid cell. Same addressing as desktop_click_cell — col/row (1-indexed) match the on-screen pill labels. Show the ghost cursor at the center of a focus-grid cell. Same addressing as desktop_click_cell — col/row (1-indexed) match the on-screen pill labels.
desktop_pointer_hide
from source
Hide the ghost cursor overlay if it is currently shown. Hide the ghost cursor overlay if it is currently shown.
desktop_pointer_move
from source
Reposition the ghost cursor to new coords. If no pointer is currently shown, this is equivalent to desktop_pointer_show. The overlay polls every ~40ms so updates feel near real-tim… Reposition the ghost cursor to new coords. If no pointer is currently shown, this is equivalent to desktop_pointer_show. The overlay polls every ~40ms so updates feel near real-time. Applies the persisted calibration unless noCalibration:true. Supports space:
desktop_pointer_page
from source
Show the click-through Show the click-through
desktop_pointer_pulse
from source
Trigger a one-shot expanding ring animation at the ghost cursor\ Trigger a one-shot expanding ring animation at the ghost cursor\
desktop_pointer_show
from source
Show a click-through Show a click-through
desktop_pointer_status
from source
Report whether the ghost cursor is currently shown, its position and label, and whether the overlay PS process is alive. Report whether the ghost cursor is currently shown, its position and label, and whether the overlay PS process is alive.
desktop_release_focus
from source
Clear the bridge\ Clear the bridge\
desktop_screenshot
from source
Capture desktop screenshots in DPI-aware physical coordinates. Pass Capture desktop screenshots in DPI-aware physical coordinates. Pass
desktop_screenshot_primary
from source
desktop_screenshot_zoom
from source
desktop_screen_size
from source
desktop_select_region
from source
Open a fullscreen overlay that lets the USER drag a rectangle around the area they want help with. Blocks until the user finishes selecting (or hits Esc to cancel). On success, set… Open a fullscreen overlay that lets the USER drag a rectangle around the area they want help with. Blocks until the user finishes selecting (or hits Esc to cancel). On success, sets the bridge\
desktop_snapshot
from source
Enumerate visible interactive elements (buttons, menus, inputs, list items, tabs) on the desktop via Windows UI Automation. Returns refs like Enumerate visible interactive elements (buttons, menus, inputs, list items, tabs) on the desktop via Windows UI Automation. Returns refs like
desktop_snapshot_som
from source
Set-of-Mark snapshot for the agent-focus region (or an explicit region). Runs a UIA enumeration, filters to elements inside the region, takes a focus-scoped screenshot, and DRAWS n… Set-of-Mark snapshot for the agent-focus region (or an explicit region). Runs a UIA enumeration, filters to elements inside the region, takes a focus-scoped screenshot, and DRAWS numbered colored boxes (1..N) directly on the image. The agent reads the numbers off the image and acts with desktop_click_ref using the returned
desktop_toolbar
from source
Open, close, or check the movable desktop toolbar widget. The toolbar exposes focus region, release focus, trusted local chat, recording, playback, saved recording selection, and q… Open, close, or check the movable desktop toolbar widget. The toolbar exposes focus region, release focus, trusted local chat, recording, playback, saved recording selection, and quick calibration on the monitor where the toolbar sits.
higgsfield_generate
from source
Generate a Higgsfield image or video from a text prompt (and optional reference image). Returns the result URL plus a local artifact path under ~/.empir3-bridge/artifacts/higgsfiel… Generate a Higgsfield image or video from a text prompt (and optional reference image). Returns the result URL plus a local artifact path under ~/.empir3-bridge/artifacts/higgsfield/. Costs money/quota on the user\
higgsfield_list
from source
List the user\ List the user\
higgsfield_models
from source
List the available Higgsfield models so you can pick a valid List the available Higgsfield models so you can pick a valid
higgsfield_status
from source
Check whether the higgsfield CLI is installed, authenticated, and ready. Check whether the higgsfield CLI is installed, authenticated, and ready.
page_to_screen
from source