Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/neon-solutions/add-mcp/llms.txt

Use this file to discover all available pages before exploring further.

The remove command searches all detected agent configuration files for entries matching your query — by server name, URL, or package name — and removes the selected entries. By default it presents an interactive multi-select list pre-populated with all matches; pass -y to skip the prompt and remove everything at once.

Usage

npx add-mcp remove <query> [options]
The <query> argument is required. It is matched case-insensitively as a substring against server names and as an exact string against identity values (URL or package name).

Options

<query>
string
required
The search term used to find servers to remove. Matched as a case-insensitive substring of the server name, or as an exact match against the server’s URL or package identifier.
-g, --global
flag
Remove servers from user-level (global) config files instead of the project-level configs in the current directory.
-a, --agent <agent>
string (repeatable)
Restrict the search to one or more specific agents. Without this flag, all detected agents are searched.
-y, --yes
flag
Remove all matching servers without prompting. All matches found across all detected (or specified) agents are deleted immediately.

Behavior

  1. The CLI scans config files for all detected (or specified) agents.
  2. It collects every server whose name contains <query> (case-insensitive) or whose identity (URL or package) exactly equals <query>.
  3. Interactive mode (no -y): a multi-select prompt lists all matches, with all of them pre-selected. You can deselect any entries you want to keep before confirming.
  4. Non-interactive mode (-y): all matches are removed immediately and a summary is printed.
If no matches are found, the CLI prints an informational message and exits without making any changes.
Removal is applied directly to the agent’s config file on disk. There is no undo — verify your query with npx add-mcp list first if you are unsure what will be matched.

Examples

npx add-mcp remove neon
Run npx add-mcp list (or npx add-mcp list -g for global) before removing to confirm exactly which servers will be matched by your query.

Build docs developers (and LLMs) love