capsulemcp 1.6.0 → 1.6.1

package/README.md

@@ -17,6 +17,7 @@ A [Model Context Protocol](https://modelcontextprotocol.io) server for [Capsule
 | Example questions to ask once the connector is running | [EXAMPLES.md](EXAMPLES.md) |
 | To use it locally with Claude Desktop or Claude Code | [INSTALL.md](INSTALL.md) |
 | To deploy it once and have your whole team use it via Claude.ai | [DEPLOY.md](DEPLOY.md) |
+| To wire it into n8n workflows | [INTEGRATIONS-n8n.md](INTEGRATIONS-n8n.md) |
 | To contribute, debug, add a tool, or cut a release | [HOWTO.md](HOWTO.md) (procedures) · [CONTRIBUTING.md](CONTRIBUTING.md) (style & PR checks) |
 | To understand what's intentionally not implemented (and why) | [DESIGN.md](DESIGN.md) |
 | To see what performance work has been done (and what's next) | [OPTIMIZATIONS.md](OPTIMIZATIONS.md) |
@@ -47,7 +48,7 @@ For most individual users the install is a single JSON snippet pasted into Claud
 
 3. Restart Claude Desktop. The Capsule tools appear in the tool picker.
 
-That's it. The first launch fetches the package from npm (a few seconds); subsequent launches are instant from the npx cache. To pin a specific version, use `"capsulemcp@1.6.0"` in `args`. If you're tracking a fork or an unreleased branch, use the GitHub-ref form instead: `"github:soil-dev/capsulemcp#v1.6.0"` — same arguments, just installs from a git clone rather than the npm registry. See [INSTALL.md](INSTALL.md) for the Claude Code path, manual install, and troubleshooting.
+That's it. The first launch fetches the package from npm (a few seconds); subsequent launches are instant from the npx cache. To pin a specific version, use `"capsulemcp@1.6.1"` in `args`. If you're tracking a fork or an unreleased branch, use the GitHub-ref form instead: `"github:soil-dev/capsulemcp#v1.6.1"` — same arguments, just installs from a git clone rather than the npm registry. See [INSTALL.md](INSTALL.md) for the Claude Code path, manual install, and troubleshooting.
 
 ## Tools
 

package/dist/http.js

@@ -304,11 +304,22 @@ async function doFetch(url, options) {
         "Rate limit exceeded after one retry. Please slow down your requests."
       );
     }
-    emitCapsuleRequest(method, url, retried.res, Date.now() - startedAt, true);
-    return retried;
+    return { ...retried, startedAt, method, url, retriedAfter429: true };
+  }
+  return { ...first, startedAt, method, url, retriedAfter429: false };
+}
+async function consumeBody(start, body) {
+  try {
+    return await body();
+  } finally {
+    emitCapsuleRequest(
+      start.method,
+      start.url,
+      start.res,
+      Date.now() - start.startedAt,
+      start.retriedAfter429
+    );
   }
-  emitCapsuleRequest(method, url, first.res, Date.now() - startedAt, false);
-  return first;
 }
 function emitCapsuleRequest(method, url, res, durationMs, retriedAfter429) {
   let path = "";
@@ -358,13 +369,15 @@ function buildUrl(path, params) {
 async function capsuleGet(path, params) {
   const token = getToken();
   const url = buildUrl(path, params);
-  const { res, cleanup } = await doFetch(url, { headers: baseHeaders(token) });
+  const start = await doFetch(url, { headers: baseHeaders(token) });
   try {
-    const data = await handleResponse(res);
-    const nextPage = parseNextPage(res.headers.get("Link"));
-    return { data, nextPage };
+    return await consumeBody(start, async () => {
+      const data = await handleResponse(start.res);
+      const nextPage = parseNextPage(start.res.headers.get("Link"));
+      return { data, nextPage };
+    });
   } finally {
-    cleanup();
+    start.cleanup();
   }
 }
 async function capsuleGetCached(path, params) {
@@ -399,123 +412,130 @@ async function capsulePost(path, body) {
   if (isReadOnly()) throw new CapsuleReadOnlyError("POST");
   const token = getToken();
   const url = buildUrl(path);
-  const { res, cleanup } = await doFetch(url, {
+  const start = await doFetch(url, {
     method: "POST",
     headers: { ...baseHeaders(token), "Content-Type": "application/json" },
     body: JSON.stringify(body)
   });
   try {
-    return await handleResponse(res);
+    return await consumeBody(start, () => handleResponse(start.res));
   } finally {
-    cleanup();
+    start.cleanup();
   }
 }
 async function capsulePostNoContent(path) {
   if (isReadOnly()) throw new CapsuleReadOnlyError("POST");
   const token = getToken();
   const url = buildUrl(path);
-  const { res, cleanup } = await doFetch(url, {
+  const start = await doFetch(url, {
     method: "POST",
     headers: baseHeaders(token)
   });
   try {
-    if (res.status === 204) return;
-    await throwForStatus(res);
-    await mapAbort(res.text());
+    await consumeBody(start, async () => {
+      if (start.res.status === 204) return;
+      await throwForStatus(start.res);
+      await mapAbort(start.res.text());
+    });
   } finally {
-    cleanup();
+    start.cleanup();
   }
 }
 async function capsuleSearch(path, body, params) {
   const token = getToken();
   const url = buildUrl(path, params);
-  const { res, cleanup } = await doFetch(url, {
+  const start = await doFetch(url, {
     method: "POST",
     headers: { ...baseHeaders(token), "Content-Type": "application/json" },
     body: JSON.stringify(body)
   });
   try {
-    const data = await handleResponse(res);
-    const nextPage = parseNextPage(res.headers.get("Link"));
-    return { data, nextPage };
+    return await consumeBody(start, async () => {
+      const data = await handleResponse(start.res);
+      const nextPage = parseNextPage(start.res.headers.get("Link"));
+      return { data, nextPage };
+    });
   } finally {
-    cleanup();
+    start.cleanup();
   }
 }
 async function capsulePut(path, body) {
   if (isReadOnly()) throw new CapsuleReadOnlyError("PUT");
   const token = getToken();
   const url = buildUrl(path);
-  const { res, cleanup } = await doFetch(url, {
+  const start = await doFetch(url, {
     method: "PUT",
     headers: { ...baseHeaders(token), "Content-Type": "application/json" },
     body: JSON.stringify(body)
   });
   try {
-    return await handleResponse(res);
+    return await consumeBody(start, () => handleResponse(start.res));
   } finally {
-    cleanup();
+    start.cleanup();
   }
 }
 async function capsuleGetBinary(path, maxBytes) {
   const token = getToken();
   const url = buildUrl(path);
-  const { res, cleanup } = await doFetch(url, { headers: baseHeaders(token) });
+  const start = await doFetch(url, { headers: baseHeaders(token) });
   try {
-    await throwForStatus(res);
-    const contentType = res.headers.get("Content-Type") ?? "application/octet-stream";
-    const declared = res.headers.get("Content-Length");
-    const declaredBytes = declared ? Number(declared) : NaN;
-    if (maxBytes !== void 0 && Number.isFinite(declaredBytes) && declaredBytes > maxBytes) {
-      if (res.body) await res.body.cancel().catch(() => {
-      });
-      return {
-        contentType,
-        buffer: Buffer.alloc(0),
-        truncated: true,
-        sizeBytes: declaredBytes
-      };
-    }
-    if (maxBytes !== void 0 && res.body) {
-      const reader = res.body.getReader();
-      const chunks = [];
-      let total = 0;
-      let truncated = false;
-      while (true) {
-        const { done, value } = await mapAbort(reader.read());
-        if (done) break;
-        total += value.byteLength;
-        if (total > maxBytes) {
-          truncated = true;
-          await reader.cancel().catch(() => {
-          });
-          break;
-        }
-        chunks.push(value);
-      }
-      if (truncated) {
+    return await consumeBody(start, async () => {
+      const res = start.res;
+      await throwForStatus(res);
+      const contentType = res.headers.get("Content-Type") ?? "application/octet-stream";
+      const declared = res.headers.get("Content-Length");
+      const declaredBytes = declared ? Number(declared) : NaN;
+      if (maxBytes !== void 0 && Number.isFinite(declaredBytes) && declaredBytes > maxBytes) {
+        if (res.body) await res.body.cancel().catch(() => {
+        });
         return {
           contentType,
           buffer: Buffer.alloc(0),
           truncated: true,
-          sizeBytes: total
+          sizeBytes: declaredBytes
         };
       }
-      const buffer2 = Buffer.concat(chunks.map((c) => Buffer.from(c)));
-      return { contentType, buffer: buffer2, sizeBytes: buffer2.length };
-    }
-    const arrayBuffer = await mapAbort(res.arrayBuffer());
-    const buffer = Buffer.from(arrayBuffer);
-    return { contentType, buffer, sizeBytes: buffer.length };
+      if (maxBytes !== void 0 && res.body) {
+        const reader = res.body.getReader();
+        const chunks = [];
+        let total = 0;
+        let truncated = false;
+        while (true) {
+          const { done, value } = await mapAbort(reader.read());
+          if (done) break;
+          total += value.byteLength;
+          if (total > maxBytes) {
+            truncated = true;
+            await reader.cancel().catch(() => {
+            });
+            break;
+          }
+          chunks.push(value);
+        }
+        if (truncated) {
+          return {
+            contentType,
+            buffer: Buffer.alloc(0),
+            truncated: true,
+            sizeBytes: total
+          };
+        }
+        const buffer2 = Buffer.concat(chunks.map((c) => Buffer.from(c)));
+        return { contentType, buffer: buffer2, sizeBytes: buffer2.length };
+      }
+      const arrayBuffer = await mapAbort(res.arrayBuffer());
+      const buffer = Buffer.from(arrayBuffer);
+      return { contentType, buffer, sizeBytes: buffer.length };
+    });
   } finally {
-    cleanup();
+    start.cleanup();
   }
 }
 async function capsulePostBinary(path, body, contentType, filename) {
   if (isReadOnly()) throw new CapsuleReadOnlyError("POST");
   const token = getToken();
   const url = buildUrl(path);
-  const { res, cleanup } = await doFetch(url, {
+  const start = await doFetch(url, {
     method: "POST",
     headers: {
       ...baseHeaders(token),
@@ -526,25 +546,27 @@ async function capsulePostBinary(path, body, contentType, filename) {
     body
   });
   try {
-    return await handleResponse(res);
+    return await consumeBody(start, () => handleResponse(start.res));
   } finally {
-    cleanup();
+    start.cleanup();
   }
 }
 async function capsuleDelete(path) {
   if (isReadOnly()) throw new CapsuleReadOnlyError("DELETE");
   const token = getToken();
   const url = buildUrl(path);
-  const { res, cleanup } = await doFetch(url, {
+  const start = await doFetch(url, {
     method: "DELETE",
     headers: baseHeaders(token)
   });
   try {
-    if (res.status === 204) return;
-    await throwForStatus(res);
-    await mapAbort(res.text());
+    await consumeBody(start, async () => {
+      if (start.res.status === 204) return;
+      await throwForStatus(start.res);
+      await mapAbort(start.res.text());
+    });
   } finally {
-    cleanup();
+    start.cleanup();
   }
 }
 
@@ -1944,16 +1966,20 @@ var createOpportunitySchema = z5.object({
   probability: z5.number().int().min(0).max(100).optional(),
   ownerId: z5.number().int().positive().optional().describe(
     "Assign to user ID. Defaults to the API-token owner when omitted \u2014 note that opportunities do NOT inherit owner from the linked party, even though one might expect it. Once set, this connector cannot clear the owner back to null (use Capsule's web UI). Discover IDs via list_users."
+  ),
+  teamId: z5.number().int().positive().optional().describe(
+    "Assign to team ID (discover via list_teams). Independent from `ownerId` \u2014 setting one does NOT clear the other on create. Three ownership shapes are valid: owner alone, team alone, or owner+team (the owner must be a member of the team; users can belong to multiple teams \u2014 422 'owner is not a member of the team' otherwise)."
   )
 });
 async function createOpportunity(input) {
-  const { partyId, milestoneId, ownerId, ...rest } = input;
+  const { partyId, milestoneId, ownerId, teamId, ...rest } = input;
   const body = {
     ...rest,
     party: { id: partyId },
     milestone: { id: milestoneId }
   };
   if (ownerId) body["owner"] = { id: ownerId };
+  if (teamId) body["team"] = { id: teamId };
   return capsulePost("/opportunities", { opportunity: body });
 }
 var updateOpportunitySchema = z5.object({
@@ -1972,18 +1998,28 @@ var updateOpportunitySchema = z5.object({
     "Reason the opportunity was lost. Only meaningful when transitioning to a Lost milestone \u2014 Capsule silently drops it for other milestones. Without this set, a connector-driven Lost-close leaves `lostReason: null`. Discover IDs via list_lostreasons."
   ),
   ownerId: z5.number().int().positive().optional().describe(
-    "Reassign owner to user ID. Once set, this connector cannot clear an owner back to null \u2014 use Capsule's web UI for that."
+    "Reassign owner to user ID. Once set, this connector cannot clear an owner back to null \u2014 use Capsule's web UI for that. When you supply `ownerId` and omit `teamId`, the connector fetches the opportunity's current team and includes it in the PUT body to preserve it across the owner change. Without this defensive read, Capsule's PUT would clear the existing team (see NOTES-ON-CAPSULE-API.md \xA727 \u2014 same asymmetric semantic as /kases). Supply `teamId` explicitly on the same call to change the team instead."
+  ),
+  teamId: z5.number().int().positive().nullable().optional().describe(
+    "Reassign team: pass a team ID (discover via list_teams) to set, or `null` to unassign. Capsule preserves the existing owner across a team change (server-side), so `update_opportunity { teamId }` alone is safe \u2014 the owner is carried through. Owner must be a member of the new team or Capsule returns 422 'owner is not a member of the team'. Independent from `ownerId` \u2014 setting `teamId` does NOT clear the owner."
   ),
   fields: z5.array(CustomFieldWriteSchema).optional().describe(fieldsArrayDescriptor("get_opportunity"))
 });
 async function updateOpportunity(input) {
-  const { id, milestoneId, ownerId, lostReasonId, fields, ...rest } = input;
+  const { id, milestoneId, ownerId, teamId, lostReasonId, fields, ...rest } = input;
   const body = {};
   for (const [k, v] of Object.entries(rest)) {
     if (v !== void 0) body[k] = v;
   }
   if (milestoneId) body["milestone"] = { id: milestoneId };
+  let resolvedTeamId = teamId;
+  if (ownerId !== void 0 && teamId === void 0) {
+    const { data } = await capsuleGet(`/opportunities/${id}`);
+    resolvedTeamId = data.opportunity?.team?.id ?? void 0;
+  }
   if (ownerId) body["owner"] = { id: ownerId };
+  if (resolvedTeamId === null) body["team"] = null;
+  else if (resolvedTeamId !== void 0) body["team"] = { id: resolvedTeamId };
   if (lostReasonId) body["lostReason"] = { id: lostReasonId };
   const mappedFields = mapFieldsForBody(fields);
   if (mappedFields !== void 0) body["fields"] = mappedFields;
@@ -3051,7 +3087,7 @@ function createCapsuleMcpServer(opts) {
   const server = new McpServer(
     {
       name: "capsulemcp",
-      version: "1.6.0",
+      version: "1.6.1",
       description: "Read and (optionally) modify Capsule CRM data \u2014 parties, opportunities, projects, tasks, timeline entries, pipelines, tags.",
       websiteUrl: "https://github.com/soil-dev/capsulemcp",
       icons: ICONS

package/dist/index.js

@@ -286,11 +286,22 @@ async function doFetch(url, options) {
         "Rate limit exceeded after one retry. Please slow down your requests."
       );
     }
-    emitCapsuleRequest(method, url, retried.res, Date.now() - startedAt, true);
-    return retried;
+    return { ...retried, startedAt, method, url, retriedAfter429: true };
+  }
+  return { ...first, startedAt, method, url, retriedAfter429: false };
+}
+async function consumeBody(start, body) {
+  try {
+    return await body();
+  } finally {
+    emitCapsuleRequest(
+      start.method,
+      start.url,
+      start.res,
+      Date.now() - start.startedAt,
+      start.retriedAfter429
+    );
   }
-  emitCapsuleRequest(method, url, first.res, Date.now() - startedAt, false);
-  return first;
 }
 function emitCapsuleRequest(method, url, res, durationMs, retriedAfter429) {
   let path = "";
@@ -340,13 +351,15 @@ function buildUrl(path, params) {
 async function capsuleGet(path, params) {
   const token = getToken();
   const url = buildUrl(path, params);
-  const { res, cleanup } = await doFetch(url, { headers: baseHeaders(token) });
+  const start = await doFetch(url, { headers: baseHeaders(token) });
   try {
-    const data = await handleResponse(res);
-    const nextPage = parseNextPage(res.headers.get("Link"));
-    return { data, nextPage };
+    return await consumeBody(start, async () => {
+      const data = await handleResponse(start.res);
+      const nextPage = parseNextPage(start.res.headers.get("Link"));
+      return { data, nextPage };
+    });
   } finally {
-    cleanup();
+    start.cleanup();
   }
 }
 async function capsuleGetCached(path, params) {
@@ -381,123 +394,130 @@ async function capsulePost(path, body) {
   if (isReadOnly()) throw new CapsuleReadOnlyError("POST");
   const token = getToken();
   const url = buildUrl(path);
-  const { res, cleanup } = await doFetch(url, {
+  const start = await doFetch(url, {
     method: "POST",
     headers: { ...baseHeaders(token), "Content-Type": "application/json" },
     body: JSON.stringify(body)
   });
   try {
-    return await handleResponse(res);
+    return await consumeBody(start, () => handleResponse(start.res));
   } finally {
-    cleanup();
+    start.cleanup();
   }
 }
 async function capsulePostNoContent(path) {
   if (isReadOnly()) throw new CapsuleReadOnlyError("POST");
   const token = getToken();
   const url = buildUrl(path);
-  const { res, cleanup } = await doFetch(url, {
+  const start = await doFetch(url, {
     method: "POST",
     headers: baseHeaders(token)
   });
   try {
-    if (res.status === 204) return;
-    await throwForStatus(res);
-    await mapAbort(res.text());
+    await consumeBody(start, async () => {
+      if (start.res.status === 204) return;
+      await throwForStatus(start.res);
+      await mapAbort(start.res.text());
+    });
   } finally {
-    cleanup();
+    start.cleanup();
   }
 }
 async function capsuleSearch(path, body, params) {
   const token = getToken();
   const url = buildUrl(path, params);
-  const { res, cleanup } = await doFetch(url, {
+  const start = await doFetch(url, {
     method: "POST",
     headers: { ...baseHeaders(token), "Content-Type": "application/json" },
     body: JSON.stringify(body)
   });
   try {
-    const data = await handleResponse(res);
-    const nextPage = parseNextPage(res.headers.get("Link"));
-    return { data, nextPage };
+    return await consumeBody(start, async () => {
+      const data = await handleResponse(start.res);
+      const nextPage = parseNextPage(start.res.headers.get("Link"));
+      return { data, nextPage };
+    });
   } finally {
-    cleanup();
+    start.cleanup();
   }
 }
 async function capsulePut(path, body) {
   if (isReadOnly()) throw new CapsuleReadOnlyError("PUT");
   const token = getToken();
   const url = buildUrl(path);
-  const { res, cleanup } = await doFetch(url, {
+  const start = await doFetch(url, {
     method: "PUT",
     headers: { ...baseHeaders(token), "Content-Type": "application/json" },
     body: JSON.stringify(body)
   });
   try {
-    return await handleResponse(res);
+    return await consumeBody(start, () => handleResponse(start.res));
   } finally {
-    cleanup();
+    start.cleanup();
   }
 }
 async function capsuleGetBinary(path, maxBytes) {
   const token = getToken();
   const url = buildUrl(path);
-  const { res, cleanup } = await doFetch(url, { headers: baseHeaders(token) });
+  const start = await doFetch(url, { headers: baseHeaders(token) });
   try {
-    await throwForStatus(res);
-    const contentType = res.headers.get("Content-Type") ?? "application/octet-stream";
-    const declared = res.headers.get("Content-Length");
-    const declaredBytes = declared ? Number(declared) : NaN;
-    if (maxBytes !== void 0 && Number.isFinite(declaredBytes) && declaredBytes > maxBytes) {
-      if (res.body) await res.body.cancel().catch(() => {
-      });
-      return {
-        contentType,
-        buffer: Buffer.alloc(0),
-        truncated: true,
-        sizeBytes: declaredBytes
-      };
-    }
-    if (maxBytes !== void 0 && res.body) {
-      const reader = res.body.getReader();
-      const chunks = [];
-      let total = 0;
-      let truncated = false;
-      while (true) {
-        const { done, value } = await mapAbort(reader.read());
-        if (done) break;
-        total += value.byteLength;
-        if (total > maxBytes) {
-          truncated = true;
-          await reader.cancel().catch(() => {
-          });
-          break;
-        }
-        chunks.push(value);
-      }
-      if (truncated) {
+    return await consumeBody(start, async () => {
+      const res = start.res;
+      await throwForStatus(res);
+      const contentType = res.headers.get("Content-Type") ?? "application/octet-stream";
+      const declared = res.headers.get("Content-Length");
+      const declaredBytes = declared ? Number(declared) : NaN;
+      if (maxBytes !== void 0 && Number.isFinite(declaredBytes) && declaredBytes > maxBytes) {
+        if (res.body) await res.body.cancel().catch(() => {
+        });
         return {
           contentType,
           buffer: Buffer.alloc(0),
           truncated: true,
-          sizeBytes: total
+          sizeBytes: declaredBytes
         };
       }
-      const buffer2 = Buffer.concat(chunks.map((c) => Buffer.from(c)));
-      return { contentType, buffer: buffer2, sizeBytes: buffer2.length };
-    }
-    const arrayBuffer = await mapAbort(res.arrayBuffer());
-    const buffer = Buffer.from(arrayBuffer);
-    return { contentType, buffer, sizeBytes: buffer.length };
+      if (maxBytes !== void 0 && res.body) {
+        const reader = res.body.getReader();
+        const chunks = [];
+        let total = 0;
+        let truncated = false;
+        while (true) {
+          const { done, value } = await mapAbort(reader.read());
+          if (done) break;
+          total += value.byteLength;
+          if (total > maxBytes) {
+            truncated = true;
+            await reader.cancel().catch(() => {
+            });
+            break;
+          }
+          chunks.push(value);
+        }
+        if (truncated) {
+          return {
+            contentType,
+            buffer: Buffer.alloc(0),
+            truncated: true,
+            sizeBytes: total
+          };
+        }
+        const buffer2 = Buffer.concat(chunks.map((c) => Buffer.from(c)));
+        return { contentType, buffer: buffer2, sizeBytes: buffer2.length };
+      }
+      const arrayBuffer = await mapAbort(res.arrayBuffer());
+      const buffer = Buffer.from(arrayBuffer);
+      return { contentType, buffer, sizeBytes: buffer.length };
+    });
   } finally {
-    cleanup();
+    start.cleanup();
   }
 }
 async function capsulePostBinary(path, body, contentType, filename) {
   if (isReadOnly()) throw new CapsuleReadOnlyError("POST");
   const token = getToken();
   const url = buildUrl(path);
-  const { res, cleanup } = await doFetch(url, {
+  const start = await doFetch(url, {
     method: "POST",
     headers: {
       ...baseHeaders(token),
@@ -508,25 +528,27 @@ async function capsulePostBinary(path, body, contentType, filename) {
     body
   });
   try {
-    return await handleResponse(res);
+    return await consumeBody(start, () => handleResponse(start.res));
   } finally {
-    cleanup();
+    start.cleanup();
   }
 }
 async function capsuleDelete(path) {
   if (isReadOnly()) throw new CapsuleReadOnlyError("DELETE");
   const token = getToken();
   const url = buildUrl(path);
-  const { res, cleanup } = await doFetch(url, {
+  const start = await doFetch(url, {
     method: "DELETE",
     headers: baseHeaders(token)
   });
   try {
-    if (res.status === 204) return;
-    await throwForStatus(res);
-    await mapAbort(res.text());
+    await consumeBody(start, async () => {
+      if (start.res.status === 204) return;
+      await throwForStatus(start.res);
+      await mapAbort(start.res.text());
+    });
   } finally {
-    cleanup();
+    start.cleanup();
   }
 }
 
@@ -1441,16 +1463,20 @@ var createOpportunitySchema = z4.object({
   probability: z4.number().int().min(0).max(100).optional(),
   ownerId: z4.number().int().positive().optional().describe(
     "Assign to user ID. Defaults to the API-token owner when omitted \u2014 note that opportunities do NOT inherit owner from the linked party, even though one might expect it. Once set, this connector cannot clear the owner back to null (use Capsule's web UI). Discover IDs via list_users."
+  ),
+  teamId: z4.number().int().positive().optional().describe(
+    "Assign to team ID (discover via list_teams). Independent from `ownerId` \u2014 setting one does NOT clear the other on create. Three ownership shapes are valid: owner alone, team alone, or owner+team (the owner must be a member of the team; users can belong to multiple teams \u2014 422 'owner is not a member of the team' otherwise)."
   )
 });
 async function createOpportunity(input) {
-  const { partyId, milestoneId, ownerId, ...rest } = input;
+  const { partyId, milestoneId, ownerId, teamId, ...rest } = input;
   const body = {
     ...rest,
     party: { id: partyId },
     milestone: { id: milestoneId }
   };
   if (ownerId) body["owner"] = { id: ownerId };
+  if (teamId) body["team"] = { id: teamId };
   return capsulePost("/opportunities", { opportunity: body });
 }
 var updateOpportunitySchema = z4.object({
@@ -1469,18 +1495,28 @@ var updateOpportunitySchema = z4.object({
     "Reason the opportunity was lost. Only meaningful when transitioning to a Lost milestone \u2014 Capsule silently drops it for other milestones. Without this set, a connector-driven Lost-close leaves `lostReason: null`. Discover IDs via list_lostreasons."
   ),
   ownerId: z4.number().int().positive().optional().describe(
-    "Reassign owner to user ID. Once set, this connector cannot clear an owner back to null \u2014 use Capsule's web UI for that."
+    "Reassign owner to user ID. Once set, this connector cannot clear an owner back to null \u2014 use Capsule's web UI for that. When you supply `ownerId` and omit `teamId`, the connector fetches the opportunity's current team and includes it in the PUT body to preserve it across the owner change. Without this defensive read, Capsule's PUT would clear the existing team (see NOTES-ON-CAPSULE-API.md \xA727 \u2014 same asymmetric semantic as /kases). Supply `teamId` explicitly on the same call to change the team instead."
+  ),
+  teamId: z4.number().int().positive().nullable().optional().describe(
+    "Reassign team: pass a team ID (discover via list_teams) to set, or `null` to unassign. Capsule preserves the existing owner across a team change (server-side), so `update_opportunity { teamId }` alone is safe \u2014 the owner is carried through. Owner must be a member of the new team or Capsule returns 422 'owner is not a member of the team'. Independent from `ownerId` \u2014 setting `teamId` does NOT clear the owner."
   ),
   fields: z4.array(CustomFieldWriteSchema).optional().describe(fieldsArrayDescriptor("get_opportunity"))
 });
 async function updateOpportunity(input) {
-  const { id, milestoneId, ownerId, lostReasonId, fields, ...rest } = input;
+  const { id, milestoneId, ownerId, teamId, lostReasonId, fields, ...rest } = input;
   const body = {};
   for (const [k, v] of Object.entries(rest)) {
     if (v !== void 0) body[k] = v;
   }
   if (milestoneId) body["milestone"] = { id: milestoneId };
+  let resolvedTeamId = teamId;
+  if (ownerId !== void 0 && teamId === void 0) {
+    const { data } = await capsuleGet(`/opportunities/${id}`);
+    resolvedTeamId = data.opportunity?.team?.id ?? void 0;
+  }
   if (ownerId) body["owner"] = { id: ownerId };
+  if (resolvedTeamId === null) body["team"] = null;
+  else if (resolvedTeamId !== void 0) body["team"] = { id: resolvedTeamId };
   if (lostReasonId) body["lostReason"] = { id: lostReasonId };
   const mappedFields = mapFieldsForBody(fields);
   if (mappedFields !== void 0) body["fields"] = mappedFields;
@@ -2548,7 +2584,7 @@ function createCapsuleMcpServer(opts) {
   const server2 = new McpServer(
     {
       name: "capsulemcp",
-      version: "1.6.0",
+      version: "1.6.1",
       description: "Read and (optionally) modify Capsule CRM data \u2014 parties, opportunities, projects, tasks, timeline entries, pipelines, tags.",
       websiteUrl: "https://github.com/soil-dev/capsulemcp",
       icons: ICONS

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "capsulemcp",
-  "version": "1.6.0",
+  "version": "1.6.1",
   "description": "Model Context Protocol server for Capsule CRM. Lets Claude (Desktop, Code, or web Projects via Custom Connector) read and write your CRM in plain English. Covers contacts, opportunities, projects, tasks, timeline activity, structured filters, saved filters with sort, workflow tracks, file attachments, audit, and batch fetches.",
   "keywords": [
     "mcp",