@webhooks-cc/mcp 1.15.0 → 1.15.1

package/README.md

@@ -2,7 +2,7 @@
 
 MCP server for [webhooks.cc](https://webhooks.cc). It gives coding agents direct access to webhook testing workflows: create endpoints, send signed test webhooks, inspect captures, compare attempts, verify signatures, and read recent webhook context through MCP resources.
 
-It works with Claude Code, Cursor, VS Code, Codex, Windsurf, and Claude Desktop. Hosted agents such as claude.ai and ChatGPT use the [remote server](#remote-server) at `https://webhooks.cc/mcp` instead.
+The easiest way in is the [remote server](#remote-server) at `https://webhooks.cc/mcp`, for any client that can add a remote MCP server (Claude Code, Cursor, VS Code, Codex, claude.ai, ChatGPT): you approve it once in your browser, with no key and nothing to install. This package is the local server, for sends to a handler on your machine, its prompts and resources, a keyless sandbox, and CI. It works with Claude Code, Cursor, VS Code, Codex, Devin Desktop (formerly Windsurf), and Claude Desktop.
 
 ## Install
 
@@ -27,11 +27,12 @@ For other agents, `npx skills add kroqdotdev/webhooks-cc` installs the same skil
 
 `https://webhooks.cc/mcp` serves the same tools over streamable HTTP, with nothing to install. The client opens webhooks.cc in the browser once; the human signs in and clicks Connect (OAuth 2.1 with PKCE, no code to type), and can disconnect it later under Account, Connected agents.
 
-- **claude.ai and Claude Desktop**: Settings, Connectors, add a custom connector with the URL `https://webhooks.cc/mcp`
-- **ChatGPT**: add it as a custom connector (developer mode)
-- **Claude Code**: `claude mcp add --transport http webhooks-cc https://webhooks.cc/mcp`
+- **Claude Code**: `claude mcp add -s user --transport http webhooks-cc https://webhooks.cc/mcp`, then `/mcp` in Claude Code to sign in
+- **Codex**: `codex mcp add webhooks-cc --url https://webhooks.cc/mcp` (it opens the browser to sign in; if it does not, `codex mcp login webhooks-cc`)
 - **Cursor** (`.cursor/mcp.json`): `{ "mcpServers": { "webhooks-cc": { "url": "https://webhooks.cc/mcp" } } }`
 - **VS Code** (`.vscode/mcp.json`): `{ "servers": { "webhooks-cc": { "type": "http", "url": "https://webhooks.cc/mcp" } } }`
+- **claude.ai and Claude Desktop**: Settings, Connectors, add a custom connector with the URL `https://webhooks.cc/mcp`
+- **ChatGPT**: add it as a custom connector (developer mode)
 
 A client that can send headers may use an API key instead: `Authorization: Bearer whcc_...`. The remote server has 44 tools: `send_to` and `replay_request` are left out and `targetUrl` is refused, because a hosted server cannot reach your machine, and waits are capped at 50 seconds. It needs an account (no sandbox), and serves tools only, without prompts or resources.
 
@@ -56,7 +57,7 @@ npx @webhooks-cc/mcp setup claude-code
 npx @webhooks-cc/mcp setup cursor
 npx @webhooks-cc/mcp setup vscode
 npx @webhooks-cc/mcp setup codex
-npx @webhooks-cc/mcp setup windsurf
+npx @webhooks-cc/mcp setup devin    # Devin Desktop, formerly Windsurf ("windsurf" works too)
 npx @webhooks-cc/mcp setup claude-desktop
 ```
 

package/dist/bin/mcp.js

@@ -2409,7 +2409,7 @@ function sandboxToolSet(server, session, showAccount) {
 }
 
 // src/index.ts
-var VERSION = true ? "1.15.0" : "0.0.0-dev";
+var VERSION = true ? "1.15.1" : "0.0.0-dev";
 function createServer(options = {}) {
   const apiKey = options.apiKey ?? process.env.WHK_API_KEY;
   const webhookUrl = options.webhookUrl ?? process.env.WHK_WEBHOOK_URL;
@@ -2436,7 +2436,15 @@ var import_fs = require("fs");
 var import_path = require("path");
 var import_child_process = require("child_process");
 var import_os = require("os");
-var TOOLS = ["claude-code", "claude-desktop", "cursor", "vscode", "codex", "windsurf"];
+var TOOLS = [
+  "claude-code",
+  "claude-desktop",
+  "cursor",
+  "vscode",
+  "codex",
+  "devin",
+  "windsurf"
+];
 var API_KEY_REGEX = /^whcc_[a-zA-Z0-9_-]+$/;
 function validateApiKeyFormat(key) {
   if (!API_KEY_REGEX.test(key)) {
@@ -2458,12 +2466,13 @@ function vscodeServerConfig(apiKey) {
 function resolveApiKey(flags) {
   return flags["api-key"] ?? process.env.WHK_API_KEY ?? null;
 }
-function mergeJsonConfig(filePath, serverName, serverConfig, key = "mcpServers") {
+function mergeJsonConfig(filePath, serverName, serverConfig, key = "mcpServers", onInvalid = "replace") {
   let existing = {};
   if ((0, import_fs.existsSync)(filePath)) {
     try {
       existing = JSON.parse((0, import_fs.readFileSync)(filePath, "utf-8"));
     } catch {
+      if (onInvalid === "keep") return false;
       console.warn(`Warning: ${filePath} contains invalid JSON and will be overwritten.`);
       console.warn(`A backup has been saved to ${filePath}.bak`);
       (0, import_fs.copyFileSync)(filePath, `${filePath}.bak`);
@@ -2475,6 +2484,7 @@ function mergeJsonConfig(filePath, serverName, serverConfig, key = "mcpServers")
   const dir = (0, import_path.dirname)(filePath);
   if (!(0, import_fs.existsSync)(dir)) (0, import_fs.mkdirSync)(dir, { recursive: true });
   (0, import_fs.writeFileSync)(filePath, JSON.stringify(existing, null, 2) + "\n");
+  return true;
 }
 function getClaudeDesktopConfigPath() {
   const os = (0, import_os.platform)();
@@ -2577,11 +2587,41 @@ WHK_API_KEY = "<your-key>"
     process.exit(1);
   }
 }
-function setupWindsurf(apiKey) {
-  const configPath = (0, import_path.join)((0, import_os.homedir)(), ".codeium", "windsurf", "mcp_config.json");
-  mergeJsonConfig(configPath, "webhooks-cc", mcpServerConfig(apiKey));
+function devinMcpConfigPath(os = (0, import_os.platform)(), home = (0, import_os.homedir)(), env = process.env) {
+  if (os === "win32") {
+    const base2 = env.APPDATA || import_path.win32.join(home, "AppData", "Roaming");
+    return import_path.win32.join(base2, "devin", "mcp_config.json");
+  }
+  const xdg = env.XDG_CONFIG_HOME;
+  const base = xdg && import_path.posix.isAbsolute(xdg) ? xdg : import_path.posix.join(home, ".config");
+  return import_path.posix.join(base, "devin", "mcp_config.json");
+}
+function legacyWindsurfConfigPath(home = (0, import_os.homedir)()) {
+  return (0, import_path.join)(home, ".codeium", "windsurf", "mcp_config.json");
+}
+function setupDevin(apiKey) {
+  const config = mcpServerConfig(apiKey);
+  const configPath = devinMcpConfigPath();
+  if (!mergeJsonConfig(configPath, "webhooks-cc", config, "mcpServers", "keep")) {
+    console.error(
+      `${configPath} is not plain JSON (it may hold comments), so it was left as it is.`
+    );
+    console.error(`Add this under "mcpServers" yourself:
+`);
+    const entry = mcpServerConfig(apiKey ? "<your-key>" : null);
+    console.error(`"webhooks-cc": ${JSON.stringify(entry, null, 2)}`);
+    process.exit(1);
+  }
   console.log(`Done! Config written to ${configPath}`);
-  console.log("Restart Windsurf for changes to take effect.");
+  const legacyPath = legacyWindsurfConfigPath();
+  if ((0, import_fs.existsSync)((0, import_path.dirname)(legacyPath))) {
+    if (mergeJsonConfig(legacyPath, "webhooks-cc", config, "mcpServers", "keep")) {
+      console.log(`Also written to ${legacyPath}, for Windsurf from before the rename.`);
+    } else {
+      console.warn(`Left ${legacyPath} as it is: it is not plain JSON.`);
+    }
+  }
+  console.log("Restart Devin Desktop (or Windsurf) for changes to take effect.");
 }
 function printUsage() {
   console.log(`
@@ -2599,7 +2639,8 @@ Tools:
   cursor           Cursor editor (writes .cursor/mcp.json)
   vscode           VS Code Copilot (writes .vscode/mcp.json)
   codex            OpenAI Codex CLI (runs 'codex mcp add')
-  windsurf         Windsurf editor
+  devin            Devin Desktop (formerly Windsurf) and the Devin CLI
+  windsurf         The same as devin
 
 Options:
   --api-key <key>  Your webhooks.cc API key (or set WHK_API_KEY env var); optional
@@ -2656,8 +2697,9 @@ function runSetup(args2) {
     case "codex":
       setupCodex(apiKey);
       break;
+    case "devin":
     case "windsurf":
-      setupWindsurf(apiKey);
+      setupDevin(apiKey);
       break;
   }
 }
@@ -2690,7 +2732,7 @@ Setup:
   npx @webhooks-cc/mcp setup cursor
   npx @webhooks-cc/mcp setup vscode
   npx @webhooks-cc/mcp setup codex
-  npx @webhooks-cc/mcp setup windsurf
+  npx @webhooks-cc/mcp setup devin
   npx @webhooks-cc/mcp setup claude-desktop
   (add --api-key whcc_... to start with your account's tools)
 

package/dist/index.js

@@ -2436,7 +2436,7 @@ function registerAgentRegistrationTools(server) {
 }
 
 // src/index.ts
-var VERSION = true ? "1.15.0" : "0.0.0-dev";
+var VERSION = true ? "1.15.1" : "0.0.0-dev";
 function createServer(options = {}) {
   const apiKey = options.apiKey ?? process.env.WHK_API_KEY;
   const webhookUrl = options.webhookUrl ?? process.env.WHK_WEBHOOK_URL;

package/dist/index.mjs

@@ -654,7 +654,7 @@ function registerAgentRegistrationTools(server) {
 }
 
 // src/index.ts
-var VERSION = true ? "1.15.0" : "0.0.0-dev";
+var VERSION = true ? "1.15.1" : "0.0.0-dev";
 function createServer(options = {}) {
   const apiKey = options.apiKey ?? process.env.WHK_API_KEY;
   const webhookUrl = options.webhookUrl ?? process.env.WHK_WEBHOOK_URL;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webhooks-cc/mcp",
-  "version": "1.15.0",
+  "version": "1.15.1",
   "mcpName": "io.github.kroqdotdev/webhooks-cc",
   "description": "MCP server for webhooks.cc — AI agent integration for webhook testing",
   "main": "dist/index.js",