capsulemcp 1.8.1 → 2.0.0

package/README.md

@@ -4,10 +4,10 @@
 
 A [Model Context Protocol](https://modelcontextprotocol.io) server for [Capsule CRM](https://capsulecrm.com). Connect Claude (Desktop, Code, or web Projects via Custom Connector) to your CRM and let it answer natural-language questions across the full record graph: contacts, organisations, opportunities, projects, tasks, and timeline activity. Beyond the basics it covers structured filters with field/operator conditions, saved searches with sort, workflow tracks (templates and instances), file attachments (read + write), audit of deleted records, and batch fetches up to 50 records per call.
 
-- **88 tools** across the Capsule resource graph (49 in read-only mode) — full read coverage plus careful, confirm-gated writes; 6 batched-write tools (`batch_*`) for mass-update workflows
+- **89 tools** across the Capsule resource graph (50 in read-only mode) — full read coverage plus careful, confirm-gated writes; 6 batched-write tools (`batch_*`) for mass-update workflows
 - **Two transports**: stdio for local installs (Claude Desktop / Code), HTTP+OAuth for hosted Custom Connectors
 - **Read-only mode** as a one-env-var flag; works alongside read-scoped Capsule tokens
-- **MCP tool annotations**: 49 read tools carry `readOnlyHint: true`, 8 destructive ones carry `destructiveHint: true` — clients that honor these hints can auto-approve safe reads while still prompting for writes/destructive calls
+- **MCP tool annotations**: 50 read tools carry `readOnlyHint: true`, 8 destructive ones carry `destructiveHint: true` — clients that honor these hints can auto-approve safe reads while still prompting for writes/destructive calls
 - **Apache 2.0**
 
 ## Pick your install
@@ -48,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.8.1"` in `args`. If you're tracking a fork or an unreleased branch, use the GitHub-ref form instead: `"github:soil-dev/capsulemcp#v1.8.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.
+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@2.0.0"` in `args`. If you're tracking a fork or an unreleased branch, use the GitHub-ref form instead: `"github:soil-dev/capsulemcp#v2.0.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.
 
 ## Tools
 
@@ -56,7 +56,7 @@ That's it. The first launch fetches the package from npm (a few seconds); subseq
 |---|---|---|
 | Parties (people/orgs) | `search_parties`, `filter_parties`, `get_party`, `get_parties`, `list_employees`, `list_party_opportunities`, `list_party_projects`, `list_party_entries` | `create_party`, `update_party`, `delete_party`, `add_party_email_address`, `remove_party_email_address_by_id`, `add_party_phone_number`, `remove_party_phone_number_by_id`, `add_party_address`, `remove_party_address_by_id`, `add_party_website`, `remove_party_website_by_id` |
 | Opportunities | `search_opportunities`, `filter_opportunities`, `get_opportunity`, `get_opportunities`, `list_opportunity_entries`, `list_associated_projects` | `create_opportunity`, `update_opportunity`, `delete_opportunity` |
-| Projects (cases) | `list_projects`, `filter_projects`, `get_project`, `get_projects`, `list_project_entries` | `create_project`, `update_project`, `delete_project` |
+| Projects (cases) | `search_projects`, `list_projects`, `filter_projects`, `get_project`, `get_projects`, `list_project_entries` | `create_project`, `update_project`, `delete_project` |
 | Additional parties (multi-party deals) | `list_additional_parties` | `add_additional_party`, `remove_additional_party` |
 | Tasks | `list_tasks`, `get_task`, `get_tasks` | `create_task`, `update_task`, `complete_task`, `delete_task` |
 | Entries (notes / captured emails) | `get_entry`, `list_entries` | `add_note`, `update_entry`, `delete_entry` |
@@ -64,12 +64,12 @@ That's it. The first launch fetches the package from npm (a few seconds); subseq
 | Audit (deleted records) | `list_deleted_parties`, `list_deleted_opportunities`, `list_deleted_projects` | — |
 | Pipelines & milestones (opportunities) | `list_pipelines`, `list_milestones` | — |
 | Boards & stages (projects) | `list_boards`, `list_stages` | — |
-| Tracks (workflow instances) | `list_track_definitions`, `list_entity_tracks`, `show_track` | `apply_track`, `update_track`, `remove_track` |
+| Tracks (workflow instances) | `list_track_definitions`, `list_entity_tracks`, `get_track` | `apply_track`, `update_track`, `remove_track` |
 | Saved filters | `list_saved_filters`, `run_saved_filter` | — |
 | Custom fields (schema) | `list_custom_fields`, `get_custom_field` | — |
 | Tags | `list_tags` | `add_tag`, `remove_tag_by_id`, `delete_tag_definition` |
 | Users & teams | `list_users`, `get_current_user`, `list_teams` | — |
-| Reference metadata | `list_lostreasons`, `list_activitytypes`, `list_categories`, `list_goals`, `get_site` | — |
+| Reference metadata | `list_lost_reasons`, `list_activity_types`, `list_categories`, `list_goals`, `get_site` | — |
 
 Most record-list tools default `perPage=25`; reference-data tools default `perPage=100` so small accounts usually fit in one response. All paginated tools cap `perPage` at 100 and return a `nextPage` cursor when more results exist. Many GET tools accept an `embed` parameter (e.g. `tags,fields`) — see Capsule's API docs for the full list per resource.
 

package/dist/http.js

@@ -156,6 +156,26 @@ function invalidateByPrefix(pathPrefix, trigger) {
   }
 }
 
