@assetlab/mcp-server 1.16.1 → 1.18.0

package/README.md

@@ -13,7 +13,7 @@ Works with **Claude**, **ChatGPT**, **Microsoft Copilot**, and any MCP-compatibl
 ### Claude.ai
 
 1. Create an API key in **AssetLab → Settings → API Keys**
-2. In Claude.ai, go to **Settings → Integrations → Add integration**
+2. In Claude.ai, go to **Settings → Connectors → Add connector**
 3. Paste the connector URL: `https://mcp.assetlab.ca`
 4. When prompted for auth, paste your API key (`al_live_...`)
 

package/dist/tools-write.js

@@ -2252,6 +2252,20 @@ export function registerWriteTools(server, client) {
             return formatError(err);
         }
     });
+    server.tool('upload_file', 'Upload a file to AssetLab storage by sending its bytes inline (base64). The AssetLab backend performs the storage upload server-side — use this tool when the client cannot PUT directly to Supabase Storage (e.g. Claude integrations whose outbound network blocks arbitrary supabase.co hosts). Returns { path, public_url, bucket, file_size, content_type }. After uploading, pass path or public_url to the appropriate record tool (update_asset image_url, create_asset_document file_path, update_work_order image_url, create_attachment file_path, create_project_document file_path, create_contract_document file_path). Server limit is ~10 MB decoded; MCP arg ceiling effectively caps file size around 700 KB–1 MB. For larger files, use create_upload_url instead. Requires upload_urls:write scope.', {
+        bucket: z.enum(['documents', 'attachments', 'project-documents', 'contract-documents', 'asset-images']).describe('Storage bucket (required). Use "asset-images" for asset photos, "attachments" for work-order/PM attachments.'),
+        file_name: z.string().min(1).max(500).describe('File name including extension (required)'),
+        content_base64: z.string().min(1).describe('File contents base64-encoded (required). Data URI prefixes like "data:image/png;base64," are stripped automatically.'),
+        content_type: z.string().max(200).optional().describe('MIME type (e.g. image/jpeg, application/pdf). Defaults to application/octet-stream.'),
+    }, async (params) => {
+        try {
+            const result = await client.create('upload-files', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
     // ============================================================
     // Asset Documents (scope: asset_documents)
     // ============================================================
@@ -3035,6 +3049,140 @@ export function registerWriteTools(server, client) {
         }
     });
     // ============================================================
+    // Floorplans (enterprise++ feature)
+    // ============================================================
+    const FLOORPLAN_STATUSES = ['pending', 'detecting', 'ready', 'failed'];
+    const REGION_SOURCES = ['manual', 'ai'];
+    const polygonSchema = z
+        .array(z.tuple([z.number().min(0).max(1), z.number().min(0).max(1)]))
+        .min(3)
+        .describe('Polygon outline as an array of [x, y] points in normalized 0-1 coordinates (origin top-left). At least 3 points.');
+    server.tool('create_floorplan', 'Create a floorplan row for one floor of a building. Typically the web app calls this per page of an uploaded PDF; MCP clients rarely need to call this directly since they do not upload the PDF itself. Requires floorplans:write scope.', {
+        building_id: z.string().uuid().describe('Building this floor belongs to'),
+        floor_label: z.string().max(200).describe('Human-readable floor name (e.g. "Ground Floor", "Mezzanine")'),
+        floor_order: z.number().int().min(0).optional().describe('Sort order within the building (lowest = lowest floor)'),
+        pdf_storage_path: z.string().max(1000).describe('Supabase Storage path to the PDF file, e.g. "<tenant_id>/<building_id>/<uuid>.pdf"'),
+        pdf_filename: z.string().max(500).describe('Original filename for display'),
+        page_number: z.number().int().min(1).optional().describe('1-indexed page number within the PDF'),
+        page_width_pt: z.number().min(0).optional().describe('Page width in PDF points (discovered client-side)'),
+        page_height_pt: z.number().min(0).optional().describe('Page height in PDF points'),
+        status: z.enum(FLOORPLAN_STATUSES).optional().describe('Detection status (default: pending)'),
+    }, async (params) => {
+        try {
+            const result = await client.create('floorplans', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('update_floorplan', 'Update floorplan metadata (rename floor, reorder, set status). Requires floorplans:write scope.', {
+        id: z.string().uuid().describe('Floorplan ID'),
+        floor_label: z.string().max(200).optional().describe('New floor label'),
+        floor_order: z.number().int().min(0).optional().describe('New sort order'),
+        status: z.enum(FLOORPLAN_STATUSES).optional().describe('Detection status'),
+        detection_error: z.string().max(2000).optional().describe('Error message if status=failed'),
+    }, async ({ id, ...rest }) => {
+        try {
+            const result = await client.update('floorplans', id, buildBody(rest));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('delete_floorplan', 'Delete a floorplan. WARNING: cascades to all regions and asset placements on this floor. Does NOT delete the underlying PDF file from storage (do that separately if no other floors reference it). Requires floorplans:write scope.', { id: z.string().uuid().describe('Floorplan ID') }, async ({ id }) => {
+        try {
+            const result = await client.remove('floorplans', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('create_floorplan_region', 'Create a region (labeled room or zone) on a floorplan. Polygon coordinates are normalized 0-1 with origin top-left. Optionally link the region to an existing Location via location_id. Requires floorplan_regions:write scope.', {
+        floorplan_id: z.string().uuid().describe('Floorplan this region belongs to'),
+        label: z.string().max(500).describe('Region label (e.g. "Boiler Room 2B")'),
+        polygon: polygonSchema,
+        location_id: z.string().uuid().optional().describe('Linked Location ID (resolved via list_locations)'),
+        source: z.enum(REGION_SOURCES).optional().describe('"manual" (default) or "ai" for AI-detected'),
+        confidence: z.number().min(0).max(1).optional().describe('AI confidence score (0-1), only set when source=ai'),
+        reviewed: z.boolean().optional().describe('True if an admin has reviewed this region (default: true for manual, false for ai)'),
+    }, async (params) => {
+        try {
+            const result = await client.create('floorplan-regions', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('update_floorplan_region', 'Update a floorplan region — rename, reshape polygon, link to a Location, or mark as reviewed. Requires floorplan_regions:write scope.', {
+        id: z.string().uuid().describe('Floorplan region ID'),
+        label: z.string().max(500).optional().describe('New label'),
+        polygon: polygonSchema.optional(),
+        location_id: z.string().uuid().optional().describe('Linked Location ID (set to null to unlink)'),
+        confidence: z.number().min(0).max(1).optional(),
+        reviewed: z.boolean().optional().describe('Mark region as reviewed by admin'),
+    }, async ({ id, ...rest }) => {
+        try {
+            const result = await client.update('floorplan-regions', id, buildBody(rest));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('delete_floorplan_region', 'Delete a region. Asset placements that referenced this region will have region_id set to null but remain on the floorplan. Requires floorplan_regions:write scope.', { id: z.string().uuid().describe('Floorplan region ID') }, async ({ id }) => {
+        try {
+            const result = await client.remove('floorplan-regions', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('create_asset_placement', 'Place an asset on a floorplan at the given (x, y) coordinate (normalized 0-1, origin top-left). UPSERTS by asset_id — an asset can have at most ONE placement globally, so calling this again just moves the pin. Use bulk_create with resource="asset-placements" to place many assets at once. Requires asset_placements:write scope.', {
+        asset_id: z.string().uuid().describe('Asset to place (resolve via list_assets)'),
+        floorplan_id: z.string().uuid().describe('Target floorplan (resolve via list_floorplans)'),
+        x: z.number().min(0).max(1).describe('Normalized x coordinate (0=left, 1=right)'),
+        y: z.number().min(0).max(1).describe('Normalized y coordinate (0=top, 1=bottom)'),
+        region_id: z.string().uuid().optional().describe('Optional region the pin sits inside (usually auto-inferred)'),
+        source: z.enum(REGION_SOURCES).optional().describe('"manual" (default) or "ai" for AI-placed'),
+    }, async (params) => {
+        try {
+            const result = await client.create('asset-placements', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('update_asset_placement', 'Move an asset placement to new coordinates or a different floorplan. Requires asset_placements:write scope.', {
+        id: z.string().uuid().describe('Asset placement ID'),
+        x: z.number().min(0).max(1).optional().describe('New x coordinate'),
+        y: z.number().min(0).max(1).optional().describe('New y coordinate'),
+        region_id: z.string().uuid().optional().describe('New region (set to null to clear)'),
+        floorplan_id: z.string().uuid().optional().describe('Move to a different floorplan'),
+    }, async ({ id, ...rest }) => {
+        try {
+            const result = await client.update('asset-placements', id, buildBody(rest));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('delete_asset_placement', 'Remove an asset placement. The asset itself is not affected — only the pin on the floorplan is removed. Requires asset_placements:write scope.', { id: z.string().uuid().describe('Asset placement ID') }, async ({ id }) => {
+        try {
+            const result = await client.remove('asset-placements', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
     // Bulk operations
     // ============================================================
     const BULK_RESOURCES = [
@@ -3057,6 +3205,7 @@ export function registerWriteTools(server, client) {
         'vendor-site-assignments', 'contract-sites',
         'asset-documents', 'attachments', 'project-documents', 'contract-documents',
         'service-areas', 'los-measures', 'los-measurements',
+        'floorplans', 'floorplan-regions', 'asset-placements',
     ];
     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")'),