Manage MCP servers across 13 AI clients from one CLI. Define a server once. Enable it where you want. Keep unmanaged client entries intact. MCP servers are useful, but managing them across multiple AI clients is repetitive and error-prone: - different config locations - different formats (JSON, JSONC, TOML) - repeated env/header setup - easy to overwrite manual client entries - hard to roll back a
Add this skill
npx mdskills install mohammedsamin/mcpupComprehensive CLI tool unifying MCP server management across 13 clients with registry, profiles, and safety features
1<div align="center">23# mcpup45**Manage MCP servers across 13 AI clients from one CLI.**67Define a server once. Enable it where you want. Keep unmanaged client entries intact.89[](https://github.com/mohammedsamin/mcpup/actions/workflows/ci.yml)10[](https://github.com/mohammedsamin/mcpup/releases/latest)11[](https://goreportcard.com/report/github.com/mohammedsamin/mcpup)12[](LICENSE)1314</div>1516---1718## Why mcpup1920MCP servers are useful, but managing them across multiple AI clients is repetitive and error-prone:2122- different config locations23- different formats (`JSON`, `JSONC`, `TOML`)24- repeated env/header setup25- easy to overwrite manual client entries26- hard to roll back a bad config write2728mcpup gives you one canonical config at `~/.mcpup/config.json` and keeps the client-specific files in sync.2930### What you get3132- one source of truth for MCP servers33- support for 13 clients34- 97 built-in server templates35- local `stdio` and remote `HTTP/SSE` server definitions36- ownership-aware writes that preserve unmanaged entries37- backups, rollback, drift checks, and `doctor`38- interactive wizard plus full CLI and JSON output3940## Quickstart4142### Interactive mode4344Run `mcpup` with no arguments:4546```bash47mcpup48```4950Current wizard menu:5152```text53? What would you like to do?54 → Quick setup (recommended)55 Add a server56 Remove a server57 Enable / Disable a server58 List servers59 Browse server registry60 Status overview61 Profiles62 Run doctor63 Rollback a client64 Exit65```6667### CLI mode6869```bash70# Guided onboarding71mcpup setup7273# Add a registry server74mcpup add github --env GITHUB_TOKEN=ghp_xxx7576# Add a custom local server77mcpup add my-server --command npx --arg -y --arg my-mcp-package7879# Add a remote HTTP/SSE server80mcpup add my-remote --url https://api.example.com/mcp --header "Authorization:Bearer sk-xxx"8182# Enable it on clients83mcpup enable github --client cursor84mcpup enable github --client claude-code8586# Preview changes before writing87mcpup enable github --client codex --dry-run8889# Diagnose problems90mcpup doctor9192# Roll back a client config93mcpup rollback --client cursor94```9596## Install9798### Homebrew99100```bash101brew tap mohammedsamin/tap102brew install mcpup103```104105### Go106107```bash108go install github.com/mohammedsamin/mcpup/cmd/mcpup@latest109```110111### Binary releases112113Download from [Releases](https://github.com/mohammedsamin/mcpup/releases/latest).114115## Built-in registry116117mcpup ships with **97 curated MCP server templates** so you do not have to chase package names or command syntax by hand.118119```bash120mcpup registry121```122123Examples:124125```bash126mcpup add github --env GITHUB_TOKEN=ghp_xxx127mcpup add notion --env NOTION_TOKEN=ntn_xxx128mcpup add playwright129mcpup add memory130```131132The registry includes categories like:133134- developer135- search136- productivity137- utility138- database139- automation140- media141- cloud142- ai143- communication144- finance145- devops146- security147- analytics148149## Supported clients150151mcpup currently manages these clients:152153- Claude Code154- Cursor155- Claude Desktop156- Codex157- OpenCode158- Windsurf159- Zed160- Continue161- VS Code162- Cline163- Roo Code164- Amazon Q165- Gemini166167For exact config locations and per-client behavior, see [docs/clients.md](docs/clients.md).168169## How it works170171```text172~/.mcpup/config.json173 |174 +--> mcpup planner + reconciler175 |176 +--> native client config files177```178179The core flow is:1801811. define a server once in canonical config1822. enable or disable it per client1833. mcpup computes the desired client state1844. it backs up the target config1855. it writes the native client format1866. it validates the result and rolls back on failure187188### Safety model189190- preserves unmanaged client entries191- creates backups before every write192- supports explicit rollback per client193- warns on destructive managed changes194- validates config shape, executables, env requirements, drift, and ownership via `doctor`195196## Common workflows197198### Set up a work profile199200```bash201mcpup add github --env GITHUB_TOKEN=ghp_xxx202mcpup add slack --env SLACK_BOT_TOKEN=xoxb-xxx203mcpup add notion --env NOTION_TOKEN=ntn_xxx204mcpup add sentry --env SENTRY_AUTH_TOKEN=sntrys_xxx205206mcpup profile create work --servers github,slack,notion,sentry207mcpup profile apply work --yes208```209210### Update registry-backed definitions211212```bash213mcpup update --yes214```215216### Export and import server packs217218```bash219mcpup export --servers github,notion --output team-pack.json220mcpup import team-pack.json221```222223### Script with JSON output224225```bash226mcpup list --json | jq '.data.servers[].name'227mcpup status --json | jq '.data.clients'228```229230## Command overview231232| Command | Description |233|---------|-------------|234| `mcpup` | Launch the interactive wizard |235| `mcpup setup` | Guided onboarding across clients and registry servers |236| `mcpup add <name>` | Add a registry, custom local, or remote server |237| `mcpup update [name...]` | Refresh registry-backed definitions |238| `mcpup enable / disable` | Toggle a server on a client, optionally per tool |239| `mcpup list` | List configured servers |240| `mcpup status` | Show overall status across clients |241| `mcpup export / import` | Share server definitions as JSON |242| `mcpup profile ...` | Create, apply, list, and delete profiles |243| `mcpup registry [query]` | Browse the built-in server catalog |244| `mcpup doctor` | Run diagnostics |245| `mcpup rollback --client <c>` | Restore a backup for one client |246| `mcpup completion <shell>` | Generate shell completions |247| `mcpup clients list` | Show supported clients |248249For full command details, see [docs/commands.md](docs/commands.md).250251## Documentation252253- [Architecture](docs/architecture.md)254- [Commands](docs/commands.md)255- [Clients](docs/clients.md)256- [Config schema](docs/config-schema.md)257- [Examples](docs/examples.md)258- [Troubleshooting](docs/troubleshooting.md)259- [Safety model](docs/safety.md)260- [Contributing](docs/contributing.md)261262## Development263264```bash265go test ./...266go build ./cmd/mcpup267./mcpup268```269270Or use the project helpers:271272```bash273make build274make test275make fmt276make lint277```278279## License280281[MIT](LICENSE)282
Full transparency — inspect the skill content before installing.