agent mcp disable <identifier>

Disables an MCP server so it stops loading or prompting for approval.

agent mcp disable <identifier> fully disables a configured MCP server; it will neither load nor prompt for approval going forward.

✅ WHEN TO USE IT?

Turn off a broken or unneeded MCP server

agent mcp disable old-server

⛔ WHEN NOT TO?

The server should only be ignored briefly for one run

agent mcp disable is a persistent, server-scoped setting.

Better: Simply don't invoke that server in the relevant prompt, or adjust a project-specific mcp.json

SOURCES