agentfenster-mcp
agentfenster-mcp is the launcher for the agentfenster MCP server. The server
lets Claude Code and other MCP clients drive real Windows applications on a
hidden second desktop inside your own session — with the same logins, cookies
and VPN — while your screen, mouse and keyboard stay yours.
Every action is verified against the window state afterwards. A click that lands nowhere is reported as a failure, never as a silent success.
Full documentation: https://agentfenster.com/mcp
mcp-name: com.agentfenster/agentfenster
What this package is, and what it is not
This package contains no product code. It is the small public launcher that makes the documented one-liner work:
claude mcp add agentfenster -- agentfenster-mcp
The MCP server itself ships with the agentfenster app, a commercial, closed-source Windows program distributed from https://agentfenster.com.
- If the app is installed,
agentfenster-mcphands over to the real server and gets out of the way. - If it is not,
agentfenster-mcpprints what is missing and how to fix it, then exits with status 1 — instead of leaving your MCP client with a barecommand not found.
Installing this package alone does not give you the server.
Install
-
Install agentfenster on Windows 10 or 11 from https://agentfenster.com. The MCP server is part of the app. Every plan starts with a 3-day trial, no card and no account required.
-
Register the server with Claude Code:
claude mcp add agentfenster -- agentfenster-mcpAny MCP client that can launch a local stdio server works the same way.
Then just ask:
> open the character map on the agent desktop and turn on the advanced view
The 11 tools
| Tool | What it does |
|---|---|
list_windows |
Lists the windows this machine can drive, with title, class, minimized state and whether a picture can be captured. |
desktop_task |
Runs a full GUI task in one window and returns a single paragraph: what happened, whether it worked, and if not, which step failed and why. |
inspect_window |
Returns the capped, filtered element tree of one window as a compact list, for planning clicks yourself. |
replay |
Lists recent runs, or returns one run's step-by-step log, with a link to the visual replay in the app. |
open_app |
Launches a program on the shared agent desktop and reports its first titled window. |
read_desktop |
Reads the compact element tree of a window on the agent desktop, one line per interactive element, no screenshot. |
click |
Clicks one element, then verifies against the desktop state and states explicitly whether anything changed. |
type_text |
Types text into one element on the agent desktop, then verifies whether anything changed. |
press_key |
Presses a key or combination such as ctrl+s, enter, tab or alt+f4, with verification afterwards. |
scroll |
Scrolls a window or pane and reports whether the content actually moved. |
agent_windows |
Lists the windows currently open on the shared agent desktop, frontmost first. |
How it works
- The agent works on a second Win32 desktop inside your session. It never takes your foreground, mouse or keyboard, and you can watch it live in the app.
- Tools read the UI Automation element tree instead of screenshots: one line per interactive element, capped at 200 elements per window.
- The click loop of
desktop_taskruns inside the server on a model endpoint you configure, so its retries never enter your context. - Risky actions such as delete, send, pay or install are denied by default on MCP calls and reported, instead of blocking on a confirmation nobody can answer.
- agentfenster sends no telemetry. The only network traffic is the model endpoint you configure for the click loop.
Requirements
| Aspect | Details |
|---|---|
| Platform | Windows 10 or 11 |
| Transport | stdio, local |
| Runtime | Python 3.11 or newer |
| Prerequisite | the agentfenster app (commercial, 3-day trial) |
Links
- Product and download: https://agentfenster.com
- MCP documentation: https://agentfenster.com/mcp
- Pricing: https://agentfenster.com/#pricing
- Documentation and issue tracker: https://github.com/clemensjl/agentfenster-mcp
- Discord: https://discord.gg/J9MfKP255Y
- Support: hello@agentfenster.com
- Privacy: https://agentfenster.com/privacy
- Terms: https://agentfenster.com/terms
Rights
agentfenster is commercial, closed-source software. No open-source license is granted here. This launcher package is published so that the documented install command works and so that MCP directories can resolve it. Use of the agentfenster app itself is governed by the terms at https://agentfenster.com/terms.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file agentfenster_mcp-0.1.0.tar.gz.
File metadata
- Download URL: agentfenster_mcp-0.1.0.tar.gz
- Upload date:
- Size: 6.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/7.0.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
13c77ab39cd41e8ac19cdbfba3b763e9afb947332b8b7144a7fd72843ecb0e20
|
|
| MD5 |
bb31f398fcf2b9499e94e2d21e0f1e3e
|
|
| BLAKE2b-256 |
5c29cd8b436ec5892683530116aba7cc0c5ffa92e994416f559c8a1c83a7bad3
|
File details
Details for the file agentfenster_mcp-0.1.0-py3-none-any.whl.
File metadata
- Download URL: agentfenster_mcp-0.1.0-py3-none-any.whl
- Upload date:
- Size: 6.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/7.0.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
becbee3bb04b3d3b1affe2b574fd06bfc901e27dd83ece5c627f605b3a30af2c
|
|
| MD5 |
90c30a1b3a1a2ee663e4a8b4e43f3135
|
|
| BLAKE2b-256 |
1e53b8de00d5a1622c4996cdce96d5ebdb0119af1bf2307c23107f35a49d565f
|
