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 is the fastest way to connect MCP (Model Context Protocol) servers to your AI coding agents. Run a single npx command to install any MCP server — by URL or package name — into Claude Code, Cursor, VS Code, Codex, Goose, Zed, and 11 more supported agents. It works interactively or fully headless with --yes, supports project-level and global scopes, and ships a programmatic TypeScript API for integrating into your own tooling.
Quickstart
Install your first MCP server in under a minute
All Commands
Full reference for add, find, list, remove, sync, and more
Supported Agents
See all 15 AI coding agents add-mcp supports
Programmatic API
Embed add-mcp in your own CLI or build tooling
How It Works
Run npx add-mcp with a URL or package
Pass a remote MCP URL or an npm package name. add-mcp parses the source and auto-infers the server name.
add-mcp detects your agents
It scans your current directory for project-level config files (
.cursor/mcp.json, .mcp.json, .vscode/mcp.json, etc.) and pre-selects any detected agents.Confirm and install
Review the installation summary and confirm. add-mcp writes the server config to each selected agent’s config file — creating the file if it doesn’t exist.
Key Features
15 Supported Agents
Claude Code, Cursor, VS Code, Codex, Goose, Zed, Windsurf, Gemini CLI, and more — all supported out of the box.
Remote & Local Servers
Install remote MCP servers via HTTP or SSE, or local stdio servers from npm packages and shell commands.
Registry Search
Search the add-mcp curated registry and the official Anthropic registry to discover and install MCP servers by keyword.
Project & Global Scopes
Install per-project (committed with your repo) or globally across all projects. Smart detection picks the right scope automatically.
Sync Across Agents
Keep server names consistent across all your agents with one sync command.
Programmatic API
Import
upsertServer, removeServer, and listInstalledServers to build your own MCP installation tooling.