npm - @assetlab/mcp-server - Versions diffs - 1.3.0 → 1.3.1 - Mend

@assetlab/mcp-server 1.3.0 → 1.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2) hide show

package/README.md +116 -143
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -1,173 +1,146 @@
 # @assetlab/mcp-server
-Connect [Claude](https://claude.ai) to your [AssetLab](https://assetlab.ca) account via the [Model Context Protocol](https://modelcontextprotocol.io). Ask Claude questions about your assets, work orders, PM schedules, and more — in plain language.
+Connect [Claude](https://claude.ai) to your [AssetLab](https://assetlab.ca) account via the [Model Context Protocol](https://modelcontextprotocol.io). Ask Claude questions about your assets, work orders, PM schedules, and more — in plain language. Create and update records hands-free.
 ## Prerequisites
-- [Node.js](https://nodejs.org) 18 or later
 - An AssetLab account with an API key (create one in **Settings → API Keys**)
-- [Claude Desktop](https://claude.ai/download) or [Claude Code](https://claude.ai/code)
+- [Claude.ai](https://claude.ai) Team or Enterprise plan
 ## Setup
-### Claude Desktop
-1. Open your Claude Desktop config file:
-   - **Mac:** `~/Library/Application Support/Claude/claude_desktop_config.json`
-   - **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
-2. Add the following to the `mcpServers` object (replace `al_live_...` with your API key):
-```json
-{
-  "mcpServers": {
-    "assetlab": {
-      "command": "npx",
-      "args": ["-y", "@assetlab/mcp-server"],
-      "env": {
-        "ASSETLAB_API_KEY": "al_live_...",
-        "ASSETLAB_API_URL": "your-api-url"
-      }
-    }
-  }
-}
-```
-> **Tip:** The easiest way to get this config is to click **Copy Claude Config** directly on your API key in **AssetLab Settings → API Keys** — it pre-fills your key and API URL automatically.
-3. Restart Claude Desktop. You should see the AssetLab tools available.
-### Claude Code
-```bash
-claude mcp add assetlab npx @assetlab/mcp-server \
-  -e ASSETLAB_API_KEY=al_live_... \
-  -e ASSETLAB_API_URL=your-api-url
-```
+1. Create an API key in **AssetLab → Settings → API Keys**
+2. In Claude.ai, go to **Settings → Integrations → Add integration**
+3. Paste the connector URL: `https://mcp.assetlab.ca`
+4. When prompted for auth, paste your API key (`al_live_...`)
 ## Example prompts
-Once connected, you can ask Claude things like:
 - *"Show me all overdue work orders"*
 - *"List critical assets at Site A"*
 - *"What PM schedules are due this month?"*
-- *"Summarize the current state of our facilities"*
+- *"Create a work order for the broken pump in Building 3"*
+- *"Add a new vendor for electrical services"*
+- *"Update the priority on WO-1234 to urgent"*
 - *"Which projects are at risk or delayed?"*
-- *"Show me all assets linked to the HVAC system in Building 3"*
-- *"List open corrective work orders at all sites"*
 - *"What's the total cost history for Asset X?"*
-- *"Show me all project milestones that are at risk"*
-- *"What's the FCI trend for Site A over the past year?"*
+- *"Create a part for 10-inch butterfly valves"*
 - *"List all replacement plans due in 2027"*
 ## Available tools
-| Tool | Description |
-|------|-------------|
-| `list_assets` | List assets with filters for site, building, system, and search |
-| `get_asset` | Get full details for a specific asset |
-| `list_work_orders` | List work orders filtered by status, priority, type, or site |
-| `get_work_order` | Get full details for a specific work order |
-| `list_sites` | List all sites in your organization |
-| `get_site` | Get details for a specific site |
-| `list_buildings` | List buildings, optionally filtered by site |
-| `list_locations` | List rooms and areas, optionally filtered by building |
-| `list_systems` | List systems (HVAC, plumbing, electrical, etc.) |
-| `list_system_groups` | List system groups |
-| `list_system_classes` | List top-level system classifications |
-| `list_pm_schedules` | List PM schedules filtered by status, frequency, or site |
-| `get_pm_schedule` | Get a PM schedule including tasks and linked assets |
-| `list_pm_templates` | List reusable PM templates |
-| `list_projects` | List capital projects filtered by status or health |
-| `get_project` | Get project details including budget and progress |
-| `list_contracts` | List vendor contracts |
-| `list_compliance_items` | List compliance/regulatory items |
-| `get_compliance_item` | Get a compliance item with linked PM schedules |
-| `get_dashboard_summary` | Get aggregated stats across assets, work orders, and sites |
-| `list_budgets` | List annual funding budgets by year, site, building, or funding source |
-| `get_budget` | Get a single annual funding budget |
-| `list_asset_comments` | List comments on assets, filterable by asset |
-| `get_asset_comment` | Get a single asset comment |
-| `list_asset_costs` | List asset cost records (repairs, PM, operations, replacements) |
-| `get_asset_cost` | Get a single asset cost record with related names |
-| `list_asset_replacement_plans` | List asset replacement plans for lifecycle planning |
-| `get_asset_replacement_plan` | Get a single replacement plan |
-| `list_asset_risk_history` | List risk assessment history for assets |
-| `get_asset_risk_history_entry` | Get a single risk history entry |
-| `list_work_order_comments` | List comments on work orders |
-| `get_work_order_comment` | Get a single work order comment |
-| `list_project_tasks` | List project tasks with status, priority, cost tracking |
-| `get_project_task` | Get a single project task |
-| `list_project_milestones` | List project milestones |
-| `get_project_milestone` | Get a single milestone |
-| `list_project_phases` | List project phases |
-| `get_project_phase` | Get a single phase |
-| `list_project_budget_items` | List project budget line items by category |
-| `get_project_budget_item` | Get a single budget item |
-| `list_project_time_entries` | List time entries for project labor tracking |
-| `get_project_time_entry` | Get a single time entry |
-| `list_project_comments` | List comments on projects (threaded) |
-| `get_project_comment` | Get a single project comment |
-| `list_compliance_records` | List compliance check completion records |
-| `get_compliance_record` | Get a single compliance record |
-| `list_site_fci_history` | List Facility Condition Index history for sites |
-| `get_site_fci_history_entry` | Get a single FCI history entry |
-| `list_dashboard_snapshots` | List monthly aggregate dashboard snapshots |
-| `get_dashboard_snapshot` | Get a single dashboard snapshot |
-| `list_vendor_site_assignments` | List vendor-to-site service mappings |
-| `get_vendor_site_assignment` | Get a single vendor site assignment |
-| `list_contract_sites` | List contract-to-site coverage mappings |
-| `list_custom_field_definitions` | List custom field schemas by entity type |
-| `get_custom_field_definition` | Get a single custom field definition |
-| `list_custom_field_values` | List custom field values by entity or field |
-| `get_custom_field_value` | Get a single custom field value |
-| `list_part_categories` | List part categories |
-| `get_part_category` | Get a single part category |
+### Read tools
+| Resource | List | Get |
+|----------|------|-----|
+| Assets | `list_assets` | `get_asset` |
+| Work Orders | `list_work_orders` | `get_work_order` |
+| Work Requests | `list_work_requests` | `get_work_request` |
+| Sites | `list_sites` | `get_site` |
+| Buildings | `list_buildings` | — |
+| Locations | `list_locations` | — |
+| Systems | `list_systems` | — |
+| System Groups | `list_system_groups` | — |
+| System Classes | `list_system_classes` | — |
+| PM Schedules | `list_pm_schedules` | `get_pm_schedule` |
+| PM Templates | `list_pm_templates` | — |
+| Projects | `list_projects` | `get_project` |
+| Contracts | `list_contracts` | — |
+| Compliance Items | `list_compliance_items` | `get_compliance_item` |
+| Compliance Records | `list_compliance_records` | `get_compliance_record` |
+| Dashboard | — | `get_dashboard_summary` |
+| Dashboard Snapshots | `list_dashboard_snapshots` | `get_dashboard_snapshot` |
+| Vendors | `list_vendors` | `get_vendor` |
+| Invoices | `list_invoices` | `get_invoice` |
+| Purchase Orders | `list_purchase_orders` | `get_purchase_order` |
+| Expenses | `list_expenses` | `get_expense` |
+| Budgets | `list_budgets` | `get_budget` |
+| Parts | `list_parts` | `get_part` |
+| Part Categories | `list_part_categories` | `get_part_category` |
+| Asset Comments | `list_asset_comments` | `get_asset_comment` |
+| Asset Costs | `list_asset_costs` | `get_asset_cost` |
+| Replacement Plans | `list_asset_replacement_plans` | `get_asset_replacement_plan` |
+| Risk History | `list_asset_risk_history` | `get_asset_risk_history_entry` |
+| WO Comments | `list_work_order_comments` | `get_work_order_comment` |
+| Project Tasks | `list_project_tasks` | `get_project_task` |
+| Project Milestones | `list_project_milestones` | `get_project_milestone` |
+| Project Phases | `list_project_phases` | `get_project_phase` |
+| 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` |
+| 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` | — |
+| Custom Field Definitions | `list_custom_field_definitions` | `get_custom_field_definition` |
+| Custom Field Values | `list_custom_field_values` | `get_custom_field_value` |
+| Asset Types | `list_asset_types` | — |
+| Work Categories | `list_work_categories` | — |
+| Manufacturers | `list_manufacturers` | `get_manufacturer` |
+| Building Types | `list_building_types` | — |
+| Location Types | `list_location_types` | — |
+| Cost Categories | `list_cost_categories` | — |
+### Write tools
+| Resource | Create | Update | Delete |
+|----------|--------|--------|--------|
+| Assets | `create_asset` | `update_asset` | `delete_asset` |
+| Work Orders | `create_work_order` | `update_work_order` | `delete_work_order` |
+| Work Requests | `create_work_request` | `update_work_request` | `delete_work_request` |
+| Sites | `create_site` | `update_site` | `delete_site` |
+| Buildings | `create_building` | `update_building` | `delete_building` |
+| Locations | `create_location` | `update_location` | `delete_location` |
+| Systems | `create_system` | `update_system` | `delete_system` |
+| PM Schedules | `create_pm_schedule` | `update_pm_schedule` | `delete_pm_schedule` |
+| Projects | `create_project` | `update_project` | `delete_project` |
+| Contracts | `create_contract` | `update_contract` | `delete_contract` |
+| Vendors | `create_vendor` | `update_vendor` | `delete_vendor` |
+| 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` |
+| 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` |
+| Asset Comments | `create_asset_comment` | `update_asset_comment` | `delete_asset_comment` |
+| Asset Costs | `create_asset_cost` | `update_asset_cost` | `delete_asset_cost` |
+| Replacement Plans | `create_asset_replacement_plan` | `update_asset_replacement_plan` | `delete_asset_replacement_plan` |
+| WO Comments | `create_work_order_comment` | `update_work_order_comment` | `delete_work_order_comment` |
+| Project Tasks | `create_project_task` | `update_project_task` | `delete_project_task` |
+| Project Milestones | `create_project_milestone` | `update_project_milestone` | `delete_project_milestone` |
+| Project Phases | `create_project_phase` | `update_project_phase` | `delete_project_phase` |
+| 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` |
+| 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` |
+| Custom Field Values | `create_custom_field_value` | `update_custom_field_value` | `delete_custom_field_value` |
+| Asset Types | `create_asset_type` | `update_asset_type` | `delete_asset_type` |
+| Work Categories | `create_work_category` | `update_work_category` | `delete_work_category` |
+| 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` |
+| Cost Categories | `create_cost_category` | `update_cost_category` | `delete_cost_category` |
 ## Scopes
-API keys use scopes to control what Claude can access. Grant only the scopes you need:
-| Scope | Access |
-|-------|--------|
-| `assets:read` | Assets |
-| `work_orders:read` | Work orders |
-| `sites:read` | Sites and buildings |
-| `locations:read` | Locations |
-| `systems:read` | Systems, system groups, system classes |
-| `pm_schedules:read` | PM schedules and templates |
-| `projects:read` | Capital projects |
-| `contracts:read` | Vendor contracts |
-| `compliance:read` | Compliance items |
-| `dashboard:read` | Dashboard summary stats |
-| `budgets:read` | Annual funding budgets |
-| `asset_comments:read` | Asset comments |
-| `asset_costs:read` | Asset cost records |
-| `asset_replacement_plans:read` | Asset replacement plans |
-| `asset_risk_history:read` | Asset risk history |
-| `work_order_comments:read` | Work order comments |
-| `project_tasks:read` | Project tasks |
-| `project_milestones:read` | Project milestones |
-| `project_phases:read` | Project phases |
-| `project_budget_items:read` | Project budget items |
-| `project_time_entries:read` | Project time entries |
-| `project_comments:read` | Project comments |
-| `compliance_records:read` | Compliance records |
-| `site_fci_history:read` | Site FCI history |
-| `dashboard_snapshots:read` | Dashboard snapshots |
-| `vendor_site_assignments:read` | Vendor site assignments |
-| `contract_sites:read` | Contract site mappings |
-| `custom_fields:read` | Custom field definitions and values |
-| `part_categories:read` | Part categories |
-| `*:*` | All resources |
+API keys use scopes to control what Claude can access. Configure per-resource read and write access in **Settings → API Keys**.
+| Scope pattern | Access |
+|---------------|--------|
+| `resource:read` | List and get records (e.g. `assets:read`, `work_orders:read`) |
+| `resource:write` | Create, update, and delete records (e.g. `assets:write`, `parts:write`) |
+| `*:*` | Full access to all resources |
+Write scopes require the corresponding read scope to be useful. When creating an API key, scopes are organized by category (Operations, Facilities, Projects, Finance, etc.) with bulk-toggle controls.
 ## Security
-- The MCP server runs **locally** on your machine via stdio — no network server is exposed
-- Your API key is scoped to your organization only
-- All data access is read-only and logged in AssetLab's audit log
-- API keys can be revoked at any time in **Settings → API Keys**
+- Connects via OAuth 2.0 + PKCE through `mcp.assetlab.ca`. Your API key is encrypted in transit and never stored by the MCP server.
+- Your API key is scoped to your organization only.
+- All data access is logged in AssetLab's audit log.
+- API keys can be revoked at any time in **Settings → API Keys**.
+- Write operations require explicit write scopes — read-only by default.
 ## Support

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@assetlab/mcp-server",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "MCP server for AssetLab — connect Claude to your asset management data",
   "type": "module",
   "bin": {