@assetlab/mcp-server 1.10.0 → 1.12.0

package/README.md

@@ -86,6 +86,7 @@ Works with **Claude**, **ChatGPT**, **Microsoft Copilot**, and any MCP-compatibl
 | Invoices | `list_invoices` | `get_invoice` |
 | Purchase Orders | `list_purchase_orders` | `get_purchase_order` |
 | Expenses | `list_expenses` | `get_expense` |
+| Change Orders | `list_change_orders` | `get_change_order` |
 | Budgets | `list_budgets` | `get_budget` |
 | Parts | `list_parts` | `get_part` |
 | Part Categories | `list_part_categories` | `get_part_category` |
@@ -100,6 +101,7 @@ Works with **Claude**, **ChatGPT**, **Microsoft Copilot**, and any MCP-compatibl
 | Project Budget Items | `list_project_budget_items` | `get_project_budget_item` |
 | Project Time Entries | `list_project_time_entries` | `get_project_time_entry` |
 | Project Comments | `list_project_comments` | `get_project_comment` |
+| Project Document Folder Templates | `list_project_document_folder_templates` | `get_project_document_folder_template` |
 | Site FCI History | `list_site_fci_history` | `get_site_fci_history_entry` |
 | Vendor Site Assignments | `list_vendor_site_assignments` | `get_vendor_site_assignment` |
 | Contract Sites | `list_contract_sites` | — |
@@ -110,6 +112,7 @@ Works with **Claude**, **ChatGPT**, **Microsoft Copilot**, and any MCP-compatibl
 | Manufacturers | `list_manufacturers` | `get_manufacturer` |
 | Building Types | `list_building_types` | — |
 | Location Types | `list_location_types` | — |
+| Project Phase Categories | `list_project_phase_categories` | — |
 | Cost Categories | `list_cost_categories` | — |
 
 ### Write tools
@@ -130,6 +133,7 @@ Works with **Claude**, **ChatGPT**, **Microsoft Copilot**, and any MCP-compatibl
 | Invoices | `create_invoice` | `update_invoice` | `delete_invoice` |
 | Purchase Orders | `create_purchase_order` | `update_purchase_order` | `delete_purchase_order` |
 | Expenses | `create_expense` | `update_expense` | `delete_expense` |
+| Change Orders | `create_change_order` | `update_change_order` | `delete_change_order` |
 | Budgets | `create_budget` | `update_budget` | `delete_budget` |
 | Parts | `create_part` | `update_part` | `delete_part` |
 | Part Categories | `create_part_category` | `update_part_category` | `delete_part_category` |
@@ -143,6 +147,7 @@ Works with **Claude**, **ChatGPT**, **Microsoft Copilot**, and any MCP-compatibl
 | Project Budget Items | `create_project_budget_item` | `update_project_budget_item` | `delete_project_budget_item` |
 | Project Time Entries | `create_project_time_entry` | `update_project_time_entry` | `delete_project_time_entry` |
 | Project Comments | `create_project_comment` | `update_project_comment` | `delete_project_comment` |
+| Project Document Folder Templates | `create_project_document_folder_template` | `update_project_document_folder_template` | `delete_project_document_folder_template` |
 | Vendor Site Assignments | `create_vendor_site_assignment` | — | `delete_vendor_site_assignment` |
 | Contract Sites | `create_contract_site` | — | `delete_contract_site` |
 | Custom Field Definitions | `create_custom_field_definition` | `update_custom_field_definition` | `delete_custom_field_definition` |
@@ -152,6 +157,7 @@ Works with **Claude**, **ChatGPT**, **Microsoft Copilot**, and any MCP-compatibl
 | Manufacturers | `create_manufacturer` | `update_manufacturer` | `delete_manufacturer` |
 | Building Types | `create_building_type` | `update_building_type` | `delete_building_type` |
 | Location Types | `create_location_type` | `update_location_type` | `delete_location_type` |
+| Project Phase Categories | `create_project_phase_category` | `update_project_phase_category` | `delete_project_phase_category` |
 | Cost Categories | `create_cost_category` | `update_cost_category` | `delete_cost_category` |
 
 ## Scopes

package/dist/tools-write.js

@@ -831,6 +831,100 @@ export function registerWriteTools(server, client) {
         }
     });
     // ============================================================
