# WorkWave MCP MCP > WorkWave MCP manages your entire field service operation through natural conversation. Use this connector to list customer accounts, check full order details, track equipment inventory, and verify technician profiles directly from your agent. It handles everything from initial job scheduling to updating final completion statuses without you touching a dashboard. ## Overview - **Category:** customer-support - **Price:** Free - **Tags:** dispatching, service-orders, mobile-workforce, scheduling, customer-management, logistics ## Description Managing field services usually means jumping between six different dashboards: one for customers, one for jobs, one for people, and one for assets. This MCP changes that. You talk to your AI client—Claude, Cursor, or any compatible agent—and it handles the entire conversation with WorkWave. Need to know if a job is ready? Ask it; it pulls up the full order details. The customer's billing history? Just ask. We even let you track managed equipment inventory and find precise site coordinates for routing. Because this MCP deals with so many interconnected systems—accounts, orders, staff, assets—the real power comes when you combine it with other services in the Vinkius catalog. You can chain a WorkWave connection with a billing platform to automate an entire service closeout process, all through one agent conversation. ## Tools ### get_account_details Pulls up all details for a single specified customer account. ### get_api_health Checks if the WorkWave connection is active and syncing data correctly. ### get_employee_profile Retrieves specific profile information for a single employee or technician. ### get_order_details Pulls up the full details and history of one service order. ### list_field_service_accounts Provides a list of every customer account managed within the platform. ### list_field_employees Lists all field staff, including their names and roles, who are registered in WorkWave. ### list_service_equipment Lists all company-managed assets and equipment used across field operations. ### list_service_locations Retrieves a list of physical job sites and service locations, including coordinates. ### list_service_orders Lists all open work requests or active service orders for review. ### update_order_status Changes the lifecycle status of a specific service order to Pending, InProgress, or Completed. ## Prompt Examples **Prompt:** ``` List all active service orders in WorkWave. ``` **Response:** ``` I found 8 active service orders: 1. #ORD-101 (Status: Pending), 2. #ORD-102 (Status: InProgress), 3. #ORD-103 (Status: Pending), and 5 others. Which one would you like to see the details for? ``` **Prompt:** ``` Update order #ORD-101 status to 'InProgress'. ``` **Response:** ``` Success! I've updated the status of service order #ORD-101 to 'InProgress'. The change is now reflected in your WorkWave dashboard. ``` **Prompt:** ``` Find the profile for technician ID 'tech-555'. ``` **Response:** ``` Profile for tech-555: Name: Alice Johnson, Role: Senior Technician, Skills: HVAC, Electrical, Plumbing. Contact: alice@example.com. Would you like me to check her current assigned jobs? ``` ## Capabilities ### List Service Orders Retrieves a list of current work requests and open job tickets. ### Get Account Details Pulls up all contact info, billing records, and service locations for any specific customer account. ### Update Order Status Changes the lifecycle status of a job order (e.g., from Pending to Completed). ### Find Employee Profiles Looks up details, roles, and skills for any registered technician or field staff. ### Audit Equipment Inventory Monitors and lists all physical assets and equipment used across your service network. ### Locate Service Sites Gets precise physical addresses and geographical coordinates for job sites. ## Use Cases ### End of Day Status Audit The dispatch manager asks: 'What orders are pending completion today?' The agent runs `list_service_orders`, filters them, and then you can ask it to check the account details for those specific customers using `get_account_details`. ### New Technician Onboarding A supervisor needs to verify a new hire's credentials. They ask the agent to find the profile via `get_employee_profile`, confirming their role and skills without searching HR systems separately. ### Billing Dispute Resolution Customer support gets a call about an overcharge. Instead of asking for account numbers, they ask the agent to check the billing history using `get_account_details`, immediately finding the discrepancy. ### Job Site Coordination A field technician arrives at a new site and needs confirmation of the address. They ask the agent for nearby locations, triggering `list_service_locations` to confirm coordinates before starting work. ## Benefits - Stop manually checking job statuses. You can use the `update_order_status` function to change a work request's status (like marking it Completed) using simple chat commands. - Need customer context? Instead of switching tabs, your agent calls `get_account_details` to pull up contact info and billing history instantly when you ask for it. - Avoid lost assets. The MCP lets you list equipment inventory via `list_service_equipment`, giving an immediate audit trail of all managed gear. - Faster dispatching means less time on dashboards. You can use `get_employee_profile` to verify a technician's skills and roles before assigning them a job. - Location data is instant. Use `list_service_locations` to get physical job site addresses, including the necessary geographical coordinates for routing services. ## How It Works The bottom line is: you talk to your AI client once from one spot and access data across all of WorkWave. 1. Subscribe to this MCP and enter your WorkWave API key. 2. Connect your AI client (like Cursor or Claude) to the Vinkius platform using that single connection. 3. Talk to your agent naturally. You can ask it to list orders, then follow up by asking for a specific account's billing history. ## Frequently Asked Questions **How do I use the WorkWave MCP to update an order status?** You tell your agent to run `update_order_status` and specify the order ID and the new status (e.g., 'InProgress'). The agent confirms the change is recorded in WorkWave. **Can I find all customers using list_field_service_accounts?** Yes, running `list_field_service_accounts` provides a complete roster of every customer account managed by WorkWave. You can then ask for specific details on any one of those accounts. **What is the difference between list_service_orders and get_order_details?** `list_service_orders` gives you a summary list, showing many jobs at once. `get_order_details` takes one specific order ID and gives you everything about that single job's history and status. **How do I find out which employees are available?** Use the `list_field_employees` tool. It lists all registered field staff so you can check their roles, skills, and contact info before scheduling a job. **How do I check if the WorkWave connection is active and authorized using `get_api_health`?** The tool immediately confirms your API integration status. It verifies that your key is valid, the service is reachable, and data sync is running in real-time. If it fails, the output specifies whether the issue is authentication or a connectivity problem. **When using `list_service_locations`, what specific data points can I pull for job site addresses?** The tool retrieves comprehensive location details, including the full physical address and precise geographical coordinates. These coordinates are crucial for routing purposes or calculating service radius estimates. **If I need to know which assets were used on an order, how do I link them using `get_order_details`?** The returned data payload from `get_order_details` contains a section that lists all associated equipment and managed assets. This allows your agent to pull inventory details specific to that single service job. **What information does `list_service_equipment` provide regarding an asset's status?** This function provides a full audit trail for managed equipment, showing the current operational status. You can check if the device is active, decommissioned, or assigned to a specific service location. **Can I update the status of a work order through the agent?** Yes. The `update_order_status` tool allows your AI agent to change the lifecycle status of any service order (e.g., to 'InProgress' or 'Completed') so you can manage dispatching directly through chat. **How do I see the contact details for a field technician?** You can use the `get_employee_profile` tool. Simply provide the unique employee ID, and your agent will return their full profile details, including contact information and assigned skills. **Is it possible to list all service locations for a customer?** Absolutely. Using the `list_service_locations` tool, you can retrieve a list of all physical sites and addresses registered in your WorkWave instance, helping you coordinate where jobs need to be performed.