@mondaydotcomorg/monday-api-mcp 1.12.2 → 1.12.4

package/README.md

@@ -51,14 +51,6 @@ ATP (Agent Tool Protocol) mode provides an alternative integration that enables
 npx @mondaydotcomorg/monday-api-mcp@latest -t abcd123 -m atp
 ```
 
-### Configuration
-
-| Environment Variable | Description | Required |
-|---------------------|-------------|----------|
-| `MONDAY_ATP_PORT` | Specify a fixed port for the ATP server (1-65535). If not set, a random available port will be used. | No |
-| `NODE_OPTIONS` | Node.js runtime options. Set to `--no-node-snapshot` for compatibility. | Yes |
-| `ATP_JWT_SECRET` | JWT secret for ATP authentication. Must be set but currently not used (e.g., `ignore`). | Yes |
-
 ### Cursor Integration (ATP Mode)
 
 ```json
@@ -74,8 +66,7 @@ npx @mondaydotcomorg/monday-api-mcp@latest -t abcd123 -m atp
         "atp"
       ],
       "env": {
-        "NODE_OPTIONS": "--no-node-snapshot",
-        "ATP_JWT_SECRET": "ignore"
+        "NODE_OPTIONS": "--no-node-snapshot"
       }
     }
   }

package/dist/domains/atp/atp.consts.js

@@ -25,6 +25,20 @@ exports.TOOL_DESCRIPTIONS = {
 - If multiple results match a search, ASK which one they mean
 - If you're missing required information - ASK, don't guess
 
+**CRITICAL - Multiple Results Handling:**
+- When searching by name, ALWAYS check if multiple results match
+- If more than one result is found and the user asked for a SPECIFIC entity (not "all" or "every"), STOP and ASK which one they mean
+- Present the options clearly with distinguishing details (ID, relevant properties, etc.)
+- Only proceed with the action AFTER the user confirms which one(s)
+- Exception: If user explicitly says "all", "every", "both", etc., then apply to all matches
+
+**NEVER GUESS - STRICT RULES:**
+- NEVER pick "the first one" or any arbitrary result when multiple matches exist
+- NEVER assume which entity the user meant - even if one seems "more likely"
+- NEVER perform write operations (mutations) without explicit user confirmation when ambiguous
+- If you find 2+ matches: DO NOT execute the action, LIST all matches with their IDs and details, WAIT for user to specify
+- Saying "I updated the first one, let me know if you meant the other" is WRONG - you should have asked FIRST
+
 **Multi-line Example:**
 \`\`\`typescript
 // 1. Get board with columns and cursor

package/dist/domains/atp/atp.service.js

@@ -3,7 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.runAtpMcpServer = runAtpMcpServer;
 const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
 const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
-const net_1 = require("net");
 const atp_consts_js_1 = require("./atp.consts.js");
 // Dynamic imports required: ATP packages are ESM, this package is CJS
 async function loadAtpDependencies() {
@@ -26,46 +25,8 @@ function filterAndEnhanceTools(tools, toolDescriptions) {
         description: toolDescriptions[tool.name],
     }));
 }
-/**
- * Gets the ATP port from environment variable, or returns undefined to use dynamic port allocation.
- * Set MONDAY_ATP_PORT environment variable to use a specific port.
- */
-function getAtpPort() {
-    const envPort = process.env.MONDAY_ATP_PORT;
-    if (envPort) {
-        const port = parseInt(envPort, 10);
-        if (!isNaN(port) && port > 0 && port <= 65535) {
-            return port;
-        }
-    }
-    return undefined; // Will use dynamic port allocation
-}
-/**
- * Finds an available port by binding to port 0 and letting the OS assign one.
- */
-async function findAvailablePort() {
-    return new Promise((resolve, reject) => {
-        const server = (0, net_1.createServer)();
-        server.listen(0, () => {
-            const address = server.address();
-            if (address && typeof address === 'object') {
-                const port = address.port;
-                server.close(() => resolve(port));
-            }
-            else {
-                server.close(() => reject(new Error('Failed to get port from server address')));
-            }
-        });
-        server.on('error', reject);
-    });
-}
-async function initAtpServer(createServer) {
-    const server = createServer({ logger: 'none' });
-    // Use configured port or find an available one
-    const configuredPort = getAtpPort();
-    const port = configuredPort ?? (await findAvailablePort());
-    await server.listen(port);
-    return { server, port };
+function initAtpServer(createServer) {
+    return createServer({ logger: 'none' });
 }
 async function loadMondaySchema(server, token, version) {
     const apiVersion = version ?? atp_consts_js_1.DEFAULT_API_VERSION;
@@ -79,12 +40,9 @@ async function loadMondaySchema(server, token, version) {
         queryDepthLimit: atp_consts_js_1.QUERY_DEPTH_LIMIT,
     });
 }
-async function initAtpClient(AgentToolProtocolClient, port) {
-    const client = new AgentToolProtocolClient({
-        baseUrl: `http://localhost:${port}`,
-    });
+async function initAtpClient(AgentToolProtocolClient, server) {
+    const client = new AgentToolProtocolClient({ server });
     await client.init({ name: 'monday-api-mcp', version: '1.0.0' });
-    await client.connect();
     return client;
 }
 function createMcpServer() {
@@ -100,9 +58,9 @@ function createMcpServer() {
 async function runAtpMcpServer(config) {
     const { token, version } = config;
     const { createServer, AgentToolProtocolClient, ToolNames, registerToolsWithMCP } = await loadAtpDependencies();
-    const { server, port } = await initAtpServer(createServer);
+    const server = initAtpServer(createServer);
     await loadMondaySchema(server, token, version);
-    const client = await initAtpClient(AgentToolProtocolClient, port);
+    const client = await initAtpClient(AgentToolProtocolClient, server);
     const mcpServer = createMcpServer();
     const toolDescriptions = getToolDescriptions(ToolNames);
     const atpTools = filterAndEnhanceTools(client.getATPTools(), toolDescriptions);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mondaydotcomorg/monday-api-mcp",
-  "version": "1.12.2",
+  "version": "1.12.4",
   "description": "MCP server for using the monday.com API",
   "mcpName": "com.monday/monday.com",
   "license": "MIT",
@@ -25,9 +25,9 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.13.2",
     "@mondaydotcomorg/agent-toolkit": "*",
-    "@mondaydotcomorg/atp-client": "^0.19.6",
-    "@mondaydotcomorg/atp-mcp-adapter": "^0.19.7",
-    "@mondaydotcomorg/atp-server": "^0.19.7",
+    "@mondaydotcomorg/atp-client": "^0.19.7",
+    "@mondaydotcomorg/atp-mcp-adapter": "^0.19.8",
+    "@mondaydotcomorg/atp-server": "^0.19.8",
     "dotenv": "^16.4.7",
     "zod": "^3.25.0"
   },