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.

add-mcp treats any AI coding assistant that speaks the Model Context Protocol as an agent. When you run the install command, add-mcp locates the correct configuration file for each agent and writes your MCP server entry in the format that agent expects — handling differences in file format (JSON, TOML, YAML), config key names, and server schema so you never have to do it manually.

​
Supported agents

The table below lists every agent add-mcp knows about, the value you pass to --agent (-a), whether project-level configuration is supported, and where each config file lives.
Agent--agent valueProject config pathGlobal config path
Antigravityantigravity—~/.gemini/antigravity/mcp_config.json
Cline VSCode Extensioncline—~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
Cline CLIcline-cli—~/.cline/data/settings/cline_mcp_settings.json
Claude Codeclaude-code.mcp.json~/.claude.json
Claude Desktopclaude-desktop—~/Library/Application Support/Claude/claude_desktop_config.json
Codexcodex.codex/config.toml~/.codex/config.toml
Cursorcursor.cursor/mcp.json~/.cursor/mcp.json
Gemini CLIgemini-cli.gemini/settings.json~/.gemini/settings.json
Goosegoose—~/.config/goose/config.yaml
GitHub Copilot CLIgithub-copilot-cli.vscode/mcp.json~/.copilot/mcp-config.json
MCPortermcporterconfig/mcporter.json~/.mcporter/mcporter.json
OpenCodeopencodeopencode.json~/.config/opencode/opencode.json
VS Codevscode.vscode/mcp.json~/Library/Application Support/Code/User/mcp.json
Windsurfwindsurf—~/.codeium/windsurf/mcp_config.json
Zedzed.zed/settings.json~/Library/Application Support/Zed/settings.json
A dash (—) in the Project config path column means that agent only supports a global config file. See Scopes for more detail on how add-mcp routes installs for these agents.
The paths shown above use macOS conventions (~/Library/Application Support/…). On Linux, add-mcp uses $XDG_CONFIG_HOME (defaulting to ~/.config) in place of Library/Application Support. On Windows, it uses %APPDATA% (defaulting to ~/AppData/Roaming). The path shown for Goose’s global config (~/.config/goose/config.yaml) applies on Linux and macOS; on Windows it resolves to %APPDATA%/Block/goose/config/config.yaml.

​
Agent aliases

Several alternative names are accepted and automatically resolved to the canonical agent identifier:
AliasResolves to
codeiumwindsurf
cascadewindsurf
cline-vscodecline
geminigemini-cli
github-copilotvscode
Aliases can be used anywhere the --agent flag is accepted.

​
Targeting a specific agent

Pass -a (or --agent) one or more times to install exclusively to those agents, skipping auto-detection entirely: 
# Install only to Cursor
npx add-mcp https://mcp.example.com/mcp -a cursor

# Install to Cursor and Claude Code
npx add-mcp https://mcp.example.com/mcp -a cursor -a claude-code

# Install globally to Claude Code, no prompts
npx add-mcp https://mcp.example.com/mcp -g -a claude-code -y
When -a is provided, add-mcp skips the interactive agent-selection prompt and writes directly to the specified agents’ config files.

​
Installing to all agents

Use --all to install to every supported agent at once, regardless of what is detected in the current directory: 
# Install to all agents (project scope where supported, global otherwise)
npx add-mcp mcp-server-github --all

# Install to all agents, globally, without prompts
npx add-mcp mcp-server-github --all -g -y
Pair --all with --gitignore when you want to write project-level configs without committing them. add-mcp will append every generated project config path to .gitignore automatically. See Scopes for details on the --gitignore flag.

​
Agent transport support

Most agents support all three transport types — HTTP, SSE, and stdio. The exception is Claude Desktop, which only supports local stdio servers through its config file. If you try to install a remote server to Claude Desktop, add-mcp will warn you and suggest using the in-app Settings → Connectors flow instead. See Transports for the full breakdown.

Build docs developers (and LLMs) love

Get started for freeTalk to us