+// src/capsule/normalize.ts
+var KEY_RENAMES = {
+  kase: "project",
+  kases: "projects",
+  restrictedKases: "restrictedProjects"
+};
+function normalizeProjectKeys(value) {
+  if (Array.isArray(value)) {
+    return value.map(normalizeProjectKeys);
+  }
+  if (value !== null && typeof value === "object") {
+    const out = {};
+    for (const [key, v] of Object.entries(value)) {
+      out[KEY_RENAMES[key] ?? key] = normalizeProjectKeys(v);
+    }
+    return out;
+  }
+  return value;
+}
+
 // src/capsule/client.ts
 var DEFAULT_BASE_URL = "https://api.capsulecrm.com/api/v2";
 function baseUrl() {
@@ -427,7 +447,8 @@ async function throwForStatus(res) {
 }
 async function handleResponse(res) {
   await throwForStatus(res);
-  return mapAbort(res.json());
+  const body = await mapAbort(res.json());
+  return normalizeProjectKeys(body);
 }
 function buildUrl(path, params) {
   const url = new URL(`${baseUrl()}${path}`);
@@ -1154,6 +1175,7 @@ var CORE_TOOLS = /* @__PURE__ */ new Set([
   "create_opportunity",
   "update_opportunity",
   // Projects
+  "search_projects",
   "filter_projects",
   "list_projects",
   "get_project",
@@ -1651,10 +1673,6 @@ function defineBatch(args) {
   return { schema, handler };
 }
 
-// src/tools/descriptions.ts
-var EMBED_TAGS_FIELDS_DESCRIPTION = "Comma-separated embeds, e.g. 'tags,fields'";
-var EMBED_ATTACHMENTS_PARTICIPANTS_DESCRIPTION = "Comma-separated embeds, e.g. 'attachments,participants'";
-
 // src/tools/define-delete.ts
 import { z as z6 } from "zod";
 
@@ -1680,6 +1698,26 @@ var paginationFieldsNoDefaults = {
   page: z5.number().int().positive().optional(),
   perPage: z5.number().int().min(1).max(100).optional()
 };
+var ENTITY_PATH = {
+  parties: "parties",
+  opportunities: "opportunities",
+  projects: "kases"
+};
+function embedParam(allowed) {
+  return z5.string().superRefine((value, ctx) => {
+    const tokens = value.split(",").map((t) => t.trim());
+    for (const token of tokens) {
+      if (token === "" || !allowed.includes(token)) {
+        ctx.addIssue({
+          code: "custom",
+          message: `Unknown embed token '${token}'. Valid tokens: ${allowed.join(", ")} (comma-separated). Capsule silently ignores unknown tokens, so this is rejected client-side to prevent silently-missing data.`
+        });
+      }
+    }
+  }).describe(`Comma-separated embeds. Valid tokens: ${allowed.join(", ")}.`).optional();
+}
+var RECORD_EMBEDS = ["tags", "fields", "missingImportantFields"];
+var ENTRY_EMBEDS = ["attachments", "participants"];
 
 // src/capsule/idempotent.ts
 var isCapsule404 = (err) => err instanceof CapsuleApiError && err.status === 404;
@@ -1844,7 +1882,7 @@ var WebsiteSchema = z8.object({
 }).superRefine(validateWebsiteAddress);
 var searchPartiesSchema = z8.object({
   q: z8.string().optional().describe("Free-text search query"),
-  embed: z8.string().optional().describe(EMBED_TAGS_FIELDS_DESCRIPTION),
+  embed: embedParam(RECORD_EMBEDS),
   ...paginationFields
 });
 async function searchParties(input) {
@@ -1858,7 +1896,7 @@ async function searchParties(input) {
 }
 var getPartySchema = z8.object({
   id: positiveId.describe("Party ID"),
-  embed: z8.string().optional().describe(EMBED_TAGS_FIELDS_DESCRIPTION)
+  embed: embedParam(RECORD_EMBEDS)
 });
 async function getParty(input) {
   const { data } = await capsuleGet(`/parties/${input.id}`, {
@@ -1870,7 +1908,7 @@ var getPartiesSchema = z8.object({
   ids: z8.array(positiveId).min(1).max(50).describe(
     "Array of party IDs (1\u201350). Capsule's native batch-fetch endpoint caps at 10 per request; the connector transparently splits larger sets into 10-id chunks and fans out the Capsule calls in parallel. Result shape is identical regardless of input size."
   ),
-  embed: z8.string().optional().describe(EMBED_TAGS_FIELDS_DESCRIPTION)
+  embed: embedParam(RECORD_EMBEDS)
 });
 async function getParties(input) {
   return chunkedMultiGet("/parties", "parties", input.ids, { embed: input.embed });
@@ -1936,6 +1974,21 @@ var createPartySchema = z8.object({
   fields: z8.array(CustomFieldWriteSchema).optional().describe(
     fieldsArrayDescriptor("get_party") + " Verified empirically in v1.6.5 wire-trace: Capsule's POST /parties accepts the same `fields[]` shape as PUT, so callers can set custom field values on creation without a follow-up update."
   )
+}).superRefine((data, ctx) => {
+  if (data.type === "person" && !data.firstName && !data.lastName) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["firstName"],
+      message: "create_party: a person requires firstName and/or lastName"
+    });
+  }
+  if (data.type === "organisation" && !data.name) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["name"],
+      message: "create_party: an organisation requires name"
+    });
+  }
 });
 async function createParty(input) {
   const { ownerId, teamId, organisationId, fields, ...rest } = input;
@@ -1986,7 +2039,7 @@ var { schema: batchUpdatePartySchema, handler: batchUpdateParty } = defineBatch(
 var { schema: deletePartySchema, handler: deleteParty } = defineDelete({
   toolName: "delete_party",
   pathPrefix: "/parties",
-  confirmHint: "Must be set to true. Deletes the party AND all linked notes, tasks, opportunities, and projects (kases). Deleting an ORGANISATION does NOT delete people linked to it via organisationId \u2014 their `organisation` field is silently cleared to null and they survive as standalone records. Irreversible."
+  confirmHint: "Must be set to true. Deletes the party AND all linked notes, tasks, opportunities, and projects. Deleting an ORGANISATION does NOT delete people linked to it via organisationId \u2014 their `organisation` field is silently cleared to null and they survive as standalone records. Irreversible."
 });
 function definePartySubResourceRemove(opts) {
   const shape = {
@@ -2121,7 +2174,7 @@ var OpportunityValueSchema = z9.object({
 });
 var searchOpportunitiesSchema = z9.object({
   q: z9.string().optional().describe("Free-text search query"),
-  embed: z9.string().optional().describe(EMBED_TAGS_FIELDS_DESCRIPTION),
+  embed: embedParam(RECORD_EMBEDS),
   ...paginationFields
 });
 async function searchOpportunities(input) {
@@ -2135,7 +2188,7 @@ async function searchOpportunities(input) {
 }
 var getOpportunitySchema = z9.object({
   id: positiveId,
-  embed: z9.string().optional().describe(EMBED_TAGS_FIELDS_DESCRIPTION)
+  embed: embedParam(RECORD_EMBEDS)
 });
 async function getOpportunity(input) {
   const { data } = await capsuleGet(`/opportunities/${input.id}`, {
@@ -2147,7 +2200,7 @@ var getOpportunitiesSchema = z9.object({
   ids: z9.array(positiveId).min(1).max(50).describe(
     "Array of opportunity IDs (1\u201350). Capsule's native batch-fetch endpoint caps at 10 per request; the connector transparently splits larger sets into 10-id chunks and fans out the Capsule calls in parallel."
   ),
-  embed: z9.string().optional().describe(EMBED_TAGS_FIELDS_DESCRIPTION)
+  embed: embedParam(RECORD_EMBEDS)
 });
 async function getOpportunities(input) {
   return chunkedMultiGet("/opportunities", "opportunities", input.ids, { embed: input.embed });
@@ -2201,7 +2254,7 @@ var updateOpportunitySchema = z9.object({
     "Win probability 0\u2013100. On an open milestone this overrides the milestone's default probability. CANNOT be set in the same call as a closing milestone (Won/Lost) \u2014 Capsule processes the milestone change first, the opportunity becomes closed, then the probability update is rejected as edit-on-closed-opp with 422 'probability can be updated only for open opportunity'. To close an opportunity, leave probability out of the call: it auto-snaps to 100% (Won) or 0% (Lost)."
   ),
   lostReasonId: positiveId.optional().describe(
-    "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."
+    "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_lost_reasons."
   ),
   ownerId: positiveId.nullable().optional().describe(
     "Reassign owner: pass a user ID to set, or `null` to unassign (verified empirically in v1.6.5 wire-trace \u2014 Capsule accepts `owner: null` on PUT /opportunities/:id, mirroring the v1.6.4 finding on /parties; brings update_opportunity into parity with update_party and update_project). 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. Combine `ownerId: null` + `teamId: <T>` in one call to transfer an opportunity to team-ownership with no specific user (verified empirically in v1.6.5; the owner-clears-team semantic doesn't fire when owner is being cleared to null)."
@@ -2246,9 +2299,23 @@ var { schema: deleteOpportunitySchema, handler: deleteOpportunity } = defineDele
 
 // src/tools/projects.ts
 import { z as z10 } from "zod";
+var searchProjectsSchema = z10.object({
+  q: z10.string().optional().describe("Free-text search query"),
+  embed: embedParam(RECORD_EMBEDS),
+  ...paginationFields
+});
+async function searchProjects(input) {
+  const path = input.q ? "/kases/search" : "/kases";
+  return capsuleGetList(path, {
+    q: input.q,
+    embed: input.embed,
+    page: input.page,
+    perPage: input.perPage
+  });
+}
 var listProjectsSchema = z10.object({
   status: z10.enum(["OPEN", "CLOSED"]).optional(),
-  embed: z10.string().optional().describe(EMBED_TAGS_FIELDS_DESCRIPTION),
+  embed: embedParam(RECORD_EMBEDS),
   ...paginationFields
 });
 async function listProjects(input) {
@@ -2261,7 +2328,7 @@ async function listProjects(input) {
 }
 var getProjectSchema = z10.object({
   id: positiveId,
-  embed: z10.string().optional().describe(EMBED_TAGS_FIELDS_DESCRIPTION)
+  embed: embedParam(RECORD_EMBEDS)
 });
 async function getProject(input) {
   const { data } = await capsuleGet(`/kases/${input.id}`, {
@@ -2273,10 +2340,10 @@ var getProjectsSchema = z10.object({
   ids: z10.array(positiveId).min(1).max(50).describe(
     "Array of project IDs (1\u201350). Capsule's native batch-fetch endpoint caps at 10 per request; the connector transparently splits larger sets into 10-id chunks and fans out the Capsule calls in parallel."
   ),
-  embed: z10.string().optional().describe(EMBED_TAGS_FIELDS_DESCRIPTION)
+  embed: embedParam(RECORD_EMBEDS)
 });
 async function getProjects(input) {
-  return chunkedMultiGet("/kases", "kases", input.ids, { embed: input.embed });
+  return chunkedMultiGet("/kases", "projects", input.ids, { embed: input.embed });
 }
 var createProjectSchema = z10.object({
   name: z10.string().min(1),
@@ -2343,7 +2410,7 @@ async function updateProject(input) {
   let resolvedTeamId = teamId;
   let resolvedStageId = stageId;
   if (ownerId !== void 0 && (teamId === void 0 || stageId === void 0)) {
-    const current = await readEntityRefs(`/kases/${id}`, "kase");
+    const current = await readEntityRefs(`/kases/${id}`, "project");
     if (teamId === void 0) resolvedTeamId = current.teamId;
     if (stageId === void 0) resolvedStageId = current.stageId;
   }
@@ -2494,7 +2561,7 @@ var { schema: deleteTaskSchema, handler: deleteTask } = defineDelete({
 import { z as z12 } from "zod";
 var listEntriesPagination = {
   ...paginationFields,
-  embed: z12.string().optional().describe(EMBED_ATTACHMENTS_PARTICIPANTS_DESCRIPTION)
+  embed: embedParam(ENTRY_EMBEDS)
 };
 var listPartyEntriesSchema = z12.object({
   partyId: positiveId,
@@ -2602,7 +2669,7 @@ async function listProjectEntries(input) {
 }
 var getEntrySchema = z12.object({
   id: positiveId,
-  embed: z12.string().optional().describe(EMBED_ATTACHMENTS_PARTICIPANTS_DESCRIPTION)
+  embed: embedParam(ENTRY_EMBEDS)
 });
 async function getEntry(input) {
   const { data } = await capsuleGet(`/entries/${input.id}`, {
@@ -2715,16 +2782,16 @@ import { z as z15 } from "zod";
 var TAG_LIST_PATH = {
   parties: "/parties/tags",
   opportunities: "/opportunities/tags",
-  kases: "/kases/tags"
+  projects: "/kases/tags"
 };
 var ENTITY_TO_WRAPPER = {
   parties: "party",
   opportunities: "opportunity",
-  kases: "kase"
+  projects: "kase"
 };
-var TagEntity = z15.enum(["parties", "opportunities", "kases"]).describe("Which entity type. Use 'kases' for projects (Capsule's legacy path name).");
+var TagEntity = z15.enum(["parties", "opportunities", "projects"]).describe("Which entity type.");
 var listTagsSchema = z15.object({
-  entity: z15.enum(["parties", "opportunities", "kases"]).describe("The resource type to list tags for"),
+  entity: z15.enum(["parties", "opportunities", "projects"]).describe("The resource type to list tags for"),
   ...paginationFieldsNoDefaults
 });
 async function listTags(input) {
@@ -2744,7 +2811,7 @@ var addTagSchema = z15.object({
 async function addTag(input) {
   const { entity, entityId, tagName } = input;
   const wrapper = ENTITY_TO_WRAPPER[entity];
-  const result = await capsulePut(`/${entity}/${entityId}`, {
+  const result = await capsulePut(`/${ENTITY_PATH[entity]}/${entityId}`, {
     [wrapper]: { tags: [{ name: tagName }] }
   });
   invalidateByPrefix(TAG_LIST_PATH[entity], "add_tag");
@@ -2761,7 +2828,7 @@ async function removeTagById(input) {
   const { entity, entityId, tagId } = input;
   const wrapper = ENTITY_TO_WRAPPER[entity];
   const result = await idempotentWithResult(
-    () => capsulePut(`/${entity}/${entityId}`, {
+    () => capsulePut(`/${ENTITY_PATH[entity]}/${entityId}`, {
       [wrapper]: { tags: [{ id: tagId, _delete: true }] }
     }),
     (result2) => ({
@@ -2796,7 +2863,7 @@ async function deleteTagDefinition(input) {
     throw new Error("delete_tag_definition requires confirm: true");
   }
   const result = await idempotent(
-    () => capsuleDelete(`/${entity}/tags/${tagId}`),
+    () => capsuleDelete(`/${ENTITY_PATH[entity]}/tags/${tagId}`),
     () => ({ deleted: true, alreadyDeleted: false, entity, tagId }),
     () => ({ deleted: true, alreadyDeleted: true, entity, tagId })
   );
@@ -2850,7 +2917,7 @@ var FilterInputSchema = z17.object({
   conditions: z17.array(FilterConditionSchema).min(1).describe(
     "Array of filter conditions. All conditions are ANDed together. To get newest records, use a date condition like {field: 'addedOn', operator: 'is within last', value: 7} and pick the highest-id row from the result (Capsule IDs are monotonic)."
   ),
-  embed: z17.string().optional().describe(EMBED_TAGS_FIELDS_DESCRIPTION),
+  embed: embedParam(RECORD_EMBEDS),
   ...paginationFields
 });
 async function runFilter(entityPath, input) {
@@ -2941,7 +3008,7 @@ var listEmployeesSchema = z19.object({
     "The organisation's party id. Returns the people whose `organisation` field links to this party."
   ),
   ...paginationFields,
-  embed: z19.string().optional().describe(EMBED_TAGS_FIELDS_DESCRIPTION)
+  embed: embedParam(RECORD_EMBEDS)
 });
 async function listEmployees(input) {
   return capsuleGetList(`/parties/${input.partyId}/people`, {
@@ -2984,19 +3051,22 @@ async function listDeletedProjects(input) {
 
 // src/tools/relationships.ts
 import { z as z20 } from "zod";
-var RelationshipEntity = z20.enum(["opportunities", "kases"]).describe("Which entity has the additional-party links. Use 'kases' for projects.");
+var RelationshipEntity = z20.enum(["opportunities", "projects"]).describe("Which entity has the additional-party links.");
 var listAdditionalPartiesSchema = z20.object({
   entity: RelationshipEntity,
   entityId: positiveId.describe("ID of the opportunity or project."),
-  embed: z20.string().optional().describe(EMBED_TAGS_FIELDS_DESCRIPTION),
+  embed: embedParam(RECORD_EMBEDS),
   ...paginationFields
 });
 async function listAdditionalParties(input) {
-  return capsuleGetList(`/${input.entity}/${input.entityId}/parties`, {
-    embed: input.embed,
-    page: input.page,
-    perPage: input.perPage
-  });
+  return capsuleGetList(
+    `/${ENTITY_PATH[input.entity]}/${input.entityId}/parties`,
+    {
+      embed: input.embed,
+      page: input.page,
+      perPage: input.perPage
+    }
+  );
 }
 var addAdditionalPartySchema = z20.object({
   entity: RelationshipEntity,
@@ -3007,7 +3077,9 @@ var addAdditionalPartySchema = z20.object({
 });
 async function addAdditionalParty(input) {
   try {
-    await capsulePostNoContent(`/${input.entity}/${input.entityId}/parties/${input.partyId}`);
+    await capsulePostNoContent(
+      `/${ENTITY_PATH[input.entity]}/${input.entityId}/parties/${input.partyId}`
+    );
     return {
       linked: true,
       alreadyLinked: false,
@@ -3044,7 +3116,7 @@ async function removeAdditionalParty(input) {
     throw new Error("remove_additional_party requires confirm: true");
   }
   return idempotent(
-    () => capsuleDelete(`/${input.entity}/${input.entityId}/parties/${input.partyId}`),
+    () => capsuleDelete(`/${ENTITY_PATH[input.entity]}/${input.entityId}/parties/${input.partyId}`),
     () => ({
       removed: true,
       alreadyRemoved: false,
@@ -3063,7 +3135,7 @@ async function removeAdditionalParty(input) {
 }
 var listAssociatedProjectsSchema = z20.object({
   opportunityId: positiveId,
-  embed: z20.string().optional().describe(EMBED_TAGS_FIELDS_DESCRIPTION),
+  embed: embedParam(RECORD_EMBEDS),
   ...paginationFields
 });
 async function listAssociatedProjects(input) {
@@ -3076,49 +3148,49 @@ async function listAssociatedProjects(input) {
 
 // src/tools/custom-fields.ts
 import { z as z21 } from "zod";
-var CustomFieldEntity = z21.enum(["parties", "opportunities", "kases"]).describe("Which entity type's custom field schema to inspect. Use 'kases' for projects.");
+var CustomFieldEntity = z21.enum(["parties", "opportunities", "projects"]).describe("Which entity type's custom field schema to inspect.");
 var listCustomFieldsSchema = z21.object({
   entity: CustomFieldEntity
 });
 async function listCustomFields(input) {
   const { data } = await capsuleGetCached(
-    `/${input.entity}/fields/definitions`
+    `/${ENTITY_PATH[input.entity]}/fields/definitions`
   );
   return data;
 }
 var getCustomFieldSchema = z21.object({
   entity: CustomFieldEntity,
-  fieldId: positiveId.describe("Custom field definition id.")
+  id: positiveId.describe("Custom field definition id.")
 });
 async function getCustomField(input) {
   const { data } = await capsuleGetCached(
-    `/${input.entity}/fields/definitions/${input.fieldId}`
+    `/${input.entity}/fields/definitions/${input.id}`
   );
   return data;
 }
 
 // src/tools/tracks.ts
 import { z as z22 } from "zod";
-var TrackEntity = z22.enum(["parties", "opportunities", "kases"]).describe("Use 'kases' for projects.");
+var TrackEntity = z22.enum(["parties", "opportunities", "projects"]).describe("Which entity type.");
 var listEntityTracksSchema = z22.object({
   entity: TrackEntity,
   entityId: positiveId
 });
 async function listEntityTracks(input) {
   const { data } = await capsuleGet(
-    `/${input.entity}/${input.entityId}/tracks`
+    `/${ENTITY_PATH[input.entity]}/${input.entityId}/tracks`
   );
   return data;
 }
-var showTrackSchema = z22.object({
-  trackId: positiveId
+var getTrackSchema = z22.object({
+  id: positiveId
 });
-async function showTrack(input) {
-  const { data } = await capsuleGet(`/tracks/${input.trackId}`);
+async function getTrack(input) {
+  const { data } = await capsuleGet(`/tracks/${input.id}`);
   return data;
 }
 var applyTrackSchema = z22.object({
-  entity: z22.enum(["opportunities", "kases"]).describe("Which entity to apply the track to. Use 'kases' for projects."),
+  entity: z22.enum(["opportunities", "projects"]).describe("Which entity to apply the track to."),
   entityId: positiveId,
   trackDefinitionId: positiveId.describe(
     "The trackDefinition to apply (from list_track_definitions). Auto-creates task definitions on the target entity per the track's rules."
@@ -3137,7 +3209,7 @@ async function applyTrack(input) {
   return capsulePost("/tracks", { track });
 }
 var updateTrackSchema = z22.object({
-  trackId: positiveId,
+  id: positiveId,
   fields: z22.record(z22.string(), z22.unknown()).describe(
     "Object of fields to update on the track. Capsule's PUT semantics are partial \u2014 only the fields you provide are changed. Common: { complete: true } to mark a track completed. Capsule rejects unknown keys; consult Capsule's docs for the full updatable set."
   )
@@ -3146,12 +3218,12 @@ async function updateTrack(input) {
   if (Object.keys(input.fields).length === 0) {
     throw new Error("update_track: provide at least one field in `fields`");
   }
-  return capsulePut(`/tracks/${input.trackId}`, {
+  return capsulePut(`/tracks/${input.id}`, {
     track: input.fields
   });
 }
 var removeTrackSchema = z22.object({
-  trackId: positiveId,
+  id: positiveId,
   confirm: confirmFlag().describe(
     "Must be set to true. Removes the track instance from its entity. **Capsule also deletes the auto-tasks the track created when it was applied** \u2014 they go with the track and become unreachable (404 on GET /tasks/{id}, gone from list_tasks on the parent entity). If you need any of those tasks to outlive the track, copy their content into fresh tasks (or use the web UI) before calling remove_track."
   )
@@ -3161,9 +3233,9 @@ async function removeTrack(input) {
     throw new Error("remove_track requires confirm: true");
   }
   return idempotent(
-    () => capsuleDelete(`/tracks/${input.trackId}`),
-    () => ({ removed: true, alreadyRemoved: false, trackId: input.trackId }),
-    () => ({ removed: true, alreadyRemoved: true, trackId: input.trackId })
+    () => capsuleDelete(`/tracks/${input.id}`),
+    () => ({ removed: true, alreadyRemoved: false, id: input.id }),
+    () => ({ removed: true, alreadyRemoved: true, id: input.id })
   );
 }
 
@@ -3250,28 +3322,31 @@ async function uploadAttachment(input) {
 
 // src/tools/saved-filters.ts
 import { z as z24 } from "zod";
-var EntitySchema = z24.enum(["parties", "opportunities", "kases"]).describe(
-  "Which entity type the filter operates over. Use 'kases' for projects (Capsule's legacy name)."
-);
+var EntitySchema = z24.enum(["parties", "opportunities", "projects"]).describe("Which entity type the filter operates over.");
 var listSavedFiltersSchema = z24.object({
   entity: EntitySchema
 });
 async function listSavedFilters(input) {
-  const { data } = await capsuleGetCached(`/${input.entity}/filters`);
+  const { data } = await capsuleGetCached(
+    `/${ENTITY_PATH[input.entity]}/filters`
+  );
   return data;
 }
 var runSavedFilterSchema = z24.object({
   entity: EntitySchema,
   id: positiveId.describe("The saved filter id (from list_saved_filters)."),
-  embed: z24.string().optional().describe(EMBED_TAGS_FIELDS_DESCRIPTION),
+  embed: embedParam(RECORD_EMBEDS),
   ...paginationFields
 });
 async function runSavedFilter(input) {
-  return capsuleGetList(`/${input.entity}/filters/${input.id}/results`, {
-    page: input.page,
-    perPage: input.perPage,
-    embed: input.embed
-  });
+  return capsuleGetList(
+    `/${ENTITY_PATH[input.entity]}/filters/${input.id}/results`,
+    {
+      page: input.page,
+      perPage: input.perPage,
+      embed: input.embed
+    }
+  );
 }
 
 // src/server.ts
@@ -3282,7 +3357,7 @@ function createCapsuleMcpServer(opts) {
   const server = new McpServer(
     {
       name: "capsulemcp",
-      version: "1.8.1",
+      version: "2.0.0",
       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
@@ -3399,7 +3474,7 @@ function createCapsuleMcpServer(opts) {
     registerTool(
       server,
       "delete_party",
-      "DESTRUCTIVE & IRREVERSIBLE: permanently delete a party (person or organisation). Cascades to all linked notes, tasks, opportunities, AND projects (kases). Deleting an organisation does NOT delete people linked to it via organisationId \u2014 their `organisation` field is silently cleared to null and they survive as standalone records. TRACK INSTANCES applied to cascaded opportunities/projects are NOT cleaned up either \u2014 they survive as orphan records reachable only by track id via show_track. Use remove_track on each track explicitly before deleting the parent party if orphan accumulation matters (rare in practice \u2014 orphans are unreachable from normal navigation). Requires confirm=true. Always read the party first with get_party and confirm with the user before calling. Idempotent on retry: response is `{deleted: true, alreadyDeleted: false, id}` on a fresh delete or `{deleted: true, alreadyDeleted: true, id}` if the party was already gone (Capsule's 404 is caught internally so reconciliation loops can re-issue safely).",
+      "DESTRUCTIVE & IRREVERSIBLE: permanently delete a party (person or organisation). Cascades to all linked notes, tasks, opportunities, AND projects. Deleting an organisation does NOT delete people linked to it via organisationId \u2014 their `organisation` field is silently cleared to null and they survive as standalone records. TRACK INSTANCES applied to cascaded opportunities/projects are NOT cleaned up either \u2014 they survive as orphan records reachable only by track id via get_track. Use remove_track on each track explicitly before deleting the parent party if orphan accumulation matters (rare in practice \u2014 orphans are unreachable from normal navigation). Requires confirm=true. Always read the party first with get_party and confirm with the user before calling. Idempotent on retry: response is `{deleted: true, alreadyDeleted: false, id}` on a fresh delete or `{deleted: true, alreadyDeleted: true, id}` if the party was already gone (Capsule's 404 is caught internally so reconciliation loops can re-issue safely).",
       deletePartySchema,
       deleteParty
     );
@@ -3498,7 +3573,7 @@ function createCapsuleMcpServer(opts) {
   registerTool(
     server,
     "list_additional_parties",
-    "List secondary party links on an opportunity or project. The 'main' party is on the entity itself (opportunity.party); additional parties are e.g. partners, consultants, or referrers also involved in the deal. Set entity to 'opportunities' or 'kases' (Capsule's term for projects).",
+    "List secondary party links on an opportunity or project. The 'main' party is on the entity itself (opportunity.party); additional parties are e.g. partners, consultants, or referrers also involved in the deal. Set entity to 'opportunities' or 'projects'.",
     listAdditionalPartiesSchema,
     listAdditionalParties
   );
@@ -3539,10 +3614,17 @@ function createCapsuleMcpServer(opts) {
       deleteOpportunity
     );
   }
+  registerTool(
+    server,
+    "search_projects",
+    "Free-text search projects in Capsule CRM (matches name and description). Returns results in Capsule's default order (no sort parameter is supported here). Omit `q` to list all projects. For structured queries \u2014 'most recent project', 'projects opened this month', 'projects tagged X' \u2014 use filter_projects instead.",
+    searchProjectsSchema,
+    searchProjects
+  );
   registerTool(
     server,
     "list_projects",
-    "List projects (cases) in Capsule CRM, optionally filtered by status. Returns results in Capsule's default order (no sort parameter is supported here). For structured queries \u2014 'most recent project', 'projects opened this month', 'projects tagged X' \u2014 use filter_projects instead.",
+    "List projects (cases) in Capsule CRM, optionally filtered by status. Returns results in Capsule's default order (no sort parameter is supported here). For free-text matching use search_projects; for structured queries \u2014 'most recent project', 'projects opened this month', 'projects tagged X' \u2014 use filter_projects instead.",
     listProjectsSchema,
     listProjects
   );
@@ -3570,7 +3652,7 @@ function createCapsuleMcpServer(opts) {
   registerTool(
     server,
     "list_deleted_projects",
-    "Audit feature: list projects deleted on or after a given timestamp. The `since` parameter is REQUIRED. Response also includes a `restrictedKases` key for records the integration user can't read fully.",
+    "Audit feature: list projects deleted on or after a given timestamp. The `since` parameter is REQUIRED. Response also includes a `restrictedProjects` key for records the integration user can't read fully.",
     listDeletedProjectsSchema,
     listDeletedProjects
   );
@@ -3885,14 +3967,14 @@ function createCapsuleMcpServer(opts) {
   );
   registerTool(
     server,
-    "list_lostreasons",
+    "list_lost_reasons",
     "List all configured opportunity-loss reasons (e.g. 'Poor Qualification', 'Lost to competitor', 'Price too high'). Returns each reason's id and name; the set is account-configured rather than a fixed enum, so call this to discover valid ids before referencing a lostReason in update_opportunity when closing a deal as lost. Useful for analysing closed-lost opportunities by reason.",
     listLostReasonsSchema,
     listLostReasons
   );
   registerTool(
     server,
-    "list_activitytypes",
+    "list_activity_types",
     "List all configured activity types (e.g. Call, Meeting, Email). These are the categories used when logging timeline entries via add_note. Returns each type's id and name. The set is account-configured rather than a fixed enum, so call this to discover valid values before referencing an activityType in entry creation.",
     listActivityTypesSchema,
     listActivityTypes
@@ -3920,10 +4002,10 @@ function createCapsuleMcpServer(opts) {
   );
   registerTool(
     server,
-    "show_track",
+    "get_track",
     "Fetch a single track instance by id. Returns the minimal Capsule projection: id, description, trackDateOn, direction, and the array of tasks attached to the track. Capsule's GET /tracks/{id} does NOT include a trackDefinition link, an entity reference, or a completion field \u2014 to find the entity a track is applied to, use list_entity_tracks (which lists track instances by their parent entity); to check completion, the track-tasks' own statuses are the proxy.",
-    showTrackSchema,
-    showTrack
+    getTrackSchema,
+    getTrack
   );
   registerTool(
     server,
@@ -3956,7 +4038,7 @@ function createCapsuleMcpServer(opts) {
   registerTool(
     server,
     "list_tags",
-    "List all tags available for a given entity type (parties, opportunities, or kases). Returns each tag's id, name, and any data-tag field schema. Tags are entity-specific \u2014 a party tag is not interchangeable with an opportunity tag. Use this to discover valid tag ids before calling add_tag, or to display the tag catalogue to the user when they ask 'what tags do we use?'",
+    "List all tags available for a given entity type (parties, opportunities, or projects). Returns each tag's id, name, and any data-tag field schema. Tags are entity-specific \u2014 a party tag is not interchangeable with an opportunity tag. Use this to discover valid tag ids before calling add_tag, or to display the tag catalogue to the user when they ask 'what tags do we use?'",
     listTagsSchema,
     listTags
   );
@@ -3978,7 +4060,7 @@ function createCapsuleMcpServer(opts) {
     registerTool(
       server,
       "delete_tag_definition",
-      "DESTRUCTIVE & TENANT-WIDE: permanently delete a tag DEFINITION from an entity type's tag namespace (parties / opportunities / kases). Unlike remove_tag_by_id \u2014 which detaches a tag from ONE record and leaves the definition intact for others \u2014 this removes the definition itself, so the tag disappears from EVERY record that shared it. Use it to clean up stray / mistyped / test tag definitions polluting the tenant-global list. Requires confirm=true. Always read the affected tag first via list_tags and confirm with the user; if you only want to untag one record, use remove_tag_by_id instead. Irreversible (re-creating by name via add_tag mints a brand-new id). Idempotent on retry: `{deleted: true, alreadyDeleted: false, entity, tagId}` on a fresh delete, or `{deleted: true, alreadyDeleted: true, entity, tagId}` if the definition was already gone (Capsule's 404 is caught). Endpoint verified empirically (DELETE /<entity>/tags/{id} \u2192 204).",
+      "DESTRUCTIVE & TENANT-WIDE: permanently delete a tag DEFINITION from an entity type's tag namespace (parties / opportunities / projects). Unlike remove_tag_by_id \u2014 which detaches a tag from ONE record and leaves the definition intact for others \u2014 this removes the definition itself, so the tag disappears from EVERY record that shared it. Use it to clean up stray / mistyped / test tag definitions polluting the tenant-global list. Requires confirm=true. Always read the affected tag first via list_tags and confirm with the user; if you only want to untag one record, use remove_tag_by_id instead. Irreversible (re-creating by name via add_tag mints a brand-new id). Idempotent on retry: `{deleted: true, alreadyDeleted: false, entity, tagId}` on a fresh delete, or `{deleted: true, alreadyDeleted: true, entity, tagId}` if the definition was already gone (Capsule's 404 is caught). Endpoint verified empirically (DELETE /<entity>/tags/{id} \u2192 204).",
       deleteTagDefinitionSchema,
       deleteTagDefinition
     );

package/dist/index.js

@@ -138,6 +138,26 @@ function invalidateByPrefix(pathPrefix, trigger) {
   }
 }
 
+// src/capsule/normalize.ts
+var KEY_RENAMES = {
+  kase: "project",
+  kases: "projects",
+  restrictedKases: "restrictedProjects"
+};
+function normalizeProjectKeys(value) {
+  if (Array.isArray(value)) {
+    return value.map(normalizeProjectKeys);
+  }
+  if (value !== null && typeof value === "object") {
+    const out = {};
+    for (const [key, v] of Object.entries(value)) {
+      out[KEY_RENAMES[key] ?? key] = normalizeProjectKeys(v);
+    }
+    return out;
+  }
+  return value;
+}
+
 // src/capsule/client.ts
 var DEFAULT_BASE_URL = "https://api.capsulecrm.com/api/v2";
 function baseUrl() {
@@ -409,7 +429,8 @@ async function throwForStatus(res) {
 }
 async function handleResponse(res) {
   await throwForStatus(res);
-  return mapAbort(res.json());
+  const body = await mapAbort(res.json());
+  return normalizeProjectKeys(body);
 }
 function buildUrl(path, params) {
   const url = new URL(`${baseUrl()}${path}`);
@@ -651,6 +672,7 @@ var CORE_TOOLS = /* @__PURE__ */ new Set([
   "create_opportunity",
   "update_opportunity",
   // Projects
+  "search_projects",
   "filter_projects",
   "list_projects",
   "get_project",
@@ -1148,10 +1170,6 @@ function defineBatch(args) {
   return { schema, handler };
 }
 
-// src/tools/descriptions.ts
-var EMBED_TAGS_FIELDS_DESCRIPTION = "Comma-separated embeds, e.g. 'tags,fields'";
-var EMBED_ATTACHMENTS_PARTICIPANTS_DESCRIPTION = "Comma-separated embeds, e.g. 'attachments,participants'";
-
 // src/tools/define-delete.ts
 import { z as z5 } from "zod";
 
@@ -1177,6 +1195,26 @@ var paginationFieldsNoDefaults = {
   page: z4.number().int().positive().optional(),
   perPage: z4.number().int().min(1).max(100).optional()
 };
+var ENTITY_PATH = {
+  parties: "parties",
+  opportunities: "opportunities",
+  projects: "kases"
+};
+function embedParam(allowed) {
+  return z4.string().superRefine((value, ctx) => {
+    const tokens = value.split(",").map((t) => t.trim());
+    for (const token of tokens) {
+      if (token === "" || !allowed.includes(token)) {
+        ctx.addIssue({
+          code: "custom",
+          message: `Unknown embed token '${token}'. Valid tokens: ${allowed.join(", ")} (comma-separated). Capsule silently ignores unknown tokens, so this is rejected client-side to prevent silently-missing data.`
+        });
+      }
+    }
+  }).describe(`Comma-separated embeds. Valid tokens: ${allowed.join(", ")}.`).optional();
+}
+var RECORD_EMBEDS = ["tags", "fields", "missingImportantFields"];
+var ENTRY_EMBEDS = ["attachments", "participants"];
 
 // src/capsule/idempotent.ts
 var isCapsule404 = (err) => err instanceof CapsuleApiError && err.status === 404;
@@ -1341,7 +1379,7 @@ var WebsiteSchema = z7.object({
 }).superRefine(validateWebsiteAddress);
 var searchPartiesSchema = z7.object({
   q: z7.string().optional().describe("Free-text search query"),
-  embed: z7.string().optional().describe(EMBED_TAGS_FIELDS_DESCRIPTION),
+  embed: embedParam(RECORD_EMBEDS),
   ...paginationFields
 });
 async function searchParties(input) {
@@ -1355,7 +1393,7 @@ async function searchParties(input) {
 }
 var getPartySchema = z7.object({
   id: positiveId.describe("Party ID"),
-  embed: z7.string().optional().describe(EMBED_TAGS_FIELDS_DESCRIPTION)
+  embed: embedParam(RECORD_EMBEDS)
 });
 async function getParty(input) {
   const { data } = await capsuleGet(`/parties/${input.id}`, {
@@ -1367,7 +1405,7 @@ var getPartiesSchema = z7.object({
   ids: z7.array(positiveId).min(1).max(50).describe(
     "Array of party IDs (1\u201350). Capsule's native batch-fetch endpoint caps at 10 per request; the connector transparently splits larger sets into 10-id chunks and fans out the Capsule calls in parallel. Result shape is identical regardless of input size."
   ),
-  embed: z7.string().optional().describe(EMBED_TAGS_FIELDS_DESCRIPTION)
+  embed: embedParam(RECORD_EMBEDS)
 });
 async function getParties(input) {
   return chunkedMultiGet("/parties", "parties", input.ids, { embed: input.embed });
@@ -1433,6 +1471,21 @@ var createPartySchema = z7.object({
   fields: z7.array(CustomFieldWriteSchema).optional().describe(
     fieldsArrayDescriptor("get_party") + " Verified empirically in v1.6.5 wire-trace: Capsule's POST /parties accepts the same `fields[]` shape as PUT, so callers can set custom field values on creation without a follow-up update."
   )
+}).superRefine((data, ctx) => {
+  if (data.type === "person" && !data.firstName && !data.lastName) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["firstName"],
+      message: "create_party: a person requires firstName and/or lastName"
+    });
+  }
+  if (data.type === "organisation" && !data.name) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["name"],
+      message: "create_party: an organisation requires name"
+    });
+  }
 });
 async function createParty(input) {
   const { ownerId, teamId, organisationId, fields, ...rest } = input;
@@ -1483,7 +1536,7 @@ var { schema: batchUpdatePartySchema, handler: batchUpdateParty } = defineBatch(
 var { schema: deletePartySchema, handler: deleteParty } = defineDelete({
   toolName: "delete_party",
   pathPrefix: "/parties",
-  confirmHint: "Must be set to true. Deletes the party AND all linked notes, tasks, opportunities, and projects (kases). Deleting an ORGANISATION does NOT delete people linked to it via organisationId \u2014 their `organisation` field is silently cleared to null and they survive as standalone records. Irreversible."
+  confirmHint: "Must be set to true. Deletes the party AND all linked notes, tasks, opportunities, and projects. Deleting an ORGANISATION does NOT delete people linked to it via organisationId \u2014 their `organisation` field is silently cleared to null and they survive as standalone records. Irreversible."
 });
 function definePartySubResourceRemove(opts) {
   const shape = {
@@ -1618,7 +1671,7 @@ var OpportunityValueSchema = z8.object({
 });
 var searchOpportunitiesSchema = z8.object({
   q: z8.string().optional().describe("Free-text search query"),
-  embed: z8.string().optional().describe(EMBED_TAGS_FIELDS_DESCRIPTION),
+  embed: embedParam(RECORD_EMBEDS),
   ...paginationFields
 });
 async function searchOpportunities(input) {
@@ -1632,7 +1685,7 @@ async function searchOpportunities(input) {
 }
 var getOpportunitySchema = z8.object({
   id: positiveId,
-  embed: z8.string().optional().describe(EMBED_TAGS_FIELDS_DESCRIPTION)
+  embed: embedParam(RECORD_EMBEDS)
 });
 async function getOpportunity(input) {
   const { data } = await capsuleGet(`/opportunities/${input.id}`, {
@@ -1644,7 +1697,7 @@ var getOpportunitiesSchema = z8.object({
   ids: z8.array(positiveId).min(1).max(50).describe(
     "Array of opportunity IDs (1\u201350). Capsule's native batch-fetch endpoint caps at 10 per request; the connector transparently splits larger sets into 10-id chunks and fans out the Capsule calls in parallel."
   ),
-  embed: z8.string().optional().describe(EMBED_TAGS_FIELDS_DESCRIPTION)
+  embed: embedParam(RECORD_EMBEDS)
 });
 async function getOpportunities(input) {
   return chunkedMultiGet("/opportunities", "opportunities", input.ids, { embed: input.embed });
@@ -1698,7 +1751,7 @@ var updateOpportunitySchema = z8.object({
     "Win probability 0\u2013100. On an open milestone this overrides the milestone's default probability. CANNOT be set in the same call as a closing milestone (Won/Lost) \u2014 Capsule processes the milestone change first, the opportunity becomes closed, then the probability update is rejected as edit-on-closed-opp with 422 'probability can be updated only for open opportunity'. To close an opportunity, leave probability out of the call: it auto-snaps to 100% (Won) or 0% (Lost)."
   ),
   lostReasonId: positiveId.optional().describe(
-    "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."
+    "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_lost_reasons."
   ),
   ownerId: positiveId.nullable().optional().describe(
     "Reassign owner: pass a user ID to set, or `null` to unassign (verified empirically in v1.6.5 wire-trace \u2014 Capsule accepts `owner: null` on PUT /opportunities/:id, mirroring the v1.6.4 finding on /parties; brings update_opportunity into parity with update_party and update_project). 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. Combine `ownerId: null` + `teamId: <T>` in one call to transfer an opportunity to team-ownership with no specific user (verified empirically in v1.6.5; the owner-clears-team semantic doesn't fire when owner is being cleared to null)."
@@ -1743,9 +1796,23 @@ var { schema: deleteOpportunitySchema, handler: deleteOpportunity } = defineDele
 
 // src/tools/projects.ts
 import { z as z9 } from "zod";
+var searchProjectsSchema = z9.object({
+  q: z9.string().optional().describe("Free-text search query"),
+  embed: embedParam(RECORD_EMBEDS),
+  ...paginationFields
+});
+async function searchProjects(input) {
+  const path = input.q ? "/kases/search" : "/kases";
+  return capsuleGetList(path, {
+    q: input.q,
+    embed: input.embed,
+    page: input.page,
+    perPage: input.perPage
+  });
+}
 var listProjectsSchema = z9.object({
   status: z9.enum(["OPEN", "CLOSED"]).optional(),
-  embed: z9.string().optional().describe(EMBED_TAGS_FIELDS_DESCRIPTION),
+  embed: embedParam(RECORD_EMBEDS),
   ...paginationFields
 });
 async function listProjects(input) {
@@ -1758,7 +1825,7 @@ async function listProjects(input) {
 }
 var getProjectSchema = z9.object({
   id: positiveId,
-  embed: z9.string().optional().describe(EMBED_TAGS_FIELDS_DESCRIPTION)
+  embed: embedParam(RECORD_EMBEDS)
 });
 async function getProject(input) {
   const { data } = await capsuleGet(`/kases/${input.id}`, {
@@ -1770,10 +1837,10 @@ var getProjectsSchema = z9.object({
   ids: z9.array(positiveId).min(1).max(50).describe(
     "Array of project IDs (1\u201350). Capsule's native batch-fetch endpoint caps at 10 per request; the connector transparently splits larger sets into 10-id chunks and fans out the Capsule calls in parallel."
   ),
-  embed: z9.string().optional().describe(EMBED_TAGS_FIELDS_DESCRIPTION)
+  embed: embedParam(RECORD_EMBEDS)
 });
 async function getProjects(input) {
-  return chunkedMultiGet("/kases", "kases", input.ids, { embed: input.embed });
+  return chunkedMultiGet("/kases", "projects", input.ids, { embed: input.embed });
 }
 var createProjectSchema = z9.object({
   name: z9.string().min(1),
@@ -1840,7 +1907,7 @@ async function updateProject(input) {
   let resolvedTeamId = teamId;
   let resolvedStageId = stageId;
   if (ownerId !== void 0 && (teamId === void 0 || stageId === void 0)) {
-    const current = await readEntityRefs(`/kases/${id}`, "kase");
+    const current = await readEntityRefs(`/kases/${id}`, "project");
     if (teamId === void 0) resolvedTeamId = current.teamId;
     if (stageId === void 0) resolvedStageId = current.stageId;
   }
@@ -1991,7 +2058,7 @@ var { schema: deleteTaskSchema, handler: deleteTask } = defineDelete({
 import { z as z11 } from "zod";
 var listEntriesPagination = {
   ...paginationFields,
-  embed: z11.string().optional().describe(EMBED_ATTACHMENTS_PARTICIPANTS_DESCRIPTION)
+  embed: embedParam(ENTRY_EMBEDS)
 };
 var listPartyEntriesSchema = z11.object({
   partyId: positiveId,
@@ -2099,7 +2166,7 @@ async function listProjectEntries(input) {
 }
 var getEntrySchema = z11.object({
   id: positiveId,
-  embed: z11.string().optional().describe(EMBED_ATTACHMENTS_PARTICIPANTS_DESCRIPTION)
+  embed: embedParam(ENTRY_EMBEDS)
 });
 async function getEntry(input) {
   const { data } = await capsuleGet(`/entries/${input.id}`, {
@@ -2212,16 +2279,16 @@ import { z as z14 } from "zod";
 var TAG_LIST_PATH = {
   parties: "/parties/tags",
   opportunities: "/opportunities/tags",
-  kases: "/kases/tags"
+  projects: "/kases/tags"
 };
 var ENTITY_TO_WRAPPER = {
   parties: "party",
   opportunities: "opportunity",
-  kases: "kase"
+  projects: "kase"
 };
-var TagEntity = z14.enum(["parties", "opportunities", "kases"]).describe("Which entity type. Use 'kases' for projects (Capsule's legacy path name).");
+var TagEntity = z14.enum(["parties", "opportunities", "projects"]).describe("Which entity type.");
 var listTagsSchema = z14.object({
-  entity: z14.enum(["parties", "opportunities", "kases"]).describe("The resource type to list tags for"),
+  entity: z14.enum(["parties", "opportunities", "projects"]).describe("The resource type to list tags for"),
   ...paginationFieldsNoDefaults
 });
 async function listTags(input) {
@@ -2241,7 +2308,7 @@ var addTagSchema = z14.object({
 async function addTag(input) {
   const { entity, entityId, tagName } = input;
   const wrapper = ENTITY_TO_WRAPPER[entity];
-  const result = await capsulePut(`/${entity}/${entityId}`, {
+  const result = await capsulePut(`/${ENTITY_PATH[entity]}/${entityId}`, {
     [wrapper]: { tags: [{ name: tagName }] }
   });
   invalidateByPrefix(TAG_LIST_PATH[entity], "add_tag");
@@ -2258,7 +2325,7 @@ async function removeTagById(input) {
   const { entity, entityId, tagId } = input;
   const wrapper = ENTITY_TO_WRAPPER[entity];
   const result = await idempotentWithResult(
-    () => capsulePut(`/${entity}/${entityId}`, {
+    () => capsulePut(`/${ENTITY_PATH[entity]}/${entityId}`, {
       [wrapper]: { tags: [{ id: tagId, _delete: true }] }
     }),
     (result2) => ({
@@ -2293,7 +2360,7 @@ async function deleteTagDefinition(input) {
     throw new Error("delete_tag_definition requires confirm: true");
   }
   const result = await idempotent(
-    () => capsuleDelete(`/${entity}/tags/${tagId}`),
+    () => capsuleDelete(`/${ENTITY_PATH[entity]}/tags/${tagId}`),
     () => ({ deleted: true, alreadyDeleted: false, entity, tagId }),
     () => ({ deleted: true, alreadyDeleted: true, entity, tagId })
   );
@@ -2347,7 +2414,7 @@ var FilterInputSchema = z16.object({
   conditions: z16.array(FilterConditionSchema).min(1).describe(
     "Array of filter conditions. All conditions are ANDed together. To get newest records, use a date condition like {field: 'addedOn', operator: 'is within last', value: 7} and pick the highest-id row from the result (Capsule IDs are monotonic)."
   ),
-  embed: z16.string().optional().describe(EMBED_TAGS_FIELDS_DESCRIPTION),
+  embed: embedParam(RECORD_EMBEDS),
   ...paginationFields
 });
 async function runFilter(entityPath, input) {
@@ -2438,7 +2505,7 @@ var listEmployeesSchema = z18.object({
     "The organisation's party id. Returns the people whose `organisation` field links to this party."
   ),
   ...paginationFields,
-  embed: z18.string().optional().describe(EMBED_TAGS_FIELDS_DESCRIPTION)
+  embed: embedParam(RECORD_EMBEDS)
 });
 async function listEmployees(input) {
   return capsuleGetList(`/parties/${input.partyId}/people`, {
@@ -2481,19 +2548,22 @@ async function listDeletedProjects(input) {
 
 // src/tools/relationships.ts
 import { z as z19 } from "zod";
-var RelationshipEntity = z19.enum(["opportunities", "kases"]).describe("Which entity has the additional-party links. Use 'kases' for projects.");
+var RelationshipEntity = z19.enum(["opportunities", "projects"]).describe("Which entity has the additional-party links.");
 var listAdditionalPartiesSchema = z19.object({
   entity: RelationshipEntity,
   entityId: positiveId.describe("ID of the opportunity or project."),
-  embed: z19.string().optional().describe(EMBED_TAGS_FIELDS_DESCRIPTION),
+  embed: embedParam(RECORD_EMBEDS),
   ...paginationFields
 });
 async function listAdditionalParties(input) {
-  return capsuleGetList(`/${input.entity}/${input.entityId}/parties`, {
-    embed: input.embed,
-    page: input.page,
-    perPage: input.perPage
-  });
+  return capsuleGetList(
+    `/${ENTITY_PATH[input.entity]}/${input.entityId}/parties`,
+    {
+      embed: input.embed,
+      page: input.page,
+      perPage: input.perPage
+    }
+  );
 }
 var addAdditionalPartySchema = z19.object({
   entity: RelationshipEntity,
@@ -2504,7 +2574,9 @@ var addAdditionalPartySchema = z19.object({
 });
 async function addAdditionalParty(input) {
   try {
-    await capsulePostNoContent(`/${input.entity}/${input.entityId}/parties/${input.partyId}`);
+    await capsulePostNoContent(
+      `/${ENTITY_PATH[input.entity]}/${input.entityId}/parties/${input.partyId}`
+    );
     return {
       linked: true,
       alreadyLinked: false,
@@ -2541,7 +2613,7 @@ async function removeAdditionalParty(input) {
     throw new Error("remove_additional_party requires confirm: true");
   }
   return idempotent(
-    () => capsuleDelete(`/${input.entity}/${input.entityId}/parties/${input.partyId}`),
+    () => capsuleDelete(`/${ENTITY_PATH[input.entity]}/${input.entityId}/parties/${input.partyId}`),
     () => ({
       removed: true,
       alreadyRemoved: false,
@@ -2560,7 +2632,7 @@ async function removeAdditionalParty(input) {
 }
 var listAssociatedProjectsSchema = z19.object({
   opportunityId: positiveId,
-  embed: z19.string().optional().describe(EMBED_TAGS_FIELDS_DESCRIPTION),
+  embed: embedParam(RECORD_EMBEDS),
   ...paginationFields
 });
 async function listAssociatedProjects(input) {
@@ -2573,49 +2645,49 @@ async function listAssociatedProjects(input) {
 
 // src/tools/custom-fields.ts
 import { z as z20 } from "zod";
-var CustomFieldEntity = z20.enum(["parties", "opportunities", "kases"]).describe("Which entity type's custom field schema to inspect. Use 'kases' for projects.");
+var CustomFieldEntity = z20.enum(["parties", "opportunities", "projects"]).describe("Which entity type's custom field schema to inspect.");
 var listCustomFieldsSchema = z20.object({
   entity: CustomFieldEntity
 });
 async function listCustomFields(input) {
   const { data } = await capsuleGetCached(
-    `/${input.entity}/fields/definitions`
+    `/${ENTITY_PATH[input.entity]}/fields/definitions`
   );
   return data;
 }
 var getCustomFieldSchema = z20.object({
   entity: CustomFieldEntity,
-  fieldId: positiveId.describe("Custom field definition id.")
+  id: positiveId.describe("Custom field definition id.")
 });
 async function getCustomField(input) {
   const { data } = await capsuleGetCached(
-    `/${input.entity}/fields/definitions/${input.fieldId}`
+    `/${input.entity}/fields/definitions/${input.id}`
   );
   return data;
 }
 
 // src/tools/tracks.ts
 import { z as z21 } from "zod";
-var TrackEntity = z21.enum(["parties", "opportunities", "kases"]).describe("Use 'kases' for projects.");
+var TrackEntity = z21.enum(["parties", "opportunities", "projects"]).describe("Which entity type.");
 var listEntityTracksSchema = z21.object({
   entity: TrackEntity,
   entityId: positiveId
 });
 async function listEntityTracks(input) {
   const { data } = await capsuleGet(
-    `/${input.entity}/${input.entityId}/tracks`
+    `/${ENTITY_PATH[input.entity]}/${input.entityId}/tracks`
   );
   return data;
 }
-var showTrackSchema = z21.object({
-  trackId: positiveId
+var getTrackSchema = z21.object({
+  id: positiveId
 });
-async function showTrack(input) {
-  const { data } = await capsuleGet(`/tracks/${input.trackId}`);
+async function getTrack(input) {
+  const { data } = await capsuleGet(`/tracks/${input.id}`);
   return data;
 }
 var applyTrackSchema = z21.object({
-  entity: z21.enum(["opportunities", "kases"]).describe("Which entity to apply the track to. Use 'kases' for projects."),
+  entity: z21.enum(["opportunities", "projects"]).describe("Which entity to apply the track to."),
   entityId: positiveId,
   trackDefinitionId: positiveId.describe(
     "The trackDefinition to apply (from list_track_definitions). Auto-creates task definitions on the target entity per the track's rules."
@@ -2634,7 +2706,7 @@ async function applyTrack(input) {
   return capsulePost("/tracks", { track });
 }
 var updateTrackSchema = z21.object({
-  trackId: positiveId,
+  id: positiveId,
   fields: z21.record(z21.string(), z21.unknown()).describe(
     "Object of fields to update on the track. Capsule's PUT semantics are partial \u2014 only the fields you provide are changed. Common: { complete: true } to mark a track completed. Capsule rejects unknown keys; consult Capsule's docs for the full updatable set."
   )
@@ -2643,12 +2715,12 @@ async function updateTrack(input) {
   if (Object.keys(input.fields).length === 0) {
     throw new Error("update_track: provide at least one field in `fields`");
   }
-  return capsulePut(`/tracks/${input.trackId}`, {
+  return capsulePut(`/tracks/${input.id}`, {
     track: input.fields
   });
 }
 var removeTrackSchema = z21.object({
-  trackId: positiveId,
+  id: positiveId,
   confirm: confirmFlag().describe(
     "Must be set to true. Removes the track instance from its entity. **Capsule also deletes the auto-tasks the track created when it was applied** \u2014 they go with the track and become unreachable (404 on GET /tasks/{id}, gone from list_tasks on the parent entity). If you need any of those tasks to outlive the track, copy their content into fresh tasks (or use the web UI) before calling remove_track."
   )
@@ -2658,9 +2730,9 @@ async function removeTrack(input) {
     throw new Error("remove_track requires confirm: true");
   }
   return idempotent(
-    () => capsuleDelete(`/tracks/${input.trackId}`),
-    () => ({ removed: true, alreadyRemoved: false, trackId: input.trackId }),
-    () => ({ removed: true, alreadyRemoved: true, trackId: input.trackId })
+    () => capsuleDelete(`/tracks/${input.id}`),
+    () => ({ removed: true, alreadyRemoved: false, id: input.id }),
+    () => ({ removed: true, alreadyRemoved: true, id: input.id })
   );
 }
 
@@ -2747,28 +2819,31 @@ async function uploadAttachment(input) {
 
 // src/tools/saved-filters.ts
 import { z as z23 } from "zod";
-var EntitySchema = z23.enum(["parties", "opportunities", "kases"]).describe(
-  "Which entity type the filter operates over. Use 'kases' for projects (Capsule's legacy name)."
-);
+var EntitySchema = z23.enum(["parties", "opportunities", "projects"]).describe("Which entity type the filter operates over.");
 var listSavedFiltersSchema = z23.object({
   entity: EntitySchema
 });
 async function listSavedFilters(input) {
-  const { data } = await capsuleGetCached(`/${input.entity}/filters`);
+  const { data } = await capsuleGetCached(
+    `/${ENTITY_PATH[input.entity]}/filters`
+  );
   return data;
 }
 var runSavedFilterSchema = z23.object({
   entity: EntitySchema,
   id: positiveId.describe("The saved filter id (from list_saved_filters)."),
-  embed: z23.string().optional().describe(EMBED_TAGS_FIELDS_DESCRIPTION),
+  embed: embedParam(RECORD_EMBEDS),
   ...paginationFields
 });
 async function runSavedFilter(input) {
-  return capsuleGetList(`/${input.entity}/filters/${input.id}/results`, {
-    page: input.page,
-    perPage: input.perPage,
-    embed: input.embed
-  });
+  return capsuleGetList(
+    `/${ENTITY_PATH[input.entity]}/filters/${input.id}/results`,
+    {
+      page: input.page,
+      perPage: input.perPage,
+      embed: input.embed
+    }
+  );
 }
 
 // src/server.ts
@@ -2779,7 +2854,7 @@ function createCapsuleMcpServer(opts) {
   const server2 = new McpServer(
     {
       name: "capsulemcp",
-      version: "1.8.1",
+      version: "2.0.0",
       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
@@ -2896,7 +2971,7 @@ function createCapsuleMcpServer(opts) {
     registerTool(
       server2,
       "delete_party",
-      "DESTRUCTIVE & IRREVERSIBLE: permanently delete a party (person or organisation). Cascades to all linked notes, tasks, opportunities, AND projects (kases). Deleting an organisation does NOT delete people linked to it via organisationId \u2014 their `organisation` field is silently cleared to null and they survive as standalone records. TRACK INSTANCES applied to cascaded opportunities/projects are NOT cleaned up either \u2014 they survive as orphan records reachable only by track id via show_track. Use remove_track on each track explicitly before deleting the parent party if orphan accumulation matters (rare in practice \u2014 orphans are unreachable from normal navigation). Requires confirm=true. Always read the party first with get_party and confirm with the user before calling. Idempotent on retry: response is `{deleted: true, alreadyDeleted: false, id}` on a fresh delete or `{deleted: true, alreadyDeleted: true, id}` if the party was already gone (Capsule's 404 is caught internally so reconciliation loops can re-issue safely).",
+      "DESTRUCTIVE & IRREVERSIBLE: permanently delete a party (person or organisation). Cascades to all linked notes, tasks, opportunities, AND projects. Deleting an organisation does NOT delete people linked to it via organisationId \u2014 their `organisation` field is silently cleared to null and they survive as standalone records. TRACK INSTANCES applied to cascaded opportunities/projects are NOT cleaned up either \u2014 they survive as orphan records reachable only by track id via get_track. Use remove_track on each track explicitly before deleting the parent party if orphan accumulation matters (rare in practice \u2014 orphans are unreachable from normal navigation). Requires confirm=true. Always read the party first with get_party and confirm with the user before calling. Idempotent on retry: response is `{deleted: true, alreadyDeleted: false, id}` on a fresh delete or `{deleted: true, alreadyDeleted: true, id}` if the party was already gone (Capsule's 404 is caught internally so reconciliation loops can re-issue safely).",
       deletePartySchema,
       deleteParty
     );
@@ -2995,7 +3070,7 @@ function createCapsuleMcpServer(opts) {
   registerTool(
     server2,
     "list_additional_parties",
-    "List secondary party links on an opportunity or project. The 'main' party is on the entity itself (opportunity.party); additional parties are e.g. partners, consultants, or referrers also involved in the deal. Set entity to 'opportunities' or 'kases' (Capsule's term for projects).",
+    "List secondary party links on an opportunity or project. The 'main' party is on the entity itself (opportunity.party); additional parties are e.g. partners, consultants, or referrers also involved in the deal. Set entity to 'opportunities' or 'projects'.",
     listAdditionalPartiesSchema,
     listAdditionalParties
   );
@@ -3036,10 +3111,17 @@ function createCapsuleMcpServer(opts) {
       deleteOpportunity
     );
   }
+  registerTool(
+    server2,
+    "search_projects",
+    "Free-text search projects in Capsule CRM (matches name and description). Returns results in Capsule's default order (no sort parameter is supported here). Omit `q` to list all projects. For structured queries \u2014 'most recent project', 'projects opened this month', 'projects tagged X' \u2014 use filter_projects instead.",
+    searchProjectsSchema,
+    searchProjects
+  );
   registerTool(
     server2,
     "list_projects",
-    "List projects (cases) in Capsule CRM, optionally filtered by status. Returns results in Capsule's default order (no sort parameter is supported here). For structured queries \u2014 'most recent project', 'projects opened this month', 'projects tagged X' \u2014 use filter_projects instead.",
+    "List projects (cases) in Capsule CRM, optionally filtered by status. Returns results in Capsule's default order (no sort parameter is supported here). For free-text matching use search_projects; for structured queries \u2014 'most recent project', 'projects opened this month', 'projects tagged X' \u2014 use filter_projects instead.",
     listProjectsSchema,
     listProjects
   );
@@ -3067,7 +3149,7 @@ function createCapsuleMcpServer(opts) {
   registerTool(
     server2,
     "list_deleted_projects",
-    "Audit feature: list projects deleted on or after a given timestamp. The `since` parameter is REQUIRED. Response also includes a `restrictedKases` key for records the integration user can't read fully.",
+    "Audit feature: list projects deleted on or after a given timestamp. The `since` parameter is REQUIRED. Response also includes a `restrictedProjects` key for records the integration user can't read fully.",
     listDeletedProjectsSchema,
     listDeletedProjects
   );
@@ -3382,14 +3464,14 @@ function createCapsuleMcpServer(opts) {
   );
   registerTool(
     server2,
-    "list_lostreasons",
+    "list_lost_reasons",
     "List all configured opportunity-loss reasons (e.g. 'Poor Qualification', 'Lost to competitor', 'Price too high'). Returns each reason's id and name; the set is account-configured rather than a fixed enum, so call this to discover valid ids before referencing a lostReason in update_opportunity when closing a deal as lost. Useful for analysing closed-lost opportunities by reason.",
     listLostReasonsSchema,
     listLostReasons
   );
   registerTool(
     server2,
-    "list_activitytypes",
+    "list_activity_types",
     "List all configured activity types (e.g. Call, Meeting, Email). These are the categories used when logging timeline entries via add_note. Returns each type's id and name. The set is account-configured rather than a fixed enum, so call this to discover valid values before referencing an activityType in entry creation.",
     listActivityTypesSchema,
     listActivityTypes
@@ -3417,10 +3499,10 @@ function createCapsuleMcpServer(opts) {
   );
   registerTool(
     server2,
-    "show_track",
+    "get_track",
     "Fetch a single track instance by id. Returns the minimal Capsule projection: id, description, trackDateOn, direction, and the array of tasks attached to the track. Capsule's GET /tracks/{id} does NOT include a trackDefinition link, an entity reference, or a completion field \u2014 to find the entity a track is applied to, use list_entity_tracks (which lists track instances by their parent entity); to check completion, the track-tasks' own statuses are the proxy.",
-    showTrackSchema,
-    showTrack
+    getTrackSchema,
+    getTrack
   );
   registerTool(
     server2,
@@ -3453,7 +3535,7 @@ function createCapsuleMcpServer(opts) {
   registerTool(
     server2,
     "list_tags",
-    "List all tags available for a given entity type (parties, opportunities, or kases). Returns each tag's id, name, and any data-tag field schema. Tags are entity-specific \u2014 a party tag is not interchangeable with an opportunity tag. Use this to discover valid tag ids before calling add_tag, or to display the tag catalogue to the user when they ask 'what tags do we use?'",
+    "List all tags available for a given entity type (parties, opportunities, or projects). Returns each tag's id, name, and any data-tag field schema. Tags are entity-specific \u2014 a party tag is not interchangeable with an opportunity tag. Use this to discover valid tag ids before calling add_tag, or to display the tag catalogue to the user when they ask 'what tags do we use?'",
     listTagsSchema,
     listTags
   );
@@ -3475,7 +3557,7 @@ function createCapsuleMcpServer(opts) {
     registerTool(
       server2,
       "delete_tag_definition",
-      "DESTRUCTIVE & TENANT-WIDE: permanently delete a tag DEFINITION from an entity type's tag namespace (parties / opportunities / kases). Unlike remove_tag_by_id \u2014 which detaches a tag from ONE record and leaves the definition intact for others \u2014 this removes the definition itself, so the tag disappears from EVERY record that shared it. Use it to clean up stray / mistyped / test tag definitions polluting the tenant-global list. Requires confirm=true. Always read the affected tag first via list_tags and confirm with the user; if you only want to untag one record, use remove_tag_by_id instead. Irreversible (re-creating by name via add_tag mints a brand-new id). Idempotent on retry: `{deleted: true, alreadyDeleted: false, entity, tagId}` on a fresh delete, or `{deleted: true, alreadyDeleted: true, entity, tagId}` if the definition was already gone (Capsule's 404 is caught). Endpoint verified empirically (DELETE /<entity>/tags/{id} \u2192 204).",
+      "DESTRUCTIVE & TENANT-WIDE: permanently delete a tag DEFINITION from an entity type's tag namespace (parties / opportunities / projects). Unlike remove_tag_by_id \u2014 which detaches a tag from ONE record and leaves the definition intact for others \u2014 this removes the definition itself, so the tag disappears from EVERY record that shared it. Use it to clean up stray / mistyped / test tag definitions polluting the tenant-global list. Requires confirm=true. Always read the affected tag first via list_tags and confirm with the user; if you only want to untag one record, use remove_tag_by_id instead. Irreversible (re-creating by name via add_tag mints a brand-new id). Idempotent on retry: `{deleted: true, alreadyDeleted: false, entity, tagId}` on a fresh delete, or `{deleted: true, alreadyDeleted: true, entity, tagId}` if the definition was already gone (Capsule's 404 is caught). Endpoint verified empirically (DELETE /<entity>/tags/{id} \u2192 204).",
       deleteTagDefinitionSchema,
       deleteTagDefinition
     );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "capsulemcp",
-  "version": "1.8.1",
+  "version": "2.0.0",
   "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",