android_app_query

Launch/query a package in Redroid and report whether visible UI contains query text, plus a needsUser hint for login/OTP handoff screens.

SERVERYaver SOURCEyaver-cli

High RISK CLASS

Category Execute

Parameters 91 required

Recommended Rate-limitedsee the rule below

Registry record Grade F, identity unverified Pull the record →

This record as markdown: /tools/io-github-kivanccakmak-yaver/android-app-query.md

WHAT IT DOES

What android_app_query does on Yaver

AI agents invoke android_app_query to trigger actions in Yaver. What it does depends on the arguments the agent supplies, and its effects often reach beyond the immediate call: builds kicked off, notifications sent, workflows started.

Parameter	Type	Required	Description
`key`	string	—	Optional Android keyevent alias/code after typing, e.g. ENTER, BACK.
`text`	string	—	Optional text to type after launch.
`image`	string	—	Optional Redroid image. Default redroid/redroid:13.0.0-latest.
`query`	string	—	Text to look for in the UIAutomator view tree after launch.
`container`	string	—	Optional Redroid container name. Default yaver-app-sync-redroid.
`device_id`	string	—	Optional owned Yaver device id/name/alias whose agent hosts the Redroid surface.
`wait_text`	string	—	Optional text to wait for briefly before collecting UI text.
`package_name`	string	Yes	Android package id, e.g. com.example.app.
`host_work_dir`	string	—	Optional host dir bind-mounted to Redroid /data. Default ~/.yaver/redroid-app-sync.

Parameters from the server's own tool schema.

RISK

Why android_app_query is rated High

This tool actively launches an Android package inside a Redroid container and inspects the resulting UI, constituting execution of an external application. It is not a passive read because it causes the app to start and run.

From the tool's definition 'Launch/query a package in Redroid' — launches an application and executes a query against its UI state, triggering external operations (app launch, UI interaction) in an Android emulator environment.

Attacks that exploit this kind of access

RECOMMENDED RULE

The rule that runs android_app_query safely

PolicyLayer is an MCP gateway: it sits between your AI agents and Yaver, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For android_app_query, this is the rule to start with:

android_app_query Rate-limited

android_app_query stays usable, but rate-capped: a runaway agent can't fire it dozens of times a minute. Everything else on the server is denied unless you say otherwise.

View as policy code

policy.json

{
  "version": "1",
  "default": "deny",
  "tools": {
    "android_app_query": {
      "limits": [
        {
          "counter": "android_app_query_rate",
          "window": "minute",
          "max": 10,
          "scope": "grant"
        }
      ]
    }
  }
}

RATE-LIMIT THIS TOOL → Instant setup, no code required.

The button opens the PolicyLayer dashboard: create your workspace, connect Yaver, apply this rule, and every android_app_query call is checked against it from then on.

FAQ

Questions about android_app_query

What does the android_app_query tool do? +

Launch/query a package in Redroid and report whether visible UI contains query text, plus a needsUser hint for login/OTP handoff screens. It is categorised as a Execute tool in the Yaver MCP Server, which means it can trigger actions or run processes. Use rate limits and argument validation.

What parameters does android_app_query accept? +

android_app_query accepts 9 parameters: key, text, image, query, container, device_id, wait_text, package_name, host_work_dir. Required: package_name. The full parameter table on this page comes from the server's own tool schema.

How do I enforce a policy on android_app_query? +

Register the Yaver MCP server in PolicyLayer and add a rule for android_app_query: 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 Yaver. Nothing to install.

What risk level is android_app_query? +

android_app_query is a Execute tool with high risk. Execute tools should be rate-limited and have argument validation enabled.

Can I rate-limit android_app_query? +

Yes. Add a rate_limit block to the android_app_query 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.

How do I block android_app_query completely? +

Set action: deny in the PolicyLayer policy for android_app_query. 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.

What MCP server provides android_app_query? +

android_app_query is provided by the Yaver MCP server (yaver-cli). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

KEEP EXPLORING

More on Yaver, and thousands of servers like it.

This server

All 645 Yaver tools → High-risk tools on this server →

Across the catalogue

aroflo_query_zone on AroFlo MCP →disable_passenger_app on cPanel MCP Server → All high-risk MCP tools → The MCP Attack Database →

Guides

Govern code and CI agents →Agent sandbox →Least privilege for MCP →