agent-desktop (official)

Before you use agent-desktop (official)

70/100

Capped at 70: core tools not tested (only setup or self-check calls passed); the tests add up to 100. Why scores are capped

Last tested 2026-11-09 (Fresh: tested within 30 days) Connects · tools listedNo tool call tested yet No key to connect

No advisories in range for tested 1.2.0 (checked 2026-11-09)

Security review: not tested

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 — unclassified
  • desktop_check — unclassified
  • desktop_clear — write (state-changing)
  • desktop_click — unclassified
  • desktop_clipboard_clear — write (state-changing)
  • desktop_clipboard_get — read
  • desktop_clipboard_set — write (state-changing)
  • desktop_close_app — unclassified
  • desktop_collapse — unclassified
  • desktop_cursor_overlay_disable — write (state-changing)
  • desktop_cursor_overlay_enable — write (state-changing)
  • desktop_dismiss_all_notifications — unclassified
  • desktop_dismiss_notification — unclassified
  • desktop_double_click — unclassified
  • desktop_drag — unclassified
  • desktop_expand — unclassified
  • desktop_find — read
  • desktop_focus — unclassified
  • desktop_focus_window — unclassified
  • desktop_get — read
  • desktop_hover — unclassified
  • desktop_is — unclassified
  • desktop_key_down — unclassified
  • desktop_key_up — unclassified
  • desktop_launch — unclassified
  • desktop_list_apps — read
  • desktop_list_displays — read
  • desktop_list_notifications — read
  • desktop_list_surfaces — read
  • desktop_list_windows — read
  • desktop_maximize — unclassified
  • desktop_minimize — unclassified
  • desktop_mouse_click — unclassified
  • desktop_mouse_down — unclassified
  • desktop_mouse_move — write (state-changing)
  • desktop_mouse_up — unclassified
  • desktop_mouse_wheel — unclassified
  • desktop_move_window — write (state-changing)
  • desktop_notification_action — unclassified
  • desktop_open_system_surface — unclassified
  • desktop_permissions — unclassified
  • desktop_press — unclassified
  • desktop_resize_window — unclassified
  • desktop_restore — unclassified
  • desktop_right_click — unclassified
  • desktop_screenshot — unclassified
  • desktop_scroll — unclassified
  • desktop_scroll_to — unclassified
  • desktop_select — unclassified
  • desktop_session_end — unclassified
  • desktop_session_gc — write (state-changing)
  • desktop_session_list — read
  • desktop_session_start — write (state-changing)
  • desktop_set_value — write (state-changing)
  • desktop_skills_get — read
  • desktop_skills_list — read
  • desktop_skills_path — unclassified
  • desktop_snapshot — unclassified
  • desktop_status — read
  • desktop_toggle — unclassified
  • desktop_trace_export — unclassified
  • desktop_trace_show — read
  • desktop_triple_click — unclassified
  • desktop_type — write (state-changing)
  • desktop_uncheck — unclassified
  • desktop_version — unclassified
  • desktop_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

TestResultPointsEvidence
installpass20npm install agent-desktop (Node 20, Linux) succeeded in 1s.
handshakepass30MCP initialize + tools/list over stdio succeeded with no credentials; 67 tools listed in 0.7s.
maintenancepass25Repo pushed 0 days before test; 19,762 GitHub stars.
docspass15README over 3,000 chars; install instructions present; mcpServers config example present. Check of the package's own README (README shipped in npm package).
licensepass10Apache-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 initialize then tools/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.

Feeds: RSS · JSON.

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

  1. Install. Run npm install agent-desktop (Node 20). This is the exact command we ran on 2026-11-09.
  2. Configure. Add the mcpServers entry below to your MCP client config.
  3. 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

Follow this server (RSS) · Monthly changelog

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

TestedMCP: 70/100, tested 2026-11-09

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.

Claim this listing · Report an issue