# Droidline (mcpb · droidline.mcpb)

Let an AI agent see and use a real Android phone over Wi-Fi, without ADB or root.

- Trust score: 52/100 (low)
- Change this week: +3
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-05

## Components

- mcpb · `droidline.mcpb`: 52/100 (this document), [markdown](https://verifymcp.io/servers/knifelemon-droidline/droidline.md), [page](https://verifymcp.io/servers/knifelemon-droidline/droidline)

## Channel facts

- Registry: `mcpb`
- Package: `https://github.com/KnifeLemon/Droidline/releases/download/v0.1.13/droidline.mcpb`
- Transport: `stdio`
- SHA-256: `e90a308a28472d209c2efb181db5089923c8c421988bb060c4c956a87f7bc120`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-05.

- **Supply Chain Security**: 0/100
  - No malware scan is available for this kind of package: the supply-chain vendors we use do not cover it. This is a permanent gap in our coverage, not a finding about the package.
  - Known CVEs could not be checked: we found no dependency list to check in this bundle: either it runs a compiled binary, whose bundled manifests we do not read, or none of the package.json, requirements.txt, pyproject.toml or uv.lock files it ships for its runtime declares a dependency we can read (a requirements.txt that only points at a setup.py project, a local path, or a nested requirements file we cannot follow counts as none).
  - Install-script risk not yet assessed.
  - Dependency health could not be checked: we found no dependency list to check in this bundle: either it runs a compiled binary, whose bundled manifests we do not read, or none of the package.json, requirements.txt, pyproject.toml or uv.lock files it ships for its runtime declares a dependency we can read (a requirements.txt that only points at a setup.py project, a local path, or a nested requirements file we cannot follow counts as none).
- **Provenance & Transparency**: 48/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 1 days ago).
  - Publishes a security disclosure policy (SECURITY.md).
