@trycompai/mcp-server 0.0.1 → 0.0.3

package/src/mcp-server/tools/offboardingChecklistOffboardingChecklistControllerGetPendingOffboardingsV1.ts

@@ -10,7 +10,7 @@ export const tool$offboardingChecklistOffboardingChecklistControllerGetPendingOf
     name: "get-pending-offboardings",
     description: `Get members with pending offboarding checklists
 
-Get members with pending offboarding checklists in Comp AI.`,
+Lists members whose offboarding checklist is still incomplete, with their outstanding items, so you can track and finish departing-employee offboarding.`,
     annotations: {
       "title": "",
       "destructiveHint": false,

package/src/mcp-server/tools/offboardingChecklistOffboardingChecklistControllerGetTemplateV1.ts

@@ -8,7 +8,9 @@ import { formatResult, ToolDefinition } from "../tools.js";
 export const tool$offboardingChecklistOffboardingChecklistControllerGetTemplateV1:
   ToolDefinition = {
     name: "get-template",
-    description: ``,
+    description: `Get the offboarding checklist template
+
+Returns the organization's offboarding checklist template: the ordered set of items every departing member must complete during their offboarding.`,
     annotations: {
       "title": "",
       "destructiveHint": false,

package/src/mcp-server/tools/offboardingChecklistOffboardingChecklistControllerRevokeAllVendorAccessV1.ts

@@ -16,7 +16,7 @@ export const tool$offboardingChecklistOffboardingChecklistControllerRevokeAllVen
     name: "revoke-all-vendor-access",
     description: `Confirm all vendor access as revoked
 
-Confirm all vendor access as revoked in Comp AI.`,
+Marks every vendor access record for a departing member as revoked in one step, recording who confirmed it, to complete access removal during offboarding.`,
     annotations: {
       "title": "",
       "destructiveHint": false,

package/src/mcp-server/tools/offboardingChecklistOffboardingChecklistControllerRevokeVendorAccessV1.ts

@@ -15,7 +15,7 @@ export const tool$offboardingChecklistOffboardingChecklistControllerRevokeVendor
     name: "revoke-vendor-access",
     description: `Mark vendor access as revoked
 
-Mark vendor access as revoked in Comp AI.`,
+Marks a single vendor's access for a departing member as revoked, optionally attaching evidence and notes, as part of offboarding access removal.`,
     annotations: {
       "title": "",
       "destructiveHint": false,

package/src/mcp-server/tools/offboardingChecklistOffboardingChecklistControllerUncompleteItemV1.ts

@@ -13,7 +13,9 @@ const args = {
 export const tool$offboardingChecklistOffboardingChecklistControllerUncompleteItemV1:
   ToolDefinition<typeof args> = {
     name: "uncomplete-item",
-    description: ``,
+    description: `Reopen an offboarding checklist item
+
+Reverts a previously completed offboarding checklist item back to incomplete for a member, in case the step was marked done by mistake.`,
     annotations: {
       "title": "",
       "destructiveHint": false,

package/src/mcp-server/tools/offboardingChecklistOffboardingChecklistControllerUndoVendorRevocationV1.ts

@@ -16,7 +16,7 @@ export const tool$offboardingChecklistOffboardingChecklistControllerUndoVendorRe
     name: "undo-vendor-revocation",
     description: `Undo vendor access revocation
 
-Undo vendor access revocation in Comp AI.`,
+Reverses a vendor access revocation for a member, marking that vendor's access as not revoked again, in case it was confirmed by mistake during offboarding.`,
     annotations: {
       "title": "",
       "destructiveHint": false,

package/src/mcp-server/tools/offboardingChecklistOffboardingChecklistControllerUpdateTemplateItemV1.ts

@@ -13,7 +13,9 @@ const args = {
 export const tool$offboardingChecklistOffboardingChecklistControllerUpdateTemplateItemV1:
   ToolDefinition<typeof args> = {
     name: "update-template-item",
-    description: ``,
+    description: `Update an offboarding checklist template item
+
+Updates an existing offboarding checklist template item by id, changing its label, description, or settings on the organization's offboarding template.`,
     annotations: {
       "title": "",
       "destructiveHint": false,

package/src/mcp-server/tools/offboardingChecklistOffboardingChecklistControllerUploadEvidenceV1.ts

@@ -13,7 +13,9 @@ const args = {
 export const tool$offboardingChecklistOffboardingChecklistControllerUploadEvidenceV1:
   ToolDefinition<typeof args> = {
     name: "upload-evidence",
-    description: ``,
+    description: `Upload evidence for an offboarding checklist item
+
+Attaches a supporting evidence file to a member's completed offboarding checklist item, documenting that the offboarding step was actually carried out.`,
     annotations: {
       "title": "",
       "destructiveHint": false,

package/src/mcp-server/tools/policiesPoliciesControllerGetAllPoliciesV1.ts

@@ -16,7 +16,7 @@ export const tool$policiesPoliciesControllerGetAllPoliciesV1: ToolDefinition<
   name: "list-policies",
   description: `List compliance policies
 
-Lists compliance policies for the organization. Use this to find a policy by name, look up a policy ID, browse drafts, or get an overview of all policies for SOC 2, ISO 27001, HIPAA, and GDPR workflows. Returns id, name, status, department, and other metadata for each policy. Pass excludeContent=true to skip the heavy TipTap content fields — recommended when you only need to identify a policy. To read or edit a single policy in detail, fetch it by ID via get-compliance-policy.`,
+Lists active compliance policies by default. Use includeArchived=true to include archived rows and excludeContent=true when you only need policy metadata.`,
   annotations: {
     "title": "",
     "destructiveHint": false,

package/src/models/controlscontrollerunlinkdocumenttypev1op.ts

@@ -53,8 +53,8 @@ export const ControlsControllerUnlinkDocumentTypeV1FormType$zodSchema = z.enum([
 
 export type ControlsControllerUnlinkDocumentTypeV1Request = {
   id: string;
-  formType: ControlsControllerUnlinkDocumentTypeV1FormType;
   frameworkInstanceId: string;
+  formType: ControlsControllerUnlinkDocumentTypeV1FormType;
 };
 
 export const ControlsControllerUnlinkDocumentTypeV1Request$zodSchema: z.ZodType<

package/src/models/policiescontrollergetallpoliciesv1op.ts

@@ -12,6 +12,7 @@ import {
 export type PoliciesControllerGetAllPoliciesV1Request = {
   xOrganizationId?: string | undefined;
   excludeContent?: boolean | undefined;
+  includeArchived?: boolean | undefined;
 };
 
 export const PoliciesControllerGetAllPoliciesV1Request$zodSchema: z.ZodType<
@@ -20,6 +21,9 @@ export const PoliciesControllerGetAllPoliciesV1Request$zodSchema: z.ZodType<
   excludeContent: z.boolean().describe(
     "When true, omits `content` and `draftContent` from each policy in the response. Use this when listing policies to find one by name/ID — fetch the full content via GET /v1/policies/{id} after.",
   ).optional(),
+  includeArchived: z.boolean().describe(
+    "When true, includes user-archived and framework-sync-archived policies in the response. Defaults to false.",
+  ).optional(),
   xOrganizationId: z.string().describe(
     "Organization ID (required for session auth, optional for API key auth)",
   ).optional(),

package/src/models/policyresponsedto.ts

@@ -88,6 +88,7 @@ export type PolicyResponseDto = {
   signedBy: Array<string>;
   reviewDate: string | null;
   isArchived: boolean;
+  archivedAt: string | null;
   createdAt: string;
   updatedAt: string;
   lastArchivedAt: string | null;
@@ -103,6 +104,9 @@ export const PolicyResponseDto$zodSchema: z.ZodType<PolicyResponseDto> = z
     approverId: z.string().nullable().describe(
       "ID of the user who approved this policy",
     ),
+    archivedAt: z.iso.datetime({ offset: true }).nullable().describe(
+      "When the policy was archived by framework sync",
+    ),
     assigneeId: z.string().nullable().describe(
       "ID of the user assigned to this policy",
     ),

package/src/tool-names.ts

@@ -242,7 +242,7 @@ export const toolNames: Array<{ name: string; description: string }>= [
   },
   {
     "name": "list-policies",
-    "description": "List compliance policies\n\nLists compliance policies for the organization. Use this to find a policy by name, look up a policy ID, browse drafts, or get an overview of all policies for SOC 2, ISO 27001, HIPAA, and GDPR workflows. Returns id, name, status, department, and other metadata for each policy. Pass excludeContent=true to skip the heavy TipTap content fields — recommended when you only need to identify a policy. To read or edit a single policy in detail, fetch it by ID via get-compliance-policy."
+    "description": "List compliance policies\n\nLists active compliance policies by default. Use includeArchived=true to include archived rows and excludeContent=true when you only need policy metadata."
   },
   {
     "name": "create-policy",
@@ -1282,62 +1282,62 @@ export const toolNames: Array<{ name: string; description: string }>= [
   },
   {
     "name": "get-pending-offboardings",
-    "description": "Get members with pending offboarding checklists\n\nGet members with pending offboarding checklists in Comp AI."
+    "description": "Get members with pending offboarding checklists\n\nLists members whose offboarding checklist is still incomplete, with their outstanding items, so you can track and finish departing-employee offboarding."
   },
   {
     "name": "get-template",
-    "description": ""
+    "description": "Get the offboarding checklist template\n\nReturns the organization's offboarding checklist template: the ordered set of items every departing member must complete during their offboarding."
   },
   {
     "name": "create-template-item",
-    "description": ""
+    "description": "Add an offboarding checklist template item\n\nCreates a new item in the organization's offboarding checklist template so it appears on every member's offboarding checklist from now on."
   },
   {
     "name": "update-template-item",
-    "description": ""
+    "description": "Update an offboarding checklist template item\n\nUpdates an existing offboarding checklist template item by id, changing its label, description, or settings on the organization's offboarding template."
   },
   {
     "name": "delete-template-item",
-    "description": ""
+    "description": "Delete an offboarding checklist template item\n\nRemoves an item from the organization's offboarding checklist template by id so it no longer appears on members' offboarding checklists."
   },
   {
     "name": "get-member-checklist",
-    "description": ""
+    "description": "Get a member's offboarding checklist\n\nReturns the offboarding checklist for a specific member, including each item and whether it has been completed, to track that person's offboarding progress."
   },
   {
     "name": "offboarding-checklist-export-all-evidence",
-    "description": "Export all offboarding evidence as a zip file\n\nExport all offboarding evidence as a zip file in Comp AI."
+    "description": "Export all offboarding evidence as a zip file\n\nExports a zip archive containing the offboarding checklist evidence for every member in the organization, for audits, handovers, or record-keeping."
   },
   {
     "name": "export-evidence",
-    "description": "Export offboarding evidence as a zip file\n\nExport offboarding evidence as a zip file in Comp AI."
+    "description": "Export offboarding evidence as a zip file\n\nExports a zip archive of the offboarding checklist evidence collected for a single member, for audit, handover, or record-keeping purposes."
   },
   {
     "name": "complete-item",
-    "description": ""
+    "description": "Complete an offboarding checklist item\n\nMarks a specific offboarding checklist item complete for a member, recording who completed it and when, as part of finishing that member's offboarding."
   },
   {
     "name": "uncomplete-item",
-    "description": ""
+    "description": "Reopen an offboarding checklist item\n\nReverts a previously completed offboarding checklist item back to incomplete for a member, in case the step was marked done by mistake."
   },
   {
     "name": "upload-evidence",
-    "description": ""
+    "description": "Upload evidence for an offboarding checklist item\n\nAttaches a supporting evidence file to a member's completed offboarding checklist item, documenting that the offboarding step was actually carried out."
   },
   {
     "name": "get-access-revocations",
-    "description": "Get vendor access revocation status for a member\n\nGet vendor access revocation status for a member in Comp AI."
+    "description": "Get vendor access revocation status for a member\n\nLists the vendors a departing member had access to and whether each has been revoked, so you can confirm all vendor access is removed during offboarding."
   },
   {
     "name": "revoke-all-vendor-access",
-    "description": "Confirm all vendor access as revoked\n\nConfirm all vendor access as revoked in Comp AI."
+    "description": "Confirm all vendor access as revoked\n\nMarks every vendor access record for a departing member as revoked in one step, recording who confirmed it, to complete access removal during offboarding."
   },
   {
     "name": "revoke-vendor-access",
-    "description": "Mark vendor access as revoked\n\nMark vendor access as revoked in Comp AI."
+    "description": "Mark vendor access as revoked\n\nMarks a single vendor's access for a departing member as revoked, optionally attaching evidence and notes, as part of offboarding access removal."
   },
   {
     "name": "undo-vendor-revocation",
-    "description": "Undo vendor access revocation\n\nUndo vendor access revocation in Comp AI."
+    "description": "Undo vendor access revocation\n\nReverses a vendor access revocation for a member, marking that vendor's access as not revoked again, in case it was confirmed by mistake during offboarding."
   }
 ];