# MaintainX MCP for AI Agents AI Agent Connect > MaintainX connects your maintenance workspace to your AI agent so you can manage work orders and assets without jumping between tabs. It pulls real-time data on machinery health, facility locations, and team assignments. Use it to update task statuses, create new work orders, and audit your physical sites directly from a chat interface. ## Overview - **Category:** operations-management - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_IQWu4LrBgISQyO5B2FFG3HEqbmYBrQUHbpRYVkgs/ai-agent-connect - **Tags:** work-orders, asset-management, maintenance-tracking, field-operations, inventory-control ## Description MaintainX connects your workspace to your AI agent so you can manage maintenance operations and assets through natural language. Instead of digging through complex dashboards to find out why a specific piece of equipment is down, you just ask your agent to pull the details. You can see the current status of every maintenance task, check where specific assets are located across different sites, and get a clear picture of your team's workload in seconds. It handles the heavy lifting of data retrieval so you can focus on actually fixing things. When you're looking for a way to manage large-scale facility operations more effectively, Vinkius makes it easy to plug this into your existing workflow. You can tell your agent to create a new work order for a broken boiler or update a finished task to 'Done' without ever touching the portal. It turns your maintenance data into something you can actually talk to and act on. You don't have to worry about memorizing specific IDs or navigating nested menus to find out who's assigned to a job. Your agent keeps the information in front of you, making it easy to coordinate repairs across multiple locations. Whether you're auditing machinery health or checking site locations, this connection ensures your maintenance data is always reachable. It takes the friction out of facility management by making the data work for you, rather than making you work for the data. ## Tools ### create_new_work_order Use create_new_work_order to log a new maintenance task with a title. This lets you record issues as soon as they're reported in the field. ### get_asset_details Use get_asset_details to see metadata for a specific piece of equipment. This helps you quickly check the current state and history of your machinery. ### get_work_order_details Use get_work_order_details to pull all the information for a specific maintenance task. It's the fastest way to see priorities and descriptions in one view. ### list_facility_locations Use list_facility_locations to see a full list of all physical sites in your account. This is perfect for auditing your geographic footprint at a glance. ### update_work_order_status Use update_work_order_status to change a task to 'DONE' or 'IN_PROGRESS'. This keeps your team's progress updated in real time without manual entry. ### list_team_members Use list_team_members to see everyone in your MaintainX account. Use this to check who's available for new assignments or to manage your team. ### list_maintenance_orders Use list_maintenance_orders to see all work orders with optional filters. It gives you a bird's-eye view of all pending and completed tasks. ### list_maintenance_assets Use list_maintenance_assets to see every physical asset and piece of equipment. It's great for getting a total count of your inventory. ## Prompt Examples **Prompt:** ``` What's the status of the HVAC repair? ``` **Response:** ``` I've checked your open work orders. Here is the status of the HVAC repair: | Task ID | Description | Status | Priority | | :--- | :--- | :--- | :--- | | #123 | **HVAC Repair** | 🟡 In Progress | High | It looks like the team is currently working on it. ``` **Prompt:** ``` List all open work orders for the warehouse. ``` **Response:** ``` I found 3 open work orders for the warehouse area: * **Forklift Maintenance** (ID: 456) - *Priority: Medium* * **Loading Dock Repair** (ID: 789) - *Priority: High* * **Lighting Replacement** (ID: 101) - *Priority: Low* ``` **Prompt:** ``` Create a work order for the broken forklift. ``` **Response:** ``` I've created a new work order for you. **New Work Order Created** * **Title:** Broken Forklift * **Status:** New * **ID:** #1122 Would you like me to assign this to a specific team member? ``` ## Capabilities ### Check machinery health Get metadata for a specific piece of equipment to see its current status and history. ### Update task progress Change work order statuses like 'In Progress' or 'Done' instantly from your chat. ### Find facility sites List all physical locations and areas where your team members are currently stationed. ### Create work orders Generate a new maintenance task with a title using plain text commands. ### Audit team assignments See who is assigned to which specific maintenance task across your entire account. ## Use Cases ### HVAC Repair Tracking A manager asks the agent to find all open HVAC work orders and summarizes the priorities for the morning shift. ### Site Audit A coordinator asks for a list of all facility locations and the assets located at each one to prepare for an inspection. ### Equipment Failure A technician reports a broken pump. The user tells the agent to create a new work order and assign it to the nearest team member. ### Status Sync An operator tells the agent 'The generator is fixed' and the agent updates the status to 'DONE' in the workspace. ## Benefits - Stop switching between tabs by viewing all pending tasks in one conversational list. - Get instant answers on equipment health without searching through a database. - Update task progress to 'Done' or 'In Progress' instantly during a chat. - Locate specific assets across multiple sites with a single spoken command. - Log new maintenance issues as they happen to keep your records accurate. - Coordinate your team more effectively by seeing who is assigned to what job. ## How It Works The bottom line is you get a conversational interface for your entire maintenance and asset database. 1. Subscribe to the MaintainX MCP on Vinkius. 2. Enter your MaintainX API Key (Bearer Token) into your AI client settings. 3. Ask your agent to list work orders or check asset health to start managing your site. ## Frequently Asked Questions **Can MaintainX MCP help with my work orders?** Yes, it allows your AI agent to read, list, and update your work orders in real time. You can check statuses or create new tasks just by asking your agent. **How do I see my assets with the MaintainX MCP?** You can ask your agent to list all assets or get specific details for a single piece of equipment. It will pull the metadata directly from your workspace. **Can I update task status via chat using MaintainX?** Yes, you can tell your agent to change a work order status to 'Done' or 'In Progress'. The change will reflect in your MaintainX account immediately. **Does the MaintainX MCP support multiple facility locations?** Yes, it can list all your facility locations. This makes it easy to audit different sites or find assets across your entire geographic footprint. **How do I get my team info through the MaintainX MCP?** Your agent can list all the users in your MaintainX account. This helps you see who is available for assignments without opening the user management portal. **Can I create new maintenance tasks with the MaintainX MCP?** Yes, you can just tell your agent to create a new work order with a title. It will log the new task into your workspace automatically. **How do I find my MaintainX API Key?** Log in to your MaintainX account as an admin, navigate to Settings > Integrations, and click 'New Key' to generate your token. Your token is encrypted at rest and injected securely at runtime. **What status codes should I use for work orders?** Common status codes include 'OPEN', 'IN_PROGRESS', 'DONE', and 'ON_HOLD'. Use the `update_work_order_status` tool with these values. **Can I see which asset is linked to a work order?** Yes, when using `list_maintenance_orders`, you can provide `params` with `include=assets` to see linked equipment names in the results.