Mcp Await
About
Condition watcher for AI assistants — wait for ports, files, URLs, processes, and more
Details
- Author
- ricardo-hdrn
- Downloads
- 335
- Categories
- Other, Developer Tools, Automation, Infrastructure, File Management
Jump to
- Wait for TCP ports to accept connections.
- Watch file events (create, modify, delete) using inotify.
- Wait for HTTP URLs to return an expected status code.
- Wait for processes to exit via PID.
- Wait for Docker containers to exit.
- Supports blocking and non-blocking watch modes.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Mcp AwaitCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install via cargo install mcp-await or download a prebuilt binary from GitHub Releases. Run as a CLI with subcommands like mcp-await port localhost 8080 --timeout 30 or as a stdio MCP server by invoking the binary without a subcommand (or with mcp-await serve). Configure it in Claude Code by adding the binary path to ~/.claude.json under mcpServers.
cancel_watch
Cancel an active non-blocking watch by its watch_id.
wait_for_command
Wait until a shell command exits with code 0. Re-runs at the specified interval. Use blocking: false for async notification.
wait_for_docker
Wait until a Docker container exits. Runs `docker wait` under the hood (requires docker installed). Use blocking: false for async notification.
wait_for_file
Wait until a filesystem event (create, modify, or delete) occurs on a path. Uses OS-native file watching (inotify). Use blocking: false for async notification.
wait_for_gh_run
Wait until a GitHub Actions workflow run completes. Runs `gh run watch` under the hood (requires gh CLI installed). Use blocking: false for async notification.
wait_for_pid
Wait until a process exits. Monitors /proc/<pid> on Linux. Use blocking: false for async notification.
wait_for_port
Wait until a TCP port accepts connections. Use blocking: false to return immediately and get notified via resource update.
wait_for_url
Wait until a URL returns an expected HTTP status code. Polls with curl every 2s (requires curl installed). Use blocking: false for async notification.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp await": {
"await": {
"command": "npx",
"args": [
"-y",
"mcp-await"
]
}
}
}
}McpServers
{
"await": {
"command": "npx",
"args": [
"-y",
"mcp-await"
]
}
}mcp-await
Condition watcher MCP server + CLI for AI CLI assistants (Claude Code, Codex, Cursor, etc.).
Instead of polling with sleep loops and curl --retry that waste API round-trips, call a wait tool once — it blocks until the condition is met and returns the result.
Installation
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
