Documentation Index
Fetch the complete documentation index at: https://mintlify.com/davidpastorvicente/mcpx-cli/llms.txt
Use this file to discover all available pages before exploring further.
mcpx enable and mcpx disable flip the enabled boolean on a server entry in your canonical config without deleting any configuration data. When a server is disabled, it is omitted from every generated provider config file on the next sync. Re-enabling it restores it to all providers immediately. Both commands sync provider files automatically after toggling.
mcpx enable
mcpx enable sets a server’s enabled flag to true in .agents/mcp.json and syncs all configured providers.
mcpx enable <name> [--dir <path>] [--verbose]
Arguments
| Argument | Required | Description |
|---|
<name> | Yes | The exact name of the server to enable. |
Example
mcpx disable
mcpx disable sets a server’s enabled flag to false in .agents/mcp.json and syncs all configured providers, causing the server to be removed from every generated provider config file.
mcpx disable <name> [--dir <path>] [--verbose]
Arguments
| Argument | Required | Description |
|---|
<name> | Yes | The exact name of the server to disable. |
Example
The enabled field
The enabled field is stored directly in the server object inside .agents/mcp.json. When set to false, MCPX treats the server as inactive during sync — it is excluded from every provider config file that gets written. All other fields (transport, command, args, env) are preserved unchanged:
{
"servers": {
"github": {
"enabled": false,
"transport": "stdio",
"command": "npx",
"args": ["-y", "@anthropic-ai/mcp-github-server"]
}
}
}
enabled back to true (via mcpx enable) restores the server to all provider configs on the next sync.
Error cases
| Situation | What MCPX does |
|---|
No .agents/mcp.json found | Prints a warning and directs you to run mcpx init |
| Server name not found in config | Prints an error and exits without making changes |
| No server name provided | Prints an error asking for a server name |
Prefer mcpx disable over mcpx remove whenever you want to temporarily stop using a server. Disabling preserves the full server definition — command, arguments, environment variables — so you can turn it back on with a single mcpx enable command without re-entering any settings.
