Skip to content
BENIBIX Learn

MCP_TIMEOUT

AI⌨️ Claude CodeConfiguration

Also known as MCP_TIMEOUT environment variable

It sets how long Claude Code waits for an MCP server to start.

Think of it like

It is like you wait for a friend to show up. Then you start the game.

Example

Lucy's MCP server downloads a model when it starts and takes 45 seconds. She sets the wait to a minute, and its tools show up.

Why it matters

A slow server that misses the wait looks broken, even though it works.

Definition

MCP_TIMEOUT sets how long Claude Code waits for an MCP server to start. The value is in milliseconds. The default is 30,000, which is 30 seconds. A server that takes longer is not ready when the session begins.

Example code

bash
export MCP_TIMEOUT=60000
claude
Give slow servers a minute to start.

Common mistake

Mixing it up with MCP_TOOL_TIMEOUT. This one is for starting, not for a tool call.

Key takeaways

  1. 1
    Server start. Not tool calls.
  2. 2
    Default 30 seconds. 30,000.
  3. 3
    Milliseconds. Not seconds.

Compare