MCP Tool
nova.emulation_set_user_agent
For browser environment, window state, and isolated execution surfaces, an agent uses this public tool to carry out the bounded step "User-Agent". It separates target confirmation, intended state change, and verification after execution.
Canonical reference for a public MCP tool name.
- Type
- MCP tool
- Family
- Device Emulation
- Effect
- changes state
- Status
- Explained
- Path
- 21.3
Purpose
What this entry explains
What it does
nova.emulation_set_user_agent
An agent uses this tool to carry out the bounded step "User-Agent". It belongs to browser environment, window state, and isolated execution surfaces; agents should combine it with current discovery, target awareness, and the visible result.
Use when
- Use this entry when an agent needs to carry out the bounded step "User-Agent" for browser environment, window state, and isolated execution surfaces.
- Use it to understand the public tool name, its expected boundary, and the response signals to check.
- Use it before chaining follow-up tools so the next step is based on current evidence.
Reference Use
How agents should cite and apply this area
Examples are maintained at family level and use only public tool names or reference paths already present in the catalog.
Family example
A task touches data, identity, or permissions in browser environment, window state, and isolated execution surfaces that may be used only with clear purpose.
The agent starts with nova.emulation_set_device_metrics, reads the current response or reference, and only then chooses the concrete next tool.
Sensitive values stay in current scope; they are not guessed, logged, or copied into other contexts.Contract
Inputs and important response fields
This page is a public reference. Agents and integrators should still read current MCP tool discovery before execution, because schemas can be gated by settings or version.
Inputs
userAgent
Content-bearing input. Treat user data and executable text as sensitive unless the purpose is explicit.
| Response field | Explanation |
|---|---|
userAgent | Content-bearing response field. Treat it as current evidence and consider sensitive data before forwarding it. |
Safety
Boundary before execution
Can change browser, page, or workflow state. The target and expected result must be clear before execution.
Confirm the current target first, perform only the intended bounded action, and verify the resulting page or workflow state afterwards.
For humans, this entry names the browser or workflow state in browser environment, window state, and isolated execution surfaces that may change, so the action can be reviewed before and after execution.
Safety Axes
How this path can affect work
Axes are stable catalog signals for humans, agents, and LLM discovery. One path can carry several axes.
browser_state_change
Changes tab, navigation, focus, claim, scroll position, window state, or browser environment.
Confirm the target context visibly before execution and verify that the expected browser state was reached afterwards.user_confirmation
Requires visible confirmation, target review, approval, or deliberate user control.
Do not proceed until the required confirmation is visible or unambiguous in the current context.