Skip to main content
Version: 0.25.0

MCP-025: Non-boolean alwaysLoad in MCP Server Config - MCP

Summary​

  • Rule ID: MCP-025
  • Severity: MEDIUM
  • Category: MCP
  • Normative Level: MUST
  • Auto-Fix: No
  • Verified On: 2026-04-28

Applicability​

  • Tool: claude-code
  • Version Range: >=2.1.121
  • Spec Revision: unspecified

Evidence Sources​

Test Coverage Metadata​

  • Unit tests: true
  • Fixture tests: true
  • E2E tests: false

Examples​

The following examples demonstrate what triggers this rule and how to fix it.

Invalid​

{
  "mcpServers": {
    "fs": {
      "type": "stdio",
      "command": "node",
      "alwaysLoad": "true"
    }
  }
}

Valid​

{
  "mcpServers": {
    "fs": {
      "type": "stdio",
      "command": "node",
      "alwaysLoad": true
    }
  }
}