@assetlab/mcp-server 1.11.0 → 1.13.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` | — |
@@ -131,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` |
@@ -144,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` |

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.', {
@@ -2490,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.', {
@@ -2514,6 +2664,221 @@ export function registerWriteTools(server, client) {
         }
     });
     // ============================================================
+    // Level of Service: Service Areas (scope: service_areas)
+    // ============================================================
+    server.tool('create_service_area', 'Create a new service area for Level of Service tracking. Requires service_areas:write scope. After creating, link system classes via create_service_area_system_class and sites via create_service_area_site.', {
+        name: z.string().min(1).max(500).describe('Service area name (required, unique per tenant)'),
+        description: z.string().max(2000).optional().describe('Description'),
+        icon: z.string().max(200).optional().describe('Icon name (e.g., "droplets" for water)'),
+        color: z.string().max(50).optional().describe('Hex color code (e.g., "#3B82F6")'),
+        sort_order: z.number().int().min(0).optional().describe('Sort order for display'),
+        is_active: z.boolean().optional().describe('Whether the service area is active (default: true)'),
+    }, async (params) => {
+        try {
+            const result = await client.create('service-areas', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('update_service_area', 'Update an existing service area by ID. Requires service_areas:write scope.', {
+        id: z.string().uuid().describe('Service area ID'),
+        name: z.string().min(1).max(500).optional().describe('Service area name'),
+        description: z.string().max(2000).optional().describe('Description'),
+        icon: z.string().max(200).optional().describe('Icon name'),
+        color: z.string().max(50).optional().describe('Hex color code'),
+        sort_order: z.number().int().min(0).optional().describe('Sort order'),
+        is_active: z.boolean().optional().describe('Active status'),
+    }, async ({ id, ...rest }) => {
+        try {
+            const result = await client.update('service-areas', id, buildBody(rest));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('delete_service_area', 'Delete a service area by ID. WARNING: This also deletes all linked measures, measurements, and junction records. Requires service_areas:write scope.', { id: z.string().uuid().describe('Service area ID') }, async ({ id }) => {
+        try {
+            const result = await client.remove('service-areas', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Level of Service: Service Area System Classes (scope: service_areas)
+    // ============================================================
+    server.tool('create_service_area_system_class', 'Link a system class to a service area. Requires service_areas:write scope. Resolve IDs first: list_service_areas → service_area_id, list_system_classes → system_class_id.', {
+        service_area_id: z.string().uuid().describe('Service area ID (required)'),
+        system_class_id: z.string().uuid().describe('System class ID (required)'),
+    }, async (params) => {
+        try {
+            const result = await client.create('service-area-system-classes', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('delete_service_area_system_class', 'Remove a system class link from a service area. Requires service_areas:write scope.', { id: z.string().uuid().describe('Service area system class link ID') }, async ({ id }) => {
+        try {
+            const result = await client.remove('service-area-system-classes', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Level of Service: Service Area Sites (scope: service_areas)
+    // ============================================================
+    server.tool('create_service_area_site', 'Link a site to a service area (optional scoping). Requires service_areas:write scope. Resolve IDs first: list_service_areas → service_area_id, list_sites → site_id.', {
+        service_area_id: z.string().uuid().describe('Service area ID (required)'),
+        site_id: z.string().uuid().describe('Site ID (required)'),
+    }, async (params) => {
+        try {
+            const result = await client.create('service-area-sites', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('delete_service_area_site', 'Remove a site link from a service area. Requires service_areas:write scope.', { id: z.string().uuid().describe('Service area site link ID') }, async ({ id }) => {
+        try {
+            const result = await client.remove('service-area-sites', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Level of Service: Measures (scope: los_measures)
+    // ============================================================
+    server.tool('create_los_measure', 'Create a new LoS measure within a service area. Requires los_measures:write scope. Resolve service_area_id first via list_service_areas.', {
+        service_area_id: z.string().uuid().describe('Service area ID (required)'),
+        name: z.string().min(1).max(500).describe('Measure name (required, unique per service area)'),
+        category: z.enum(['quality', 'reliability', 'responsiveness', 'safety', 'sustainability', 'cost_efficiency', 'capacity']).describe('Measure category (required)'),
+        type: z.enum(['community', 'technical']).describe('Measure type (required)'),
+        data_source: z.enum([
+            'manual', 'custom_formula', 'asset_condition_avg', 'asset_condition_pct_above',
+            'asset_condition_pct_below', 'risk_score_avg', 'risk_pct_critical',
+            'wo_response_time_avg', 'wo_completion_time_avg', 'wo_backlog_count', 'wo_overdue_count',
+            'pm_compliance_rate', 'compliance_score', 'fci', 'deferred_maintenance_ratio',
+            'asset_past_useful_life_pct',
+        ]).describe('Data source type (required). Use "manual" if values will be entered by hand.'),
+        description: z.string().max(2000).optional().describe('Description'),
+        community_statement: z.string().max(2000).optional().describe('Community-facing statement (for community type measures)'),
+        unit: z.string().max(100).optional().describe('Unit of measurement (e.g., "%", "hours", "count")'),
+        trend_direction: z.enum(['higher_is_better', 'lower_is_better', 'target_is_optimal']).optional().describe('Which direction is better'),
+        target_value: z.number().optional().describe('Target value'),
+        minimum_acceptable: z.number().optional().describe('Minimum acceptable value'),
+        stretch_goal: z.number().optional().describe('Stretch goal value'),
+        weight: z.number().min(0).optional().describe('Weight for composite score calculation (default: 1.0)'),
+        data_source_config: z.record(z.unknown()).optional().describe('Data source configuration (JSONB). E.g., {"threshold": 3} for pct_above/below, {"days_back": 90} for WO metrics.'),
+        is_active: z.boolean().optional().describe('Whether the measure is active (default: true)'),
+        sort_order: z.number().int().min(0).optional().describe('Sort order for display'),
+    }, async (params) => {
+        try {
+            const result = await client.create('los-measures', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('update_los_measure', 'Update an existing LoS measure by ID. Requires los_measures:write scope.', {
+        id: z.string().uuid().describe('LoS measure ID'),
+        name: z.string().min(1).max(500).optional().describe('Measure name'),
+        category: z.enum(['quality', 'reliability', 'responsiveness', 'safety', 'sustainability', 'cost_efficiency', 'capacity']).optional().describe('Measure category'),
+        type: z.enum(['community', 'technical']).optional().describe('Measure type'),
+        data_source: z.enum([
+            'manual', 'custom_formula', 'asset_condition_avg', 'asset_condition_pct_above',
+            'asset_condition_pct_below', 'risk_score_avg', 'risk_pct_critical',
+            'wo_response_time_avg', 'wo_completion_time_avg', 'wo_backlog_count', 'wo_overdue_count',
+            'pm_compliance_rate', 'compliance_score', 'fci', 'deferred_maintenance_ratio',
+            'asset_past_useful_life_pct',
+        ]).optional().describe('Data source type'),
+        description: z.string().max(2000).optional().describe('Description'),
+        community_statement: z.string().max(2000).optional().describe('Community-facing statement'),
+        unit: z.string().max(100).optional().describe('Unit of measurement'),
+        trend_direction: z.enum(['higher_is_better', 'lower_is_better', 'target_is_optimal']).optional().describe('Which direction is better'),
+        target_value: z.number().optional().describe('Target value'),
+        minimum_acceptable: z.number().optional().describe('Minimum acceptable value'),
+        stretch_goal: z.number().optional().describe('Stretch goal value'),
+        weight: z.number().min(0).optional().describe('Weight for composite score calculation'),
+        data_source_config: z.record(z.unknown()).optional().describe('Data source configuration (JSONB)'),
+        is_active: z.boolean().optional().describe('Active status'),
+        sort_order: z.number().int().min(0).optional().describe('Sort order'),
+    }, async ({ id, ...rest }) => {
+        try {
+            const result = await client.update('los-measures', id, buildBody(rest));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('delete_los_measure', 'Delete a LoS measure by ID. WARNING: This also deletes all associated measurements and targets history. Requires los_measures:write scope.', { id: z.string().uuid().describe('LoS measure ID') }, async ({ id }) => {
+        try {
+            const result = await client.remove('los-measures', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Level of Service: Measurements (scope: los_measurements)
+    // ============================================================
+    server.tool('create_los_measurement', 'Record a new LoS measurement value. Requires los_measurements:write scope. Resolve los_measure_id first via list_los_measures.', {
+        los_measure_id: z.string().uuid().describe('LoS measure ID (required)'),
+        period_type: z.enum(['monthly', 'quarterly', 'semi_annual', 'annual']).describe('Period type (required)'),
+        period_start: z.string().describe('Period start date (ISO 8601, required, e.g., "2026-01-01")'),
+        period_end: z.string().describe('Period end date (ISO 8601, required, e.g., "2026-03-31")'),
+        actual_value: z.number().describe('Measured value (required)'),
+        notes: z.string().max(2000).optional().describe('Notes or context for this measurement'),
+        is_auto: z.boolean().optional().describe('Whether this is an auto-calculated value (default: false)'),
+    }, async (params) => {
+        try {
+            const result = await client.create('los-measurements', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('update_los_measurement', 'Update an existing LoS measurement by ID. Requires los_measurements:write scope.', {
+        id: z.string().uuid().describe('LoS measurement ID'),
+        actual_value: z.number().optional().describe('Measured value'),
+        notes: z.string().max(2000).optional().describe('Notes or context'),
+        period_type: z.enum(['monthly', 'quarterly', 'semi_annual', 'annual']).optional().describe('Period type'),
+        period_start: z.string().optional().describe('Period start date (ISO 8601)'),
+        period_end: z.string().optional().describe('Period end date (ISO 8601)'),
+        is_auto: z.boolean().optional().describe('Whether this is auto-calculated'),
+    }, async ({ id, ...rest }) => {
+        try {
+            const result = await client.update('los-measurements', id, buildBody(rest));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('delete_los_measurement', 'Delete a LoS measurement by ID. Requires los_measurements:write scope.', { id: z.string().uuid().describe('LoS measurement ID') }, async ({ id }) => {
+        try {
+            const result = await client.remove('los-measurements', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
     // Bulk operations
     // ============================================================
     const BULK_RESOURCES = [
@@ -2530,11 +2895,12 @@ 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',
         'asset-documents', 'attachments', 'project-documents', 'contract-documents',
+        'service-areas', 'los-measures', 'los-measurements',
     ];
     server.tool('bulk_create', 'Create multiple records of a resource type in one API call (max 100). Each item is processed independently — one failure does not affect others. Returns per-item results. Requires {resource}:write scope. Counts as 1 request for rate limiting.', {
         resource: z.enum(BULK_RESOURCES).describe('Resource type (e.g. "assets", "work-orders")'),