- **Schema Quality & AI Usability**: 81/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 7597 tokens (~110/item across 69 items; 68 tools + 1 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 73/100
  - Stability observed for 22 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - All 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.
  - An AI judge read all 70 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### How do I install the Droidline MCP server?

Droidline ships as an MCPB bundle, a single file you download and open in an MCP host that supports MCPB bundles, such as Claude Desktop. The host reads the launch command from the bundle's own manifest, so there is no command to copy. Before opening it, check the file's SHA-256 matches the one the MCP registry declares for it, e90a308a28472d209c2efb181db5089923c8c421988bb060c4c956a87f7bc120; the commands to do that are on this page. If it does not match, do not open it.

- Download bundle: `https://github.com/KnifeLemon/Droidline/releases/download/v0.1.13/droidline.mcpb`
- SHA-256: `e90a308a28472d209c2efb181db5089923c8c421988bb060c4c956a87f7bc120`

### Verify on macOS / Linux

```bash
echo "e90a308a28472d209c2efb181db5089923c8c421988bb060c4c956a87f7bc120  droidline.mcpb" | shasum -a 256 -c
```

### Verify on Windows (PowerShell)

```powershell
(Get-FileHash -Algorithm SHA256 .\droidline.mcpb).Hash -eq "e90a308a28472d209c2efb181db5089923c8c421988bb060c4c956a87f7bc120"
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-03 (score 52, +1)

No change was recorded against any check on this day. Stability & Change Management went from 63 to 67. That category is still filling its 30-day observation window: 19 days of observed history at the previous scan, 20 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-01 (score 51, +1)

No change was recorded against any check on this day. Stability & Change Management went from 57 to 60. That category is still filling its 30-day observation window: 17 days of observed history at the previous scan, 18 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-30 (score 50, +1)

No change was recorded against any check on this day. Stability & Change Management went from 50 to 53. That category is still filling its 30-day observation window: 15 days of observed history at the previous scan, 16 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-28 (score 49, +1)

No change was recorded against any check on this day. Stability & Change Management went from 43 to 47. That category is still filling its 30-day observation window: 13 days of observed history at the previous scan, 14 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-26 (score 48, +1)

No change was recorded against any check on this day. Stability & Change Management went from 37 to 40. That category is still filling its 30-day observation window: 11 days of observed history at the previous scan, 12 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-24 (score 47, +1)

No change was recorded against any check on this day. Stability & Change Management went from 30 to 33. That category is still filling its 30-day observation window: 9 days of observed history at the previous scan, 10 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-22 (score 46, +4)

- [functional improvement] Stability: unverified → 0.27

### 2026-10-14 (score 42, +32)

- [security improvement] Injection markers: unverified → pass
- [security] First check of Judged manipulation: pass
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] Schema quality: unverified → 100
- [functional improvement] MCP protocol: unverified → pass
- [functional] First check of Schema quality: fail
- [functional] First check of Schema quality: fail
- [functional] First check of Destructive annotations: 100
- [functional] First check of Schema quality: good
- [functional] First check of Tool coverage: 100

## MCP tools (68)

### `dump` (~61 tokens)

Return the current screen as a node tree Example: dump("screen.json")

Input parameters:

- `all_windows` (boolean): Include system windows such as the status bar and keyboard Default false.
- `device` (string): Phone ID or name. Optional when exactly one phone is online.

### `screenshot` (~110 tokens)

Capture the screen. Android 11+ uses the accessibility screenshot. Android 9-10 asks once for screen capture permission. Example: screenshot("a.png")

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `format` (string): Image format Default jpeg.
- `quality` (integer): JPEG quality 1-100 Default 80.
- `scale` (number): Resize factor 0.1-1.0, useful on mobile data Default 1.

### `find_image` (~296 tokens)

Find a picture on the screen. Optional, and runs on the PC: the server takes a screenshot and compares. Cut the image from a screenshot of the same phone; for a phone with another screen density, pass scales. On Android 9 and 10 screenshots need screen capture permission. Example: find_image("ok-button.png")

Input parameters:

- `color` (boolean): Also require the average color to agree, so a red and a green button of the same shape differ Default false.
- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `image` (string, required): PNG or JPEG of what to find, cut from a screenshot of the same phone. The SDKs and the CLI take a file path; on the wire it is base64 Pass the PNG or JPEG as base64.
- `region`: Search only inside this box, given as left, top, right, bottom in screen pixels. Faster, and nothing outside it can match
- `scales`: Sizes of the image to try, 1 being the size it was cut at, such as 0.8, 1, 1.25 for a phone with another screen density. Each size adds time
- `threshold` (number): How close the match must be, from 0 to 1 Default 0.9.
- `timeout` (number): Seconds to wait for the target to appear Default 10.

### `tap_image` (~300 tokens)

Find a picture on the screen and tap its center. Optional, and runs on the PC: the server takes a screenshot and compares. Cut the image from a screenshot of the same phone; for a phone with another screen density, pass scales. On Android 9 and 10 screenshots need screen capture permission. Example: tap_image("ok-button.png")

Input parameters:

- `color` (boolean): Also require the average color to agree, so a red and a green button of the same shape differ Default false.
- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `image` (string, required): PNG or JPEG of what to find, cut from a screenshot of the same phone. The SDKs and the CLI take a file path; on the wire it is base64 Pass the PNG or JPEG as base64.
- `region`: Search only inside this box, given as left, top, right, bottom in screen pixels. Faster, and nothing outside it can match
- `scales`: Sizes of the image to try, 1 being the size it was cut at, such as 0.8, 1, 1.25 for a phone with another screen density. Each size adds time
- `threshold` (number): How close the match must be, from 0 to 1 Default 0.9.
- `timeout` (number): Seconds to wait for the target to appear Default 10.

### `image_exists` (~283 tokens)

Whether a picture is on the screen right now. Never waits. Optional, and runs on the PC: the server takes a screenshot and compares. Cut the image from a screenshot of the same phone; for a phone with another screen density, pass scales. On Android 9 and 10 screenshots need screen capture permission. Example: image_exists("coin.png")

Input parameters:

- `color` (boolean): Also require the average color to agree, so a red and a green button of the same shape differ Default false.
- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `image` (string, required): PNG or JPEG of what to find, cut from a screenshot of the same phone. The SDKs and the CLI take a file path; on the wire it is base64 Pass the PNG or JPEG as base64.
- `region`: Search only inside this box, given as left, top, right, bottom in screen pixels. Faster, and nothing outside it can match
- `scales`: Sizes of the image to try, 1 being the size it was cut at, such as 0.8, 1, 1.25 for a phone with another screen density. Each size adds time
- `threshold` (number): How close the match must be, from 0 to 1 Default 0.9.

### `find_images` (~307 tokens)

Every place a picture appears on the screen. Answers at once, with an empty list when nothing matches, unless timeout is set. Best matches come first and never overlap. Runs on the PC; for a phone with another screen density, pass scales. Example: find_images("coin.png")

Input parameters:

- `color` (boolean): Also require the average color to agree, so a red and a green button of the same shape differ Default false.
- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `image` (string, required): PNG or JPEG of what to find, cut from a screenshot of the same phone. The SDKs and the CLI take a file path; on the wire it is base64 Pass the PNG or JPEG as base64.
- `max` (integer): Most matches to return Default 20.
- `region`: Search only inside this box, given as left, top, right, bottom in screen pixels. Faster, and nothing outside it can match
- `scales`: Sizes of the image to try, 1 being the size it was cut at, such as 0.8, 1, 1.25 for a phone with another screen density. Each size adds time
- `threshold` (number): How close the match must be, from 0 to 1 Default 0.9.
- `timeout` (number): Seconds to wait for at least one match. 0 answers at once Default 0.

### `wait_image_gone` (~303 tokens)

Wait until a picture is no longer on the screen. Optional, and runs on the PC: the server takes a screenshot and compares. Cut the image from a screenshot of the same phone; for a phone with another screen density, pass scales. On Android 9 and 10 screenshots need screen capture permission. Example: wait_image_gone("loading.png")

Input parameters:

- `color` (boolean): Also require the average color to agree, so a red and a green button of the same shape differ Default false.
- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `image` (string, required): PNG or JPEG of what to find, cut from a screenshot of the same phone. The SDKs and the CLI take a file path; on the wire it is base64 Pass the PNG or JPEG as base64.
- `region`: Search only inside this box, given as left, top, right, bottom in screen pixels. Faster, and nothing outside it can match
- `scales`: Sizes of the image to try, 1 being the size it was cut at, such as 0.8, 1, 1.25 for a phone with another screen density. Each size adds time
- `threshold` (number): How close the match must be, from 0 to 1 Default 0.9.
- `timeout` (number): Seconds to wait for the target to appear Default 10.

### `ocr` (~114 tokens)

Read the text on the screen with OCR. Optional, and runs on the PC with Tesseract, which you install yourself along with the language data you need. Nothing is installed for you. On Android 9 and 10 screenshots need screen capture permission. Example: ocr("kor+eng")

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `lang` (string): Tesseract languages, such as kor+eng. Each needs its language data installed Default eng.

### `ocr_find` (~163 tokens)

Wait until OCR reads some text on the screen and return where it is. Optional, and runs on the PC with Tesseract, which you install yourself along with the language data you need. Nothing is installed for you. On Android 9 and 10 screenshots need screen capture permission. Example: ocr_find("확인", "kor")

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `lang` (string): Tesseract languages, such as kor+eng. Each needs its language data installed Default eng.
- `text` (string, required): Text to look for: a whole word, or part of a line
- `timeout` (number): Seconds to wait for the target to appear Default 10.

### `ocr_tap` (~163 tokens)

Wait until OCR reads some text on the screen and tap it. Optional, and runs on the PC with Tesseract, which you install yourself along with the language data you need. Nothing is installed for you. On Android 9 and 10 screenshots need screen capture permission. Example: ocr_tap("확인", "kor")

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `lang` (string): Tesseract languages, such as kor+eng. Each needs its language data installed Default eng.
- `text` (string, required): Text to look for: a whole word, or part of a line
- `timeout` (number): Seconds to wait for the target to appear Default 10.

### `current` (~35 tokens)

Foreground package and activity Example: current()

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.

### `tap` (~62 tokens)

Tap a screen coordinate Example: tap(540, 1200)

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `x` (integer, required): X in screen pixels
- `y` (integer, required): Y in screen pixels

### `long_tap` (~84 tokens)

Press and hold a coordinate Example: long_tap(540, 1200, 800)

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `ms` (integer): Hold time in milliseconds Default 800.
- `x` (integer, required): X in screen pixels
- `y` (integer, required): Y in screen pixels

### `swipe` (~120 tokens)

Swipe between two points, or in a direction Example: swipe(540, 1600, 540, 400, 300)

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `ms` (integer): Duration in milliseconds Default 300.
- `x1` (integer|string, required): Start X, or a direction: up, down, left, right
- `x2` (integer): End X
- `y1` (integer): Start Y
- `y2` (integer): End Y

### `touch` (~174 tokens)

Wait for an element and tap it. If the node refuses the click, the center of its bounds is tapped instead. via tells which path worked: node, parent or gesture. Example: touch("id", "com.kakao.talk:id/login")

Input parameters:

- `by` (required): Which dump field to match (text, textContains, textMatches, id, desc, descContains, descMatches, class), or a query object with several conditions
- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `nth` (integer): Index when several elements match, starting at 0 Default 0.
- `timeout` (number): Seconds to wait for the target to appear Default 10.
- `value` (string): The value to match. Leave it out when by is a query object

### `long_touch` (~159 tokens)

Wait for an element and press and hold it Example: long_touch("text", "메시지")

Input parameters:

- `by` (required): Which dump field to match (text, textContains, textMatches, id, desc, descContains, descMatches, class), or a query object with several conditions
- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `ms` (integer): Hold time in milliseconds Default 800.
- `nth` (integer): Index when several elements match, starting at 0 Default 0.
- `timeout` (number): Seconds to wait for the target to appear Default 10.
- `value` (string): The value to match. Leave it out when by is a query object

### `scroll_to` (~156 tokens)

Scroll until an element is visible Example: scroll_to("text", "설정")

Input parameters:

- `by` (required): Which dump field to match (text, textContains, textMatches, id, desc, descContains, descMatches, class), or a query object with several conditions
- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `direction` (string): Direction the content moves toward Default down.
- `max_swipes` (integer): Give up after this many swipes Default 20.
- `nth` (integer): Index when several elements match, starting at 0 Default 0.
- `value` (string): The value to match. Leave it out when by is a query object

### `input` (~200 tokens)

Wait for a field and set its text. Uses the accessibility set-text action. Fields that ignore it fall back to the Droidline keyboard when it is selected. Example: input("id", "com.kakao.talk:id/email", "knife")

Input parameters:

- `append` (boolean): Keep existing text and add to the end Default false.
- `by` (required): Which dump field to match (text, textContains, textMatches, id, desc, descContains, descMatches, class), or a query object with several conditions
- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `nth` (integer): Index when several elements match, starting at 0 Default 0.
- `text` (string, required): Text to enter
- `timeout` (number): Seconds to wait for the target to appear Default 10.
- `value` (string): The value to match. Leave it out when by is a query object

### `clear` (~142 tokens)

Empty a text field Example: clear("id", "com.kakao.talk:id/email")

Input parameters:

- `by` (required): Which dump field to match (text, textContains, textMatches, id, desc, descContains, descMatches, class), or a query object with several conditions
- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `nth` (integer): Index when several elements match, starting at 0 Default 0.
- `timeout` (number): Seconds to wait for the target to appear Default 10.
- `value` (string): The value to match. Leave it out when by is a query object

### `sendkey` (~136 tokens)

Send a key name, a key code, or text. back, home, recents, notifications, quick_settings and lock use accessibility global actions. Other keys and text go through the Droidline keyboard to the focused field. Example: sendkey("enter")

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `key`: Key name (enter, tab, del, space, escape, up, down, left, right, back, home...), Android key code, or text to type
- `text` (string): Type this text literally, even if it equals a key name

### `exists` (~129 tokens)

Whether an element is on screen right now. Never waits Example: exists("text", "광고 닫기")

Input parameters:

- `by` (required): Which dump field to match (text, textContains, textMatches, id, desc, descContains, descMatches, class), or a query object with several conditions
- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `nth` (integer): Index when several elements match, starting at 0 Default 0.
- `value` (string): The value to match. Leave it out when by is a query object

### `wait` (~141 tokens)

Wait until an element appears Example: wait("text", "완료", 30)

Input parameters:

- `by` (required): Which dump field to match (text, textContains, textMatches, id, desc, descContains, descMatches, class), or a query object with several conditions
- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `nth` (integer): Index when several elements match, starting at 0 Default 0.
- `timeout` (number): Seconds to wait for the target to appear Default 10.
- `value` (string): The value to match. Leave it out when by is a query object

### `wait_gone` (~123 tokens)

Wait until an element disappears Example: wait_gone("text", "로딩 중")

Input parameters:

- `by` (required): Which dump field to match (text, textContains, textMatches, id, desc, descContains, descMatches, class), or a query object with several conditions
- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `timeout` (number): Seconds to wait for the target to appear Default 10.
- `value` (string): The value to match. Leave it out when by is a query object

### `wait_idle` (~115 tokens)

Wait until the screen stops changing. Waits until the app in front has drawn nothing new for ms milliseconds. Use it after an action that loads content, instead of a fixed sleep. A screen that animates all the time ends in TIMEOUT. Example: wait_idle()

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `ms` (integer): How long the screen must stay unchanged Default 500.
- `timeout` (number): Seconds to wait before giving up Default 10.

### `find` (~165 tokens)

Wait for an element and return it. The SDKs return an element object with click, input, find and the node fields. The node comes without children. Example: find("text", "로그인")

Input parameters:

- `by` (required): Which dump field to match (text, textContains, textMatches, id, desc, descContains, descMatches, class), or a query object with several conditions
- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `nth` (integer): Index when several elements match, starting at 0 Default 0.
- `timeout` (number): Seconds to wait for the target to appear Default 10.
- `value` (string): The value to match. Leave it out when by is a query object

### `find_all` (~152 tokens)

Every element that matches right now. Answers at once, with an empty list when nothing matches, unless timeout is set. Directional queries come back nearest first. Example: find_all("id", "title")

Input parameters:

- `by` (required): Which dump field to match (text, textContains, textMatches, id, desc, descContains, descMatches, class), or a query object with several conditions
- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `timeout` (number): Seconds to wait for at least one match. 0 answers at once Default 0.
- `value` (string): The value to match. Leave it out when by is a query object

### `get_text` (~129 tokens)

Text of an element, or an empty string Example: get_text("id", "com.example:id/balance")

Input parameters:

- `by` (required): Which dump field to match (text, textContains, textMatches, id, desc, descContains, descMatches, class), or a query object with several conditions
- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `nth` (integer): Index when several elements match, starting at 0 Default 0.
- `value` (string): The value to match. Leave it out when by is a query object

### `checked` (~130 tokens)

true if a switch or checkbox is on Example: checked("id", "com.kakao.talk:id/auto_login")

Input parameters:

- `by` (required): Which dump field to match (text, textContains, textMatches, id, desc, descContains, descMatches, class), or a query object with several conditions
- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `nth` (integer): Index when several elements match, starting at 0 Default 0.
- `value` (string): The value to match. Leave it out when by is a query object

### `enabled` (~122 tokens)

true if the element can be pressed Example: enabled("text", "다음")

Input parameters:

- `by` (required): Which dump field to match (text, textContains, textMatches, id, desc, descContains, descMatches, class), or a query object with several conditions
- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `nth` (integer): Index when several elements match, starting at 0 Default 0.
- `value` (string): The value to match. Leave it out when by is a query object

### `selected` (~123 tokens)

true if a tab or item is selected Example: selected("text", "채팅")

Input parameters:

- `by` (required): Which dump field to match (text, textContains, textMatches, id, desc, descContains, descMatches, class), or a query object with several conditions
- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `nth` (integer): Index when several elements match, starting at 0 Default 0.
- `value` (string): The value to match. Leave it out when by is a query object

### `count` (~101 tokens)

Number of matching elements Example: count("class", "android.widget.CheckBox")

Input parameters:

- `by` (required): Which dump field to match (text, textContains, textMatches, id, desc, descContains, descMatches, class), or a query object with several conditions
- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `value` (string): The value to match. Leave it out when by is a query object

### `which` (~93 tokens)

Index of the first candidate to appear, or -1 Example: which([("text", "로그인"), ("text", "홈")], timeout=10)

Input parameters:

- `candidates` (array, required): List of [by, value] pairs or query objects
- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `timeout` (number): Seconds to wait for any candidate Default 10.

### `in_app` (~61 tokens)

true if that app is in the foreground Example: in_app("com.kakao.talk")

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `package` (string, required): Package name, for example com.android.chrome

### `keyboard_shown` (~41 tokens)

true if a soft keyboard is showing Example: keyboard_shown()

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.

### `last_toast` (~64 tokens)

Text of the most recent toast, or an empty string Example: last_toast()

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `max_age` (number): Ignore toasts older than this many seconds Default 30.

### `color` (~80 tokens)

Pixel color at a coordinate as #RRGGBB. For screens without accessibility nodes, such as games. Example: color(540, 1200)

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `x` (integer, required): X in screen pixels
- `y` (integer, required): Y in screen pixels

### `screen_on` (~38 tokens)

true if the screen is on Example: screen_on()

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.

### `locked` (~37 tokens)

true if the lock screen is showing Example: locked()

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.

### `wake` (~67 tokens)

Turn the screen on and dismiss a lock screen that has no PIN. Gestures fail while the screen is off. A PIN, pattern or password lock cannot be dismissed without the user. Example: wake()

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.

### `lock` (~36 tokens)

Turn the screen off and lock Example: lock()

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.

### `battery` (~41 tokens)

Battery level and charging state Example: battery()["level"] < 20

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.

### `orientation` (~38 tokens)

portrait or landscape Example: orientation() == "landscape"

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.

### `info` (~40 tokens)

Model, Android version, screen size and permission readiness Example: info()

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.

### `network` (~48 tokens)

Connection type (wifi, mobile, none) and airplane mode Example: network()["type"] == "wifi"

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.

### `launch` (~77 tokens)

Start an app, optionally at a specific activity Example: launch("com.kakao.talk")

Input parameters:

- `activity` (string): Activity name, either full or starting with a dot
- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `package` (string, required): Package name, for example com.android.chrome

### `open_url` (~72 tokens)

Open a URL or deep link Example: open_url("myapp://orders/42")

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `package` (string): Open with this app only
- `url` (string, required): http(s) URL or app deep link

### `intent` (~173 tokens)

Open a screen by its intent action, such as a Settings page. Opens any screen other apps are allowed to open, for example android.settings.WIFI_SETTINGS, or android.settings.APPLICATION_DETAILS_SETTINGS with data package:com.example. The screen opens fresh, closing other screens of the same app. What to tap after that differs by phone maker and language, so Wi-Fi, airplane mode, force stop and clearing data are recipes in the docs rather than commands. Example: intent("android.settings.WIFI_SETTINGS")

Input parameters:

- `action` (string, required): Intent action, such as android.settings.WIFI_SETTINGS
- `data` (string): Data URI, such as package:com.example
- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `package` (string): Only this app may handle it

### `clear_data` (~100 tokens)

Clear an app's data in device owner mode. Optional, and only in device owner mode, where the phone wipes the app directly without opening Settings. Without it the answer is NO_PERMISSION; the docs have a recipe that goes through Settings instead. Example: clear_data("com.android.chrome")

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `package` (string, required): Package name, for example com.android.chrome

### `apps` (~44 tokens)

Installed packages Example: apps()

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `system` (boolean): Include system packages Default false.

### `installed` (~60 tokens)

Version name if installed, empty string if not Example: installed("com.kakao.talk")

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `package` (string, required): Package name, for example com.android.chrome

### `back` (~31 tokens)

Back Example: back()

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.

### `home` (~32 tokens)

Home screen Example: home()

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.

### `recents` (~34 tokens)

Recent apps Example: recents()

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.

### `open_notifications` (~37 tokens)

Pull down the notification shade Example: open_notifications()

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.

### `quick_settings` (~35 tokens)

Open quick settings Example: quick_settings()

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.

### `clipboard` (~80 tokens)

Write the clipboard, or read it when called without text. Reading on Android 10+ needs the Droidline keyboard to be the current input method. Example: clipboard("복사할 글")

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `text` (string): Text to copy. Omit to read

### `batch` (~209 tokens)

Run several commands on the phone in one go, even while it is offline. Steps are [cmd, args...] lists or {cmd, ...} objects. The step sleep(ms) only exists inside batch. When the steps turn off the phone's network, for example Wi-Fi off and on again, pass cuts_network: the phone answers accepted first, runs the steps while offline, and the result arrives after it reconnects. Example: batch([("home",), ("sleep", 500), ("recents",)])

Input parameters:

- `cuts_network` (boolean): The steps drop the phone's link. Answer accepted first and send the result after reconnecting Default false.
- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `steps` (array, required): Commands to run in order
- `stop_on_error` (boolean): Stop at the first failing step Default true.
- `wait` (boolean): Wait for the final result after the phone reconnects instead of returning accepted.

### `chrome_go` (~71 tokens)

Open a URL in Chrome Example: chrome.go("naver.com")

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `new_tab` (boolean): Open in a new tab Default false.
- `url` (string, required): Address. https:// is added if missing

### `proxy` (~156 tokens)

Route chosen apps through an upstream proxy with a per-app VPN. Supports http:// (CONNECT) and socks5:// with user:pass. Pass null or "off" to stop. One upstream at a time. Apps that ignore the proxy setting lose network access instead of leaking. Example: proxy("socks5://user:pass@1.2.3.4:1080", app="com.android.chrome")

Input parameters:

- `app`: Package or packages to route
- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `url` (string|null, required): socks5://user:pass@host:port, http://host:port, a saved profile like @kr1, or off

### `proxy_check` (~60 tokens)

Per-app proxy state and the IP the outside world sees Example: proxy_check("com.android.chrome")["ip"]

Input parameters:

- `app` (string): Package to check
- `device` (string): Phone ID or name. Optional when exactly one phone is online.

### `notifications` (~43 tokens)

Notifications currently showing Example: notifications()

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `package` (string): Only this app

### `has_notification` (~82 tokens)

true if a showing notification matches Example: has_notification("textContains", "배송")

Input parameters:

- `by` (string, required): text and textContains look at both title and text
- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `value` (string): The value to match. Leave it out when by is a query object

### `wait_notification` (~172 tokens)

Wait for a matching notification and return it. Handled by the PC server, so it does not block other commands to the phone. It sees only apps you chose with notify_filter, and the default is none. On Android 15+ the OS hides one-time codes from apps: you get the notification but the code is masked. Example: wait_notification("textContains", "인증번호", 60)

Input parameters:

- `by` (string, required): text and textContains look at both title and text
- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `package` (string): Only from this app
- `timeout` (number): Seconds to wait Default 60.
- `value` (string): The value to match. Leave it out when by is a query object

### `notification_reply` (~73 tokens)

Reply inline to a notification that has a reply action Example: notification_reply(key, "확인했습니다")

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `key` (string, required): Notification key from notifications() or a notification event
- `text` (string, required): Reply text

### `notification_click` (~52 tokens)

Open a notification Example: notification_click(key)

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `key` (string, required): Notification key from notifications() or a notification event

### `notification_dismiss` (~55 tokens)

Dismiss a notification Example: notification_dismiss(key)

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `key` (string, required): Notification key from notifications() or a notification event

### `notify_filter` (~69 tokens)

Choose which apps' notifications are sent to the PC. Default is none Example: notify_filter(["com.kakao.talk"])

Input parameters:

- `device` (string): Phone ID or name. Optional when exactly one phone is online.
- `packages` (array): Allowed packages. Omit to read the current list

### `devices` (~19 tokens)

Paired devices with online state and route Example: devices()

## Diagnostics

Captured diagnostic sections: Provenance. The full working is on the page: https://verifymcp.io/servers/knifelemon-droidline/droidline#diagnostics

## Score history

- 2026-11-05: 52
- 2026-11-04: 52
- 2026-11-03: 52
- 2026-11-02: 51
- 2026-11-01: 51
- 2026-10-31: 50
- 2026-10-30: 50
- 2026-10-29: 49
- 2026-10-28: 49
- 2026-10-27: 48
- 2026-10-26: 48
- 2026-10-25: 47
- 2026-10-24: 47
- 2026-10-23: 46
- 2026-10-22: 46
- 2026-10-21: 42
- 2026-10-20: 42
- 2026-10-19: 42
- 2026-10-18: 42
- 2026-10-17: 42
- 2026-10-16: 42
- 2026-10-15: 42
- 2026-10-14: 42
- 2026-10-13: 10
- 2026-10-12: 10
- 2026-10-11: 10

## Common questions

### What is the Droidline MCP server?

Droidline is an MCP server listed in the public MCP registry as io.github.KnifeLemon/droidline. Let an AI agent see and use a real Android phone over Wi-Fi, without ADB or root. This page covers its MCPB bundle (https://github.com/KnifeLemon/Droidline/releases/download/v0.1.13/droidline.mcpb).

### Is the Droidline MCP server safe to use?

Droidline scores 52 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Droidline MCP server expose?

Droidline exposes 68 tools: dump, screenshot, find_image, tap_image, image_exists, and 63 more. Their descriptions and schemas cost roughly 7,318 tokens of context every time the server is loaded.

### What licence is the Droidline MCP server under?

Droidline declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- Repository: https://github.com/KnifeLemon/Droidline
- Website: https://droidline.dev/docs/ai-agents/
- Changelog RSS feed: https://verifymcp.io/servers/knifelemon-droidline/droidline.xml
- Changelog JSON feed: https://verifymcp.io/servers/knifelemon-droidline/droidline.json
- HTML version of this page: https://verifymcp.io/servers/knifelemon-droidline/droidline
