Popup

Provides an interactive native window for user input and confirmations to support AI agents in safe, human-in-the-loop workflows.

typescript

4

GitHub Stars

typescript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "chietears-popup-mcp": {
      "command": "C:\\\\path\\\\to\\\\popup-mcp.exe",
      "args": []
    }
  }
}

Popup MCP enables your AI Agent to interact with you through a native window, providing real-time human feedback for sensitive operations or parameter gathering. It combines a native-like experience with an interactive questionnaire and secure confirmations, making agent workflows safer and more efficient.

How to use

You use this MCP server by connecting an MCP client to a local or remote popup session. When the agent needs human input, it opens a native window to present questions, confirmations, or risk prompts. The window supports keyboard shortcuts, bilingual UI, and can be topic-tagged to show which agent initiated it.

How to install

Prerequisites: Node.js v18 or newer, Rust toolchain, and pnpm. You will also need network access to retrieve binaries during the initial setup.

Step 1: Download the binary for your platform from the release bundle. You will typically get an archive that contains the executable.

Step 2: Unpack the downloaded archive to a directory you choose.

Step 3: Ensure the executable has permission to run on macOS/Linux.

Step 4: Determine the absolute path to the executable. You will reference this path in your MCP client configuration.

Configuration and usage notes

Configure the MCP client to point to the popup MCP server. The examples below show common client configurations.

Windows example: the client references the Windows path to the popup executable.

Powerful features you get with Popup MCP

Interactive questionnaire support lets you ask single/multi-select questions or request open-ended input. You can cancel, and users can attach extra context on submission.

Secure confirmations are available for sensitive actions, with customizable confirm/cancel text and a danger indicator to warn users.

Native experience includes keyboard shortcuts and cross-platform support for Windows, macOS, and Linux, with UI language switching between Chinese and English.

Startup parameters and tips

You can customize behavior by passing CLI-like arguments to the popup at launch time. Options include forcing UI language, setting a maximum time for user interaction, and overriding the header text displayed in the window.

WSL and proxy guidance

If you are using Windows Subsystem for Linux (WSL) to run the MCP client, route the GUI via a proxy. Start the proxy on Windows and then configure the WSL client to connect to the proxy URL.

Available tools

ask_user_question

Interactively gather user input through structured questions, with support for single-choice, multiple-choice, and open-ended responses. Allows cancellation and optional extra context on submit.

confirm_action

Present a confirmation dialog for sensitive actions with customizable labels, a danger indicator, and a default option.