mcp-wait

An MCP server that provides a wait tool for AI agents to pause execution until a time duration elapses or a process terminates. Useful for polling scenarios, waiting for builds, deployments, etc.

Installation

npm install && npm run build

Usage with MCP Clients

Add to your MCP client configuration (e.g., Claude Desktop, Claude Code):

{
  "mcpServers": {
    "wait": {
      "command": "npx",
      "args": ["-y", "github:AaLexUser/mcp-wait"]
    }
  }
}

Tool: wait

Arguments (at least one required):

Argument	Type	Description
seconds	number	Seconds to wait
pid	number	Process ID to monitor until exit

Behavior:

• Only seconds → wait N seconds
• Only pid → wait until process exits
• Both → wait until first condition is met

Returns: A message indicating why waiting stopped and how long was waited.

Examples

• Wait 5 seconds: { "seconds": 5 }
• Wait for process 1234: { "pid": 1234 }
• Wait up to 30 seconds for process 1234: { "seconds": 30, "pid": 1234 }

Development

npm run build    # Compile TypeScript
npm run lint     # Run ESLint
npm run format   # Format with Prettier
npm run check    # Lint + format check

License

MIT