# MaintainX MCP

> MaintainX connects your AI agent directly into complex enterprise maintenance systems. It lets you manage physical assets, track facility locations, and coordinate work orders using simple natural language commands. Stop navigating multiple portals; get real-time operational status updates instantly.

## Overview
- **Category:** operations-management
- **Price:** Free
- **Tags:** work-orders, asset-management, maintenance-tracking, field-operations, inventory-control

## Description

This MCP gives your agent the keys to managing large facilities and industrial equipment. Instead of logging into a complex portal with dozens of tabs, you talk to your AI client and tell it what needs doing—whether that's checking asset specs or changing a task's priority.

Your agent can list all physical assets on site, pull up detailed reports, and even update the status of an entire work order just from conversation. It also tracks facility locations so you always know where your team members and equipment are situated. If you use Vinkius to manage your connectors, this MCP plugs directly into that ecosystem, giving you one central place to automate your entire maintenance operation.

## Tools

### list_maintenance_assets
Retrieves a list of all physical assets and equipment managed by the organization.

### create_new_work_order
Creates a new maintenance work order, requiring only a title to initiate the task.

### get_asset_details
Fetches specific metadata and details for one identified asset.

### get_work_order_details
Retrieves full information, including history and priority, for a single work order ID.

### list_facility_locations
Lists all physical sites or areas monitored by the maintenance system.

### update_work_order_status
Changes a work order's status to 'Done' or 'In Progress' using its unique identifier.

### list_team_members
Lists all authorized users and team members within the MaintainX account.

### list_maintenance_orders
Retrieves a filtered or complete list of open work orders using optional parameters for narrowing down results.

## Prompt Examples

**Prompt:** 
```
List all open work orders in MaintainX.
```

**Response:** 
```
I've retrieved your open work orders. You have 5 tasks pending, including 'HVAC Repair (ID: 123)', 'Monthly Safety Check', and 'Generator Maintenance'.
```

**Prompt:** 
```
Update the status of work order ID '123' to 'DONE'.
```

**Response:** 
```
Successfully updated work order 123. The status has been set to 'DONE' in your MaintainX workspace.
```

**Prompt:** 
```
Show details for the asset with ID 'asset-abc'.
```

**Response:** 
```
I've fetched the details for asset-abc. It is a 'Main Boiler' located in 'Section A'. Current status is 'Active' and it has 2 associated open work orders.
```

## Capabilities

### List all physical assets
Retrieves a comprehensive list of every piece of equipment and asset managed by the facility.

### Check specific asset details
Pulls up full technical specifications, history, and metadata for any single asset ID.

### Create new work orders
Generates a brand new maintenance task or service order based on a title and description.

### View specific work order status
Gets the current progress, priority, and details for an existing maintenance job ID.

### Update task progress
Changes a work order's status to 'Done' or 'In Progress' without needing to log into the main system.

### Locate facilities and teams
Lists all known facility sites, areas, and active team members assigned to maintenance tasks.

## Use Cases

### Auditing a facility after a storm
The coordinator asks their agent, 'List all assets in Section C with open work orders.' The system runs `list_maintenance_assets` and filters the results using `list_maintenance_orders`, giving an immediate list of everything that needs checking.

### Closing out a repair job
A technician finishes a repair. Instead of logging in, they tell their agent, 'Update work order 789 to Done.' The MCP runs `update_work_order_status` and confirms the closure instantly.

### Onboarding new personnel
The manager asks the agent to list all team members and then assign a specific work order. The agent uses both `list_team_members` and coordinates assignment updates via the MCP.

### Investigating equipment failure
A user needs specs on an old boiler. They prompt their agent to 'Show details for asset ABC.' The MCP executes `get_asset_details`, pulling up all necessary technical records immediately.

## Benefits

- Stop manually checking status boards. Use the `update_work_order_status` tool to mark tasks as 'Done' or 'In Progress' directly from your conversation.
- Get instant visibility into equipment health. You can use `get_asset_details` to pull up complete technical specs and associated work orders without opening the asset portal.
- Avoid lost data by instantly knowing where things are. The MCP lets you list all facility locations, so you know exactly which site your team is working on.
- Draft tasks in seconds. Use `create_new_work_order` to generate a full maintenance request with just a title and let the system handle the rest of the setup.
- Coordinate team efforts quickly. You can list all available team members using `list_team_members` and assignees for specific maintenance jobs on the fly.

## How It Works

The bottom line is you talk to your AI client, and it executes complex backend maintenance commands directly against MaintainX.

1. Subscribe to this MCP and provide your MaintainX API Key (Bearer Token).
2. Connect the service to your preferred AI client via Vinkius.
3. Ask your agent a question in plain language, like 'What's the status of asset XYZ?' or 'List open work orders for section B.' The tool runs the command and sends back the structured data.

## Frequently Asked Questions

**How do I use the MaintainX MCP to check asset details?**
To get specs, simply ask your agent for 'details on asset XYZ.' The MCP runs `get_asset_details` and pulls up the full technical history directly from MaintainX.

**Can I use the MaintainX MCP to update a work order status?**
Yes. You can tell your agent to 'Mark work order 456 as Done.' The MCP executes `update_work_order_status`, changing the record instantly in your workspace.

**Does the MaintainX MCP list all users?**
It uses the `list_team_members` tool to pull a current roster of every authorized user and team member in the account.

**What if I need to create multiple work orders using the MaintainX MCP?**
You can prompt your agent to 'Create three new work orders: HVAC check, boiler inspection, and pump replacement.' The MCP uses `create_new_work_order` for each request.

**Is the MaintainX MCP better than just looking at the web dashboard?**
Yes. While the dashboard is visual, this MCP brings the data to you using natural language. It's faster and allows your agent to execute complex logic (like filtering multiple open orders) in one step.