Agent cursor tools
Show, animate and style the agent cursor.
Show, animate and style the agent cursor.
| Tool | Description | Platforms |
|---|---|---|
set_agent_cursor_enabled | Show or hide the agent cursor owned by a session. | macOS, Linux, Windows |
set_agent_cursor_motion | Configure only movement physics and visibility timing for a session cursor. | macOS, Linux, Windows |
set_agent_cursor_theme | Select an already-installed cursor theme for a session. | macOS, Linux, Windows |
get_agent_cursor_state | Return the session cursor's theme, semantic playback, position, visibility, and motion. | macOS, Linux, Windows |
Served by cua-driver mcp; see MCP tools for every tool.
set_agent_cursor_enabled#Show or hide the agent cursor owned by a session.
Effect: mutating, idempotent. Platforms: macOS, Linux, Windows.
| Parameter | Type | Default | Description |
|---|---|---|---|
enabled | boolean | required | true shows the session's agent cursor overlay; false hides it. |
session | string | required | Public label of the session that owns the cursor. |
Example arguments
{"session":"<session>","enabled":false}set_agent_cursor_motion#Configure only movement physics and visibility timing for a session cursor.
Effect: mutating, idempotent. Platforms: macOS, Linux, Windows.
| Parameter | Type | Default | Description |
|---|---|---|---|
arc_flow | number | Arc asymmetry: positive puts the apex near the destination, negative near the start. Clamped to -1..1 (default 0). | |
arc_size | number | Sideways arc deflection as a fraction of the distance. Clamped to 0..1 (default 0.25). | |
dwell_after_click_ms | number | Pause after a click animation, in milliseconds. Clamped to 0..5000 (default 80). | |
end_handle | number | Path control-point offset from the end, as a fraction of the distance. Clamped to 0..1 (default 0.3). | |
glide_duration_ms | number | Fixed glide duration in milliseconds. 0 (the default) uses speed-based timing. Clamped to 0..5000. | |
idle_hide_ms | number | Hide the cursor after this many idle milliseconds; 0 never hides it. Clamped to 0..60000 (default 15000). | |
session | string | required | Public label of the session that owns the cursor. Omitted or null motion fields keep their current value. |
spring | number | Post-arrival spring damping: 1 is critically damped, 0.3 is bouncy. Clamped to 0.3..1 (default 0.72). | |
start_handle | number | Path control-point offset from the start, as a fraction of the distance. Clamped to 0..1 (default 0.3). | |
turn_radius | number | Minimum turning radius of the glide path, in points; smaller turns tighter. Clamped to 1..1000 (default 80). |
Example arguments
{"session":"<session>"}set_agent_cursor_theme#Select an already-installed cursor theme for a session.
Effect: mutating, idempotent. Platforms: macOS, Linux, Windows.
| Parameter | Type | Default | Description |
|---|---|---|---|
reduced_motion | "auto" | "on" | "off" | "auto" | Theme animation policy: on uses the theme's reduced-motion frames, off always animates, auto (default) leaves the choice to the host. |
session | string | required | Public label of the session that owns the cursor. |
theme_id | string | required | Id of an installed cursor theme (see cua-driver cursor-theme list). |
Example arguments
{"session":"<session>","theme_id":"<theme_id>"}get_agent_cursor_state#Return the session cursor's theme, semantic playback, position, visibility, and motion.
Effect: read-only, idempotent. Platforms: macOS, Linux, Windows.
| Parameter | Type | Default | Description |
|---|---|---|---|
session | string | required | Public label of the session whose cursor to inspect. |
Example arguments
{"session":"<session>"}