+    // Change Orders (scope: change_orders)
+    // ============================================================
+    server.tool('create_change_order', 'Create a new change order. Requires change_orders:write scope.', {
+        co_number: z.string().min(1).max(200).describe('Change order number (required)'),
+        description: z.string().min(1).describe('Description (required)'),
+        amount: z.number().describe('Amount (required, negative for credits)'),
+        status: z.enum(['draft', 'submitted', 'approved', 'rejected']).optional().describe('Status'),
+        reason: z.string().optional().describe('Reason for the change order'),
+        notes: z.string().optional().describe('Additional notes'),
+        project_id: z.string().uuid().optional().describe('Project ID'),
+        vendor_id: z.string().uuid().optional().describe('Vendor ID'),
+        category_id: z.string().uuid().optional().describe('Cost category ID'),
+    }, async (params) => {
+        try {
+            const result = await client.create('change-orders', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('update_change_order', 'Update an existing change order by ID. Requires change_orders:write scope.', {
+        id: z.string().uuid().describe('Change order ID'),
+        co_number: z.string().min(1).max(200).optional().describe('Change order number'),
+        description: z.string().optional().describe('Description'),
+        amount: z.number().optional().describe('Amount (negative for credits)'),
+        status: z.enum(['draft', 'submitted', 'approved', 'rejected']).optional().describe('Status'),
+        reason: z.string().optional().describe('Reason'),
+        notes: z.string().optional().describe('Notes'),
+        project_id: z.string().uuid().optional().describe('Project ID'),
+        vendor_id: z.string().uuid().optional().describe('Vendor ID'),
+        category_id: z.string().uuid().optional().describe('Cost category ID'),
+        approved_by: z.string().optional().describe('Approved by (user ID)'),
+        approved_at: z.string().optional().describe('Approval date (ISO 8601)'),
+    }, async ({ id, ...rest }) => {
+        try {
+            const result = await client.update('change-orders', id, buildBody(rest));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('delete_change_order', 'Delete a change order by ID. Requires change_orders:write scope.', { id: z.string().uuid().describe('Change order ID') }, async ({ id }) => {
+        try {
+            const result = await client.remove('change-orders', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Project Document Folder Templates (scope: project_document_folder_templates)
+    // ============================================================
+    server.tool('create_project_document_folder_template', 'Create a project document folder template. Requires project_document_folder_templates:write scope.', {
+        name: z.string().min(1).max(500).describe('Template name (required)'),
+        description: z.string().max(2000).optional().describe('Template description'),
+        structure: z.array(z.any()).optional().describe('Folder hierarchy as JSON array'),
+        is_default: z.boolean().optional().describe('Whether this is the default template'),
+    }, async (params) => {
+        try {
+            const result = await client.create('project-document-folder-templates', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('update_project_document_folder_template', 'Update a project document folder template by ID. Requires project_document_folder_templates:write scope.', {
+        id: z.string().uuid().describe('Template ID'),
+        name: z.string().min(1).max(500).optional().describe('Template name'),
+        description: z.string().max(2000).optional().describe('Template description'),
+        structure: z.array(z.any()).optional().describe('Folder hierarchy as JSON array'),
+        is_default: z.boolean().optional().describe('Whether this is the default template'),
+    }, async ({ id, ...rest }) => {
+        try {
+            const result = await client.update('project-document-folder-templates', id, buildBody(rest));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('delete_project_document_folder_template', 'Delete a project document folder template by ID. Requires project_document_folder_templates:write scope.', { id: z.string().uuid().describe('Template ID') }, async ({ id }) => {
+        try {
+            const result = await client.remove('project-document-folder-templates', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
     // 14. Budgets (scope: budgets)
     // ============================================================
     server.tool('create_budget', 'Create a new budget. Requires budgets:write scope.', {
@@ -1563,6 +1657,45 @@ export function registerWriteTools(server, client) {
         }
     });
     // ============================================================
+    // Project Phase Categories (scope: project_phase_categories)
+    // ============================================================
+    server.tool('create_project_phase_category', 'Create a new project phase category. Requires project_phase_categories:write scope.', {
+        name: z.string().min(1).max(500).describe('Phase name (required), e.g. "Planning", "Design"'),
+        description: z.string().max(2000).optional().describe('Description of the phase'),
+        sort_order: z.number().int().min(0).max(10000).optional().describe('Display order (lower = first)'),
+    }, async (params) => {
+        try {
+            const result = await client.create('project-phase-categories', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('update_project_phase_category', 'Update an existing project phase category by ID. Requires project_phase_categories:write scope.', {
+        id: z.string().uuid().describe('Project phase category ID'),
+        name: z.string().min(1).max(500).optional().describe('Phase name'),
+        description: z.string().max(2000).optional().describe('Description'),
+        sort_order: z.number().int().min(0).max(10000).optional().describe('Display order (lower = first)'),
+    }, async ({ id, ...rest }) => {
+        try {
+            const result = await client.update('project-phase-categories', id, buildBody(rest));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('delete_project_phase_category', 'Delete a project phase category by ID. Requires project_phase_categories:write scope.', { id: z.string().uuid().describe('Project phase category ID') }, async ({ id }) => {
+        try {
+            const result = await client.remove('project-phase-categories', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
     // 30. Cost Categories (scope: cost_categories)
     // ============================================================
     server.tool('create_cost_category', 'Create a new cost category. Requires cost_categories:write scope.', {
@@ -2451,6 +2584,62 @@ export function registerWriteTools(server, client) {
         }
     });
     // ============================================================
+    // Project Risks (scope: project_risks)
+    // ============================================================
+    server.tool('create_project_risk', 'Create a new project risk. Requires project_risks:write scope.', {
+        project_id: z.string().uuid().describe('Project ID (required)'),
+        title: z.string().min(1).max(500).describe('Risk title (required)'),
+        description: z.string().optional().describe('Risk description'),
+        category: z.enum(['technical', 'financial', 'schedule', 'resource', 'external']).optional().describe('Risk category'),
+        probability: z.enum(['low', 'medium', 'high']).optional().describe('Probability level'),
+        impact: z.enum(['low', 'medium', 'high', 'critical']).optional().describe('Impact level'),
+        status: z.enum(['identified', 'analyzing', 'mitigating', 'resolved', 'accepted']).optional().describe('Risk status (default: identified)'),
+        mitigation_plan: z.string().optional().describe('Mitigation plan'),
+        contingency_plan: z.string().optional().describe('Contingency plan'),
+        owner_id: z.string().max(200).optional().describe('Risk owner (Clerk user ID)'),
+        due_date: z.string().optional().describe('Due date (ISO 8601)'),
+        created_by: z.string().max(200).optional().describe('Creator (Clerk user ID)'),
+    }, async (params) => {
+        try {
+            const result = await client.create('project-risks', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('update_project_risk', 'Update an existing project risk by ID. Requires project_risks:write scope.', {
+        id: z.string().uuid().describe('Project risk ID'),
+        project_id: z.string().uuid().optional().describe('Project ID'),
+        title: z.string().min(1).max(500).optional().describe('Risk title'),
+        description: z.string().optional().describe('Risk description'),
+        category: z.enum(['technical', 'financial', 'schedule', 'resource', 'external']).optional().describe('Risk category'),
+        probability: z.enum(['low', 'medium', 'high']).optional().describe('Probability level'),
+        impact: z.enum(['low', 'medium', 'high', 'critical']).optional().describe('Impact level'),
+        status: z.enum(['identified', 'analyzing', 'mitigating', 'resolved', 'accepted']).optional().describe('Risk status'),
+        mitigation_plan: z.string().optional().describe('Mitigation plan'),
+        contingency_plan: z.string().optional().describe('Contingency plan'),
+        owner_id: z.string().max(200).optional().describe('Risk owner (Clerk user ID)'),
+        due_date: z.string().optional().describe('Due date (ISO 8601)'),
+    }, async ({ id, ...rest }) => {
+        try {
+            const result = await client.update('project-risks', id, buildBody(rest));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('delete_project_risk', 'Delete a project risk by ID. Requires project_risks:write scope.', { id: z.string().uuid().describe('Project risk ID') }, async ({ id }) => {
+        try {
+            const result = await client.remove('project-risks', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
     // Project Assets
     // ============================================================
     server.tool('create_project_asset', 'Link an asset to a project. Requires project_assets:write scope.', {
@@ -2491,7 +2680,7 @@ export function registerWriteTools(server, client) {
         'project-comments', 'project-team-members', 'project-task-dependencies',
         'project-updates', 'project-cost-snapshots', 'project-locations',
         'project-sites', 'project-buildings', 'project-systems',
-        'project-system-classes', 'project-system-groups', 'project-assets',
+        'project-system-classes', 'project-system-groups', 'project-assets', 'project-risks',
         'parts', 'part-categories',
         'custom-field-definitions', 'custom-field-values',
         'vendor-site-assignments', 'contract-sites',