Sleep MCP Server

Sleep MCP Server is an MCP server that pauses the execution of an AI agent for a user-specified duration to control process flow. Designed for developers, automation engineers, and workflow designers, this server introduces timed delays between sequential actions in agentic systems. It exposes a simple utility tool that takes a requested pause duration in seconds and waits before returning control to the client. The server supports an optional maximum timeout threshold configured via environment variables, ensuring that an agent cannot block or halt indefinitely. By functioning as a dedicated waiting mechanism, it enables LLM agents to handle scenarios where external systems require settling time, rate-limiting windows must be respected, or background jobs need polling intervals. It connects to MCP clients like Claude Desktop over standard input and output or Server-Sent Events, and it can run directly via Python tools or containerized environments. By enforcing deterministic pauses, Sleep MCP Server provides structured pacing without requiring custom scripts or complex external scheduling logic inside the agent prompt.

Category: Other & General Purpose

Tags: automation, delay, utility, workflow

Visit Sleep MCP Server

How to install and configure Sleep MCP Server

1. Ensure uv is installed on your system. 2. Open your Claude Desktop configuration file (claude_desktop_config.json). 3. Add the server under mcpServers using uvx: json { "mcpServers": { "mcp-sleep": { "command": "uvx", "args": [ "mcp-sleep" ], "env": { "MCP_SLEEP_TIMEOUT": "60" } } } } 4. Optionally adjust MCP_SLEEP_TIMEOUT to specify the maximum allowable wait time in seconds. 5. Restart Claude Desktop to enable the sleep tool.

What you can do with Sleep MCP Server

• Pausing between successive external API requests to avoid triggering provider rate limits during automated batch operations. - Waiting for background processes, asynchronous builds, or server deployments to complete before triggering automated validation checks. - Introducing deliberate delays between polling operations when checking database records or status endpoints for eventual consistency. - Staggering sequential tool calls in multi-step workflows to ensure external resources have stabilized before the next execution step.

Key facts

• https://github.com/AgentsWorkingTogether/mcp-sleep
• Other & General Purpose
• automation, delay, utility, workflow

Part of MCP Servers

What can Sleep MCP Server do?

Sleep MCP Server provides a sleep tool that pauses agent execution for a specified number of seconds. It helps manage workflow pacing, letting agents wait between dependent actions, adhere to API rate limits, or pause while external background operations finish. An optional maximum timeout setting prevents agents from waiting indefinitely.

How do I install Sleep MCP Server?

You can configure Sleep MCP Server in Claude Desktop by adding uvx mcp-sleep under the mcpServers configuration object in your claude_desktop_config.json file. It can also be installed using package managers like Smithery or mcp-get, run via Docker, or executed locally using uv. After editing the configuration, restart Claude Desktop.

Which MCP clients work with Sleep MCP Server?

Sleep MCP Server works with any client that implements the Model Context Protocol, including Claude Desktop. It supports standard input and output communication by default and can also run in Server-Sent Events mode using the transport sse flag, allowing integration with web applications or remote MCP client setups.

How do I set the maximum wait time in Sleep MCP Server?

You can configure the maximum allowed wait time by setting the MCP_SLEEP_TIMEOUT environment variable in your client configuration or environment file. The default threshold is 60 seconds. If an agent attempts to call the sleep tool with a duration greater than this value, the server rejects the request with an explanatory message.