agent-desktop (official)
Before you use agent-desktop (official)
- Only 3 tools passed in our test (version, status, skills_list). Desktop-driving tools and list_displays have not been tested (they need a display server / desktop session).
Capped at 70: core tools not tested (only setup or self-check calls passed); the tests add up to 100. Why scores are capped
Test points add up to 100; the score is capped at 70 until a tool call passes. Not a quality or security rating. Methodology
Test points before the cap (100/100)
- Install20/20
- Handshake30/30
- Maintenance25/25
- Docs15/15
- License10/10
Tested npm agent-desktop 1.2.0 (Apache-2.0; repo vercel-labs/agent-desktop, 19,762 GitHub stars when tested; npm maintainers include vercel-release-bot). Installed with install scripts off (our default), so the native binary was not linked and the package's Node launcher ran instead (it says so on stderr). `agent-desktop mcp` over stdio: initialize and tools/list succeeded with no credentials and listed 67 tools (desktop_snapshot/click/type/launch/windows/clipboard/notifications/sessions/traces...). Real calls (no LLM, no credentials, Linux x86_64, no display server and no D-Bus session in our test environment): desktop_version returned os linux / version 1.2.0; desktop_status returned a permissions report (accessibility denied: no D-Bus session bus); desktop_skills_list returned the bundled skills index. desktop_list_displays returned isError PLATFORM_NOT_SUPPORTED (no display server configured). Desktop-driving tools (snapshot, click, type, launch) were not called — they need a desktop session with AT-SPI. Our 2026-11-02 sweep skipped agent-desktop 1.0.2 because its README showed no MCP server; 1.2.0 adds `agent-desktop mcp`. Not listed on Glama when tested. Score capped at 70 (setup and self-check calls do not count as a tested tool): only desktop_version, desktop_status and desktop_skills_list passed; core tools not tested (desktop-driving tools need a desktop session with AT-SPI).
Tool-call test (2026-11-09, direct MCP stdio client, no LLM): pass. 3 of 4 read-only calls passed. Desktop-driving tools not called (need a desktop session with AT-SPI). Evidence: local test run, Nov 9, 2026.
Transport (tested 2026-11-09): stdio
Tested version: 1.2.0 · tested 2026-11-09
Token cost (estimate): approx. 7976 tokens, cl100k estimate (67 tools, measured 2026-11-11, version 1.2.0). This is an estimate from our testing of the tool names, descriptions and input schemas, counted with cl100k_base.
Permissions: 13 read, 11 write (state-changing), 43 unclassified · Auth: none · Rate limit: unknown · Pricing unit: unknown
Auth: none. Rate limit: unknown. Pricing unit: unknown.
desktop_batch— unclassifieddesktop_check— unclassifieddesktop_clear— write (state-changing)desktop_click— unclassifieddesktop_clipboard_clear— write (state-changing)desktop_clipboard_get— readdesktop_clipboard_set— write (state-changing)desktop_close_app— unclassifieddesktop_collapse— unclassifieddesktop_cursor_overlay_disable— write (state-changing)desktop_cursor_overlay_enable— write (state-changing)desktop_dismiss_all_notifications— unclassifieddesktop_dismiss_notification— unclassifieddesktop_double_click— unclassifieddesktop_drag— unclassifieddesktop_expand— unclassifieddesktop_find— readdesktop_focus— unclassifieddesktop_focus_window— unclassifieddesktop_get— readdesktop_hover— unclassifieddesktop_is— unclassifieddesktop_key_down— unclassifieddesktop_key_up— unclassifieddesktop_launch— unclassifieddesktop_list_apps— readdesktop_list_displays— readdesktop_list_notifications— readdesktop_list_surfaces— readdesktop_list_windows— readdesktop_maximize— unclassifieddesktop_minimize— unclassifieddesktop_mouse_click— unclassifieddesktop_mouse_down— unclassifieddesktop_mouse_move— write (state-changing)desktop_mouse_up— unclassifieddesktop_mouse_wheel— unclassifieddesktop_move_window— write (state-changing)desktop_notification_action— unclassifieddesktop_open_system_surface— unclassifieddesktop_permissions— unclassifieddesktop_press— unclassifieddesktop_resize_window— unclassifieddesktop_restore— unclassifieddesktop_right_click— unclassifieddesktop_screenshot— unclassifieddesktop_scroll— unclassifieddesktop_scroll_to— unclassifieddesktop_select— unclassifieddesktop_session_end— unclassifieddesktop_session_gc— write (state-changing)desktop_session_list— readdesktop_session_start— write (state-changing)desktop_set_value— write (state-changing)desktop_skills_get— readdesktop_skills_list— readdesktop_skills_path— unclassifieddesktop_snapshot— unclassifieddesktop_status— readdesktop_toggle— unclassifieddesktop_trace_export— unclassifieddesktop_trace_show— readdesktop_triple_click— unclassifieddesktop_type— write (state-changing)desktop_uncheck— unclassifieddesktop_version— unclassifieddesktop_wait— unclassified
handshake and tools listed without a recorded key or OAuth
Score 70/100 · Tools 67 · Token cost approx. 7,976 tokens · Compare · Last tested 2026-11-09 · Version tested 1.2.0 · Package agent-desktop · Repo vercel-labs/agent-desktop
Summary: agent-desktop (official) completed an MCP handshake without credentials and exposed 67 tools.
Evidence summary
- Handshake
- pass
- Tools listed
- 67
- Context cost
- approx. 7976 tokens, cl100k estimate (67 tools, measured 2026-11-11, version 1.2.0; an estimate) ranking · add up your servers' context cost
- API key
- No key to connect (handshake passed)
- Tested
- 2026-11-09
Test results
| Test | Result | Points | Evidence |
|---|---|---|---|
| install | pass | 20 | npm install agent-desktop (Node 20, Linux) succeeded in 1s. |
| handshake | pass | 30 | MCP initialize + tools/list over stdio succeeded with no credentials; 67 tools listed in 0.7s. |
| maintenance | pass | 25 | Repo pushed 0 days before test; 19,762 GitHub stars. |
| docs | pass | 15 | README over 3,000 chars; install instructions present; mcpServers config example present. Check of the package's own README (README shipped in npm package). |
| license | pass | 10 | Apache-2.0 (OSI-approved). |
Local-model readiness
Token cost (estimate): approx. 7976 tokens, cl100k estimate for 67 tools · about 97% of an 8k context. This is an estimate from our testing (counted with cl100k_base).
Small-model friendly (schema heuristic, not a model result): unknown.
Not tested
Small-model task runs: Not yet tested.
What we tested and what we didn't
Tested on 2026-11-09
- Install from the registry
- We connected with no credentials and asked for its tool list: it listed 67 tools (Method details: MCP
initializethentools/list) - Maintenance signals (last push, archived/deprecated status)
- Docs (README length, install and config example)
- License (OSI-approved or not)
- Token cost (estimate)
Not tested
- Security: not audited (no code review, no permission or data-flow analysis)
- Real tasks (no functional task runs yet)
- Behaviour with real credentials or a real account
- Performance, rate limits or load
- Correctness of results beyond the listed tasks
Methodology: how we test. A high score means it installs and responds, not that giving it access to your data carries no risk.
Known security issues
Checked on 2026-11-09 for version 1.2.0 against OSV, GitHub advisories, GitHub repository advisories. Scope: the package itself; dependencies not scanned.
No published advisories found in OSV and GitHub advisories for agent-desktop 1.2.0 as of 2026-11-09. This is not a security audit.
Monthly roundup: MCP security issues, October 2026.
Tool list changes
Unchanged since the previous snapshot (latest 2026-11-11).
Snapshot hash (fingerprint of the tool list)
e0c1d2b7054e: SHA-256 of the canonical tool names, descriptions and input schemas. If it changes, the tool list changed.
Raw test record (JSON)
{
"name": "agent-desktop",
"version": "1.2.0",
"registry": "npm",
"status": "working",
"tested": "2026-11-09",
"tools_count": 67,
"deprecated": false,
"archived": false,
"tests": {
"install": [
"pass",
20,
"`npm install agent-desktop` (Node 20, Linux) succeeded in 1s."
],
"handshake": [
"pass",
30,
"MCP `initialize` + `tools/list` over stdio succeeded with no credentials; 67 tools listed in 0.7s."
],
"maintenance": [
"pass",
25,
"Repo pushed 0 days before test; 19,762 GitHub stars."
],
"docs": [
"pass",
15,
"README over 3,000 chars; install instructions present; `mcpServers` config example present. Check of the package's own README (README shipped in npm package)."
],
"license": [
"pass",
10,
"Apache-2.0 (OSI-approved)."
]
}
}Install
npx -y agent-desktop mcp
Pin the version we tested
npx -y agent-desktop@1.2.0 mcp
tested 2026-11-09. Newer versions may differ and were not tested by us.
{
"mcpServers": {
"agent-desktop": {
"command": "npx",
"args": [
"-y",
"agent-desktop@1.2.0",
"mcp"
]
}
}
}Tools listed
desktop_batch, desktop_check, desktop_clear, desktop_click, desktop_clipboard_clear, desktop_clipboard_get, desktop_clipboard_set, desktop_close_app, desktop_collapse, desktop_cursor_overlay_disable, desktop_cursor_overlay_enable, desktop_dismiss_all_notifications, desktop_dismiss_notification, desktop_double_click, desktop_drag, desktop_expand, desktop_find, desktop_focus, desktop_focus_window, desktop_get, desktop_hover, desktop_is, desktop_key_down, desktop_key_up, desktop_launch, desktop_list_apps, desktop_list_displays, desktop_list_notifications, desktop_list_surfaces, desktop_list_windows, desktop_maximize, desktop_minimize, desktop_mouse_click, desktop_mouse_down, desktop_mouse_move, desktop_mouse_up, desktop_mouse_wheel, desktop_move_window, desktop_notification_action, desktop_open_system_surface
Tool history: captured Nov 11, 2026. All tool history.
Quick config
{
"mcpServers": {
"agent-desktop": {
"command": "npx",
"args": [
"-y",
"agent-desktop",
"mcp"
]
}
}
}Add to config Opens the config generator with this server selected.
Setup
- Install. Run
npm install agent-desktop(Node 20). This is the exact command we ran on 2026-11-09. - Configure. Add the mcpServers entry below to your MCP client config.
- Verify. Restart the client and check that tools/list returns tools (67 in our test).
{
"mcpServers": {
"agent-desktop": {
"command": "npx",
"args": [
"-y",
"agent-desktop",
"mcp"
]
}
}
}Test history
- 2026-11-09: New
FAQ
Is agent-desktop deprecated?
No. agent-desktop was not deprecated or archived when we last tested it on 2026-11-09.
What replaces agent-desktop?
Nothing; agent-desktop (official) is not deprecated as of 2026-11-09.
Does agent-desktop need an API key?
No. It completed an MCP handshake with no credentials and listed 67 tools.
Embed the badge
Every tested server gets a free embeddable badge. It shows the current score and test date and expires after 90 days. Testing is free; payment never changes a score.