Mcp Await
Built in Rust, this server gives Claude a set of blocking wait primitives so it stops burning tokens on retry loops and sleep polling. You get seven tools: wait_for_port for TCP readiness checks, wait_for_file with inotify-backed filesystem events, wait_for_url for HTTP health endpoints, wait_for_pid and wait_for_docker for process lifecycle, wait_for_gh_run for Actions workflows, and wait_for_command for arbitrary shell predicates. All tools support configurable timeouts and can run in non-blocking mode with cancellation, pushing MCP resource notifications when conditions resolve. Ships as both an MCP server and a standalone CLI with the same wait semantics.
- GitHub stars
- 1
- tools
- 8
- transport
- STDIO
- last updated
- Mar 8, 2026
Tools
8 toolsPublic tool metadata for what this MCP can expose to an agent.
wait_for_portTCP dial loop, 500ms interval
TCP dial loop, 500ms interval
No parameter schema in public metadata yet.
wait_for_fileinotify via notify crate, no polling
inotify via notify crate, no polling
No parameter schema in public metadata yet.
wait_for_urlcurl loop, 2s interval (requires curl)
curl loop, 2s interval (requires curl)
No parameter schema in public metadata yet.
wait_for_pid/proc/{pid} check, 500ms interval
/proc/{pid} check, 500ms interval
No parameter schema in public metadata yet.
wait_for_dockerdocker wait (requires docker)
docker wait (requires docker)
No parameter schema in public metadata yet.
wait_for_gh_rungh run watch (requires gh)
gh run watch (requires gh)
No parameter schema in public metadata yet.
wait_for_commandRe-run via sh -c until exit 0
Re-run via sh -c until exit 0
No parameter schema in public metadata yet.
cancel_watchCancels a non-blocking watch
Cancels a non-blocking watch
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
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.
demo
Installation
# Prebuilt binary (Linux, macOS, Windows) — download from GitHub Releases
# https://github.com/ricardo-hdrn/mcp-await/releases/latest
# From crates.io
cargo install mcp-await
# From source
git clone https://github.com/ricardo-hdrn/mcp-await.git
cd mcp-await
cargo build --release
Quick Start
# Wait for a service to be ready
mcp-await port localhost 8080 --timeout 30
# Wait for a file to appear
mcp-await file /tmp/deploy.lock --event create --timeout 60
Details
- Repository
- github.com/ricardo-hdrn/mcp-await
- Package
mcp-await- Transport
- STDIO
- Registry
- MCP registry, active