Supported agents
Every coding agent add-mcp can install MCP servers to, with config paths and scopes.
MCP servers can be installed to any of these agents. Project paths are relative to your working directory; agents without a project path are global-only.
| Agent | --agent |
Project path | Global path |
|---|---|---|---|
| Antigravity | antigravity |
— | ~/.gemini/config/mcp_config.json (shared by Antigravity, Antigravity IDE, and Antigravity CLI) |
| Cline VSCode Extension | cline |
— | ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json |
| Cline CLI | cline-cli |
— | ~/.cline/data/settings/cline_mcp_settings.json |
| Claude Code | claude-code |
.mcp.json |
~/.claude.json |
| Claude Desktop | claude-desktop |
— | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Codex | codex |
.codex/config.toml |
~/.codex/config.toml |
| Cursor | cursor |
.cursor/mcp.json |
~/.cursor/mcp.json |
| fx | fx |
— | ~/.fx/mcp.json |
| Gemini CLI | gemini-cli |
.gemini/settings.json |
~/.gemini/settings.json |
| Goose | goose |
.goose/config.yaml |
~/.config/goose/config.yaml |
| GitHub Copilot CLI | github-copilot-cli |
.mcp.json (or existing .github/mcp.json) |
~/.copilot/mcp-config.json |
| Grok Build | grok-build |
.grok/config.toml |
$GROK_HOME/config.toml (defaults to ~/.grok/config.toml) |
| Kilo Code | kilo-code |
kilo.json (or existing .kilo/, .kilocode/, or root kilo.jsonc config) |
~/.config/kilo/kilo.json (or existing ~/.config/kilo/kilo.jsonc) |
| Kimi Code | kimi-code |
.kimi-code/mcp.json |
$KIMI_CODE_HOME/mcp.json (defaults to ~/.kimi-code/mcp.json) |
| Kiro CLI | kiro-cli |
.kiro/settings/mcp.json |
~/.kiro/settings/mcp.json (shared with the Kiro IDE) |
| Mastra Code | mastracode |
.mastracode/mcp.json |
~/.mastracode/mcp.json |
| MCPorter | mcporter |
config/mcporter.json |
~/.mcporter/mcporter.json (or existing ~/.mcporter/mcporter.jsonc) |
| OpenCode | opencode |
opencode.jsonc (or existing opencode.json / .opencode/ config) |
~/.config/opencode/opencode.jsonc (or existing opencode.json) |
| Pi | pi |
.pi/mcp.json |
$PI_CODING_AGENT_DIR/mcp.json (defaults to ~/.pi/agent/mcp.json) |
| VS Code | vscode |
.vscode/mcp.json |
~/Library/Application Support/Code/User/mcp.json |
| Windsurf | windsurf |
— | ~/.codeium/windsurf/mcp_config.json |
| Zed | zed |
.zed/settings.json |
~/Library/Application Support/Zed/settings.json |
Aliases
| Alias | Resolves to |
|---|---|
codeium, cascade |
windsurf |
cline-vscode |
cline |
gemini |
gemini-cli |
github-copilot |
vscode |
grok |
grok-build |
kilo, kilocode |
kilo-code |
kimi |
kimi-code |
kiro |
kiro-cli |
mastra |
mastracode |
pi-agent |
pi |
Troubleshooting
Some agents and editors, like Claude Code, require a restart to load a new MCP server. Others, like Cursor, require you to navigate to the MCP settings page and toggle the new server as enabled.
Kimi Code only loads a project-level .kimi-code/mcp.json after you trust the folder in the CLI, so a project install may not take effect until then. Its MCP config is also validated as a whole: if another entry in the file is invalid, Kimi Code disables every MCP server, including a newly added one.
Mastra Code also reads project .mcp.json. add-mcp writes .mastracode/mcp.json (and ~/.mastracode/mcp.json globally) so a mixed Claude + Mastra install does not share that file.
Pi has no built-in MCP. add-mcp writes the Pi-owned files pi-mcp-adapter reads. Install that extension with pi install npm:pi-mcp-adapter. A running Pi session picks the change up after /reload.
fx reads MCP servers only from ~/.fx/mcp.json. A project file cannot add a server. A running session applies the change with /mcp reload.
OpenCode keeps the shape already in the file: mcp.<name> on a V1 or empty config, mcp.servers.<name> when that native map is already there. In a mixed file, a native entry wins over a legacy entry with the same name. Adding a new name to a mixed file still writes V1; renaming a server keeps it in the map it already uses.
GitHub Copilot CLI project installs write .mcp.json. If .mcp.json is absent, an existing .github/mcp.json is reused. Copilot CLI does not read .vscode/mcp.json (that path is the VS Code agent). Entries left in .vscode/mcp.json from older Copilot CLI installs stay there for VS Code; rerun with --agent github-copilot-cli to write the CLI path. .mcp.json is shared with Claude Code: removing a server from either agent removes it for both. add-mcp will not create .mcp.json when .github/mcp.json already exists, because Copilot CLI would then ignore the GitHub file. Merge those servers into .mcp.json under mcpServers first. Copilot writes replace the file with strict JSON, so comments in that file are dropped (including global ~/.copilot/mcp-config.json). Copilot CLI loads a project file only after the folder is trusted; confirm with copilot mcp list --json.