# ServiceM8 MCP > ServiceM8 connects your AI agent directly to your entire field service management system. It lets you manage jobs, track staff availability, create client records, and monitor job activity—all through natural conversation. Stop switching between dashboards; get all your operational data in one chat window. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** job-scheduling, work-orders, field-operations, invoicing, gps-tracking, service-management ## Description Running a trade or service business means juggling dozens of details: who needs fixing? When is the crew available? What did they do last week? This MCP lets you manage it all without leaving your chat interface. You tell your AI client what you need—like 'Show me all jobs assigned to John this week'—and it pulls the answers from ServiceM8. It acts like having a dedicated operations manager sitting right next to you, ready to pull up records or schedule changes on demand. Because Vinkius hosts thousands of specialized MCPs, connecting your service software is simple; you just plug in and start talking business immediately. ## Tools ### create_job This tool allows you to create an entirely new job record in ServiceM8. ### get_company Use this to get specific, detailed information about a single client company. ### get_job This retrieves comprehensive details for one specific job ID. ### list_categories You can list the different types of service jobs your company tracks. ### list_companies This tool lists every client or company you have in your records. ### list_contacts You can list all the key contacts associated with any given company. ### list_job_activity This fetches a complete activity history log for a specific job, showing who did what and when. ### list_jobs You can pull a list of all jobs managed in ServiceM8. ### list_staff This lists every staff member who is part of your service team. ## Prompt Examples **Prompt:** ``` List all our active jobs on ServiceM8. ``` **Response:** ``` I've fetched your jobs. You have 5 active projects including 'AC Repair (Job #123)' and 'Kitchen Renovation'. Which one would you like to drill into? ``` **Prompt:** ``` Show me all staff members in the organization. ``` **Response:** ``` Retrieving staff list... I found 8 staff members including 'John Doe' (Technician) and 'Jane Smith' (Admin). Would you like to check the assignments for any of them? ``` **Prompt:** ``` Fetch the activity history for job UUID 550e8400-e29b-41d4-a716-446655440000. ``` **Response:** ``` Inspecting job activity... This job has 3 recorded activities: 'Job Created', 'Scheduled for 2PM', and 'Tech En Route'. Would you like the full timestamp details? ``` ## Capabilities ### Create new field jobs Your agent generates a brand-new job record within ServiceM8. ### Get company details You retrieve specific information for any client or company listed in your database. ### Retrieve job records Your agent pulls all the detailed history and current status of a single service job. ### List staff members You get an overview of who works for you, including their roles and assignments. ### Search client contacts Your agent helps you find specific people or companies associated with your business. ### Track job history You pull a full, chronological log of every action taken on a particular service job. ## Use Cases ### Scheduling an unexpected emergency callout A client calls about an urgent AC repair. Instead of manually logging into ServiceM8, you ask your agent to `get_job` details for the existing account and then use `create_job` to open a new work order immediately. ### Checking team availability before quoting Before promising a service date, you prompt your agent to `list_staff`. You can see who is available and assigned where, allowing you to quote accurately in seconds. ### Auditing job completion after hours You need proof of work for an insurance claim. Asking the agent to `list_job_activity` gives you a full log detailing every status change and action taken on that project. ## Benefits - Stop switching tabs to find job status. You can list all managed jobs or get details for a specific one without leaving your chat interface. - Never lose track of who's working where. Your agent lets you list staff members and check their assignments instantly, acting like an immediate team roster. - Keep client records current. By listing companies and contacts, you ensure your professional data stays synchronized in one place. - Gain operational visibility by accessing real-time job activity logs. You track every step of service delivery without manual reports. - Need to start a new project? Use the `create_job` tool to generate a brand-new work order directly from your chat prompt. ## How It Works The bottom line is your AI client handles the backend calls to ServiceM8 so you don't have to open any web tabs. 1. First, subscribe to this MCP and provide your ServiceM8 API key in the Vinkius connection settings. 2. Next, tell your AI agent what you need using plain language. For example, 'List all jobs scheduled for next Tuesday.' 3. Finally, the AI executes the request through the MCP and hands you the specific data—like a list of jobs or staff details—right back in the chat. ## Frequently Asked Questions **Can ServiceM8 MCP help me see all my active jobs?** Yes, you can list all managed jobs using the `list_jobs` tool. This gives you a comprehensive overview of every project in your system. **How do I check if a technician is available with ServiceM8 MCP?** You use the `list_staff` tool to get an immediate roster of all employees and their current assignments or availability status. **What should I do before using the ServiceM8 MCP for a new client?** First, you can use `list_companies` to check if they already exist in your database. If not, you'll need to create them or gather their details. **Is there a way to track what happened on an old job?** Absolutely. Use the `list_job_activity` tool and provide the specific job ID. It returns every recorded event, from creation to completion status changes.