Fixes › Claude Desktop, Claude Code, Cursor

"MCP error -32001: Request timed out"

Claude DesktopClaude CodeCursor

The error

McpError: MCP error -32001: Request timed out

Why it happens

The client gave up waiting. On first run, npx/uvx may still be downloading the package. Slow tools (browser automation, big crawls) can also go over the default timeout.

How to fix it

  1. Pre-install the package
    Run the command once in a terminal so the download is cached.
    npx -y @playwright/mcp@latest --help
  2. Raise the timeout (Claude Code)
    Claude Code reads MCP_TIMEOUT (startup) and MAX_MCP_OUTPUT_TOKENS.
    MCP_TIMEOUT=30000 claude
  3. Pin a version
    Using @latest makes npx check the registry every launch. Pinning a version avoids that.

Related servers

Sources