add-mcp 1.10.2 → 1.10.4

package/README.md

@@ -2,7 +2,7 @@
 
 Add MCP servers to your favorite coding agents with a single command.
 
-Supports **Claude Code**, **Codex**, **Cursor**, **OpenCode**, **VSCode** and [9 more](#supported-agents).
+Supports **Claude Code**, **Codex**, **Cursor**, **OpenCode**, **VSCode** and [10 more](#supported-agents).
 
 ## Install an MCP Server
 
@@ -18,6 +18,20 @@ Example installing the Context7 remote MCP server:
 npx add-mcp https://mcp.context7.com/mcp
 ```
 
+Example installing the Context7 remote MCP server via the programmatic API — great for integrating add-mcp in your own CLI tool:
+
+```ts
+import { upsertServer } from "add-mcp";
+
+const result = upsertServer(
+  "cursor",
+  "context7",
+  { type: "http", url: "https://mcp.context7.com/mcp" },
+  { local: true },
+);
+console.log(result);
+```
+
 You can add env variables and arguments (stdio) and headers (remote) to the server config using the `--env`, `--args` and `--header` options. With `${VAR}` placeholders, interactive installs prompt for each variable (omit skipped optional keys so empty strings are not written to config).
 
 ## Find an MCP Servers
@@ -49,9 +63,10 @@ MCP servers can be installed to any of these agents:
 | MCPorter               | `mcporter`           | `config/mcporter.json`  | `~/.mcporter/mcporter.json` (or existing `~/.mcporter/mcporter.jsonc`)                                          |
 | OpenCode               | `opencode`           | `opencode.json`         | `~/.config/opencode/opencode.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:** `cline-vscode` → `cline`, `gemini` → `gemini-cli`, `github-copilot` → `vscode`
+**Aliases:** `codeium`, `cascade` → `windsurf`, `cline-vscode` → `cline`, `gemini` → `gemini-cli`, `github-copilot` → `vscode`
 
 ## Installation Scope
 
@@ -151,7 +166,7 @@ npx add-mcp https://mcp.example.com/mcp -a cursor -y --gitignore
 | `-a, --agent <agent>`    | Target specific agents (e.g., `cursor`, `claude-code`). Can be repeated. |
 | `-t, --transport <type>` | Transport type for remote servers: `http` (default), `sse`               |
 | `--type <type>`          | Alias for `--transport`                                                  |
-| `--header <header>`      | HTTP header for remote servers (repeatable, `Key: Value`)                |
+| `-h, --header <header>`  | HTTP header for remote servers (repeatable, `Key: Value`)                |
 | `--env <env>`            | Env var for local stdio servers (repeatable, `KEY=VALUE`)                |
 | `-n, --name <name>`      | Server name (auto-inferred if not provided)                              |
 | `-y, --yes`              | Skip all confirmation prompts                                            |

package/dist/{chunk-B27GVIBZ.js → chunk-ONLHW5AV.js}

@@ -153,6 +153,12 @@ var copilotConfigPath = join2(
   process.env.XDG_CONFIG_HOME || join2(home, ".copilot"),
   "mcp-config.json"
 );
+var windsurfConfigPath = join2(
+  home,
+  ".codeium",
+  "windsurf",
+  "mcp_config.json"
+);
 function transformGooseConfig(serverName, config) {
   if (config.url) {
     const gooseType = config.type === "sse" ? "sse" : "streamable_http";
@@ -503,6 +509,20 @@ var agents = {
       return existsSync(vscodePath);
     }
   },
+  windsurf: {
+    name: "windsurf",
+    displayName: "Windsurf",
+    configPath: windsurfConfigPath,
+    projectDetectPaths: [],
+    // Global only - no project support
+    configKey: "mcpServers",
+    format: "json",
+    supportedTransports: ["stdio", "http", "sse"],
+    detectGlobalInstall: async () => {
+      return existsSync(join2(home, ".codeium", "windsurf"));
+    },
+    transformConfig: transformAntigravityConfig
+  },
   zed: {
     name: "zed",
     displayName: "Zed",

package/dist/index.js

@@ -22,7 +22,7 @@ import {
   selectAgentsInteractive,
   supportsProjectConfig,
   updateGitignoreWithPaths
-} from "./chunk-B27GVIBZ.js";
+} from "./chunk-ONLHW5AV.js";
 
 // src/index.ts
 import { program } from "commander";
@@ -33,6 +33,8 @@ import { homedir } from "os";
 // src/types.ts
 var agentAliases = {
   "cline-vscode": "cline",
+  codeium: "windsurf",
+  cascade: "windsurf",
   gemini: "gemini-cli",
   "github-copilot": "vscode"
 };
@@ -780,7 +782,7 @@ async function runFind(query, options) {
 // package.json
 var package_default = {
   name: "add-mcp",
-  version: "1.10.2",
+  version: "1.10.4",
   description: "Add MCP servers to your favorite coding agents with a single command.",
   author: "Andre Landgraf <andre@neon.tech>",
   license: "Apache-2.0",
@@ -831,6 +833,7 @@ var package_default = {
     "mcporter",
     "opencode",
     "vscode",
+    "windsurf",
     "zed"
   ],
   repository: {
@@ -970,7 +973,7 @@ function extractSubcommandOptionsFromArgv() {
       result.gitignore = true;
       continue;
     }
-    if (arg === "--header" && argv[i + 1]) {
+    if ((arg === "-h" || arg === "--header") && argv[i + 1]) {
       const headers = result.header ? [...result.header] : [];
       headers.push(argv[i + 1]);
       result.header = headers;
@@ -1092,7 +1095,7 @@ function omitEmptyStringValues(record) {
 }
 program.name("add-mcp").description(
   "Install MCP servers for coding agents (Claude Code, Cursor, VS Code, OpenCode, Codex, and more \u2014 run list-agents for the full list)"
-).version(version).argument("[target]", "MCP server URL (remote) or package name (local stdio)").option(
+).version(version).helpOption("--help", "display help for command").argument("[target]", "MCP server URL (remote) or package name (local stdio)").option(
   "-g, --global",
   "Install globally (user-level) instead of project-level"
 ).option("-a, --agent <agent>", "Specify agents to install to", collect, []).option(
@@ -1102,7 +1105,7 @@ program.name("add-mcp").description(
   "-t, --transport <type>",
   "Transport type for remote servers (http, sse)"
 ).option("--type <type>", "Alias for --transport").option(
-  "--header <header>",
+  "-h, --header <header>",
   "HTTP header for remote servers (repeatable, 'Key: Value'). Placeholders ${VAR} prompt interactively when not using --yes. Use single quotes so your shell does not expand the ${VAR}.",
   collect,
   []

package/dist/lib.d.ts

@@ -1,4 +1,4 @@
-type AgentType = "antigravity" | "cline" | "cline-cli" | "claude-code" | "claude-desktop" | "codex" | "cursor" | "gemini-cli" | "goose" | "github-copilot-cli" | "mcporter" | "opencode" | "vscode" | "zed";
+type AgentType = "antigravity" | "cline" | "cline-cli" | "claude-code" | "claude-desktop" | "codex" | "cursor" | "gemini-cli" | "goose" | "github-copilot-cli" | "mcporter" | "opencode" | "vscode" | "windsurf" | "zed";
 type ConfigFormat = "json" | "yaml" | "toml";
 interface AgentConfig {
     /** Internal name */

package/dist/lib.js

@@ -10,7 +10,7 @@ import {
   listInstalledServers,
   readConfig,
   removeServerFromConfig
-} from "./chunk-B27GVIBZ.js";
+} from "./chunk-ONLHW5AV.js";
 
 // src/lib.ts
 import { existsSync } from "fs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "add-mcp",
-  "version": "1.10.2",
+  "version": "1.10.4",
   "description": "Add MCP servers to your favorite coding agents with a single command.",
   "author": "Andre Landgraf <andre@neon.tech>",
   "license": "Apache-2.0",
@@ -51,6 +51,7 @@
     "mcporter",
     "opencode",
     "vscode",
+    "windsurf",
     "zed"
   ],
   "repository": {