ClearInput
ClearInput action, the position of the placeholder or text content in the target input field. If there is no content, locate the center of the input field.. Parameters: locate? (object) - The input field to be cleared
This record as markdown: /tools/android/clearinput.md
What ClearInput does on Android
AI agents call ClearInput to permanently remove resources in Android, typically in cleanup and lifecycle workflows. It does its job in a single call, and there is no undo.
| Parameter | Type | Required | Description |
|---|---|---|---|
locate | object | — | The input field to be cleared |
android.deviceId | string | — | Android device ID (from adb devices) |
android.useScrcpy | boolean | — | Enable scrcpy accelerated screenshots |
android.aiActContext | string | — | Background knowledge passed to aiAct. Default: no extra context. |
android.waitAfterAction | number | — | Wait time in milliseconds after each action execution. Default: 300ms. |
android.replanningCycleLimit | integer | — | Maximum number of replanning cycles for aiAct. Default: model adapter default. |
android.screenshotShrinkFactor | number | — | Screenshot shrink factor before sending images to AI. Default: 1; high values may reduce recognition quality, especially on mobile. |
Parameters from the server's own tool schema.
Why ClearInput is rated Critical
ClearInput irreversibly erases the content of an input field on an Android device. While the data loss is scoped to a single UI field, the action cannot be undone programmatically once the content is cleared, making it Destructive rather than Write. Misuse could cause loss of unsaved user data in forms or text fields.
From the tool's definition ClearInput action...the input field to be cleared
Risk signalsHigh parameter count (12 properties)
Attacks that exploit this kind of access
The rule that runs ClearInput safely
PolicyLayer is an MCP gateway: it sits between your AI agents and Android, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For ClearInput, this is the rule to start with:
ClearInput is removed from the agent's tool list entirely, so the agent never calls it. The rest of the server keeps working.
The button opens the PolicyLayer dashboard: create your workspace, connect Android, apply this rule, and every ClearInput call is checked against it from then on.
Questions about ClearInput
ClearInput action, the position of the placeholder or text content in the target input field. If there is no content, locate the center of the input field.. Parameters: locate? (object) - The input field to be cleared. It is categorised as a Destructive tool in the Android MCP Server, which means it can permanently delete or destroy data. Block by default and require explicit approval.
ClearInput accepts 7 parameters: locate, android.deviceId, android.useScrcpy, android.aiActContext, android.waitAfterAction, android.replanningCycleLimit, android.screenshotShrinkFactor. The full parameter table on this page comes from the server's own tool schema.
Register the Android MCP server in PolicyLayer and add a rule for ClearInput: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Android. Nothing to install.
ClearInput is a Destructive tool with critical risk. Critical-risk tools should be blocked by default and only enabled with explicit human approval.
Yes. Add a rate_limit block to the ClearInput rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for ClearInput. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
ClearInput is provided by the Android MCP server (@midscene/android-mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on Android, and thousands of servers like it.
Across the catalogue