Can my AI automatically find the details and activity for a specific job just by providing its UUID?

Yes! Use the `get_job` tool with the Job UUID. Your agent will respond with complete metadata, including status, scheduled times, and specific operational notes in seconds.

How do I list all staff members to check availability?

Simply ask the agent to run the `list_staff` action. It will retrieve the full directory of staff members configured in your ServiceM8 account.

How do I find my ServiceM8 API Key?

Log in to your ServiceM8 dashboard, navigate to **Settings** > **ServiceM8 Add-ons**, and enable the **API** add-on to find your unique API Key.

INSTANT PLUG AND PLAY

ServiceM8 MCP Server for WindsurfGive Windsurf instant access to 9 tools to Create Job, Get Company, Get Job, and more

Name: ServiceM8
Availability: InStock
Author: Vinkius

Built by Vinkius GDPR 9 Tools IDE

Windsurf brings agentic AI coding to a purpose-built IDE. Connect ServiceM8 through Vinkius and Cascade will auto-discover every tool. ask questions, generate code, and act on live data without leaving your editor.

Use with Your AI Agent

Ask AI about this App Connector for Windsurf

Open in ChatGPT Open in Claude Open in Perplexity

The ServiceM8 app connector for Windsurf is a standout in the Industry Titans category — giving your AI agent 9 tools to work with, ready to go from day one.

Vinkius delivers Streamable HTTP and SSE to any MCP client

RecommendedModern Approach — Zero Configuration

Vinkius Desktop App

The modern way to manage MCP Servers — no config files, no terminal commands. Install ServiceM8 and 3,400+ MCP Servers from a single visual interface.

Download Free Open SourceNo signup required

Classic Setup·json

{
  "mcpServers": {
    "servicem8": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About ServiceM8 MCP Server

Connect your ServiceM8 account to any AI agent and take full control of your field service management workflows through natural conversation. ServiceM8 is the ultimate platform for trade and service businesses, and this integration allows you to orchestrate jobs, coordinate staff, and manage client relations without leaving your chat interface.

Windsurf's Cascade agent chains multiple ServiceM8 tool calls autonomously. query data, analyze results, and generate code in a single agentic session. Paste Vinkius Edge URL, reload, and all 9 tools are immediately available. Real-time tool feedback appears inline, so you see API responses directly in your editor.

What you can do

Job & Task Orchestration — List all managed jobs and retrieve detailed metadata, including status and scheduled times programmatically.
Staff & Team Coordination — Access and monitor your staff directory to maintain a clear overview of team assignments and availability directly from the AI interface.
Client CRM Control — List and search through your client and contact database to keep your professional records synchronized via natural language.
Job Activity Tracking — Access real-time activity logs for specific jobs to monitor progress and ensuring high-quality service delivery.
Operational Monitoring — Track job categories and manage system metadata to ensure your field service operations are always optimized.

The ServiceM8 MCP Server exposes 9 tools through the Vinkius. Connect it to Windsurf in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

All 9 ServiceM8 tools available for Windsurf

When Windsurf connects to ServiceM8 through Vinkius, your AI agent gets direct access to every tool listed below — spanning job-scheduling, work-orders, field-operations, and more. Every call is secured with network, filesystem, subprocess, and code evaluation entitlements inside a sandboxed runtime. Beyond a simple connection, you get a full AI Gateway with real-time visibility into agent activity, enterprise governance, and optimized token usage.

create_job

Requires description and company_uuid. Create a new ServiceM8 job

get_company

Get details for a specific company

get_job

Get details for a specific job

list_categories

List job categories

list_companies

List all companies (clients)

list_contacts

List all company contacts

list_job_activity

Get activity history for a job

list_jobs

List all ServiceM8 jobs

list_staff

List ServiceM8 staff members

Connect ServiceM8 to Windsurf via MCP

Follow these steps to wire ServiceM8 into Windsurf. The entire setup takes under two minutes — your credentials stay safe behind the Vinkius.

Open MCP Settings

Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"

Add the server

Paste the JSON configuration above into mcp_config.json

Save and reload

Windsurf will detect the new server automatically

Start using ServiceM8

Open Cascade and ask: "Using ServiceM8, help me...". 9 tools available

Why Use Windsurf with the ServiceM8 MCP Server

Windsurf provides unique advantages when paired with ServiceM8 through the Model Context Protocol.

Windsurf's Cascade agent autonomously chains multiple tool calls in sequence, solving complex multi-step tasks without manual intervention

Purpose-built for agentic workflows. Cascade understands context across your entire codebase and integrates MCP tools natively

JSON-based configuration means zero code changes: paste a URL, reload, and all 9 tools are immediately available

Real-time tool feedback is displayed inline, so you see API responses directly in your editor without switching contexts

ServiceM8 + Windsurf Use Cases

Practical scenarios where Windsurf combined with the ServiceM8 MCP Server delivers measurable value.

Automated code generation: ask Cascade to fetch data from ServiceM8 and generate models, types, or handlers based on real API responses

Live debugging: query ServiceM8 tools mid-session to inspect production data while debugging without leaving the editor

Documentation generation: pull schema information from ServiceM8 and have Cascade generate comprehensive API docs automatically

Rapid prototyping: combine ServiceM8 data with Cascade's code generation to scaffold entire features in minutes

Example Prompts for ServiceM8 in Windsurf

Ready-to-use prompts you can give your Windsurf agent to start working with ServiceM8 immediately.

"List all our active jobs on ServiceM8."

"Show me all staff members in the organization."

"Fetch the activity history for job UUID 550e8400-e29b-41d4-a716-446655440000."

Troubleshooting ServiceM8 MCP Server with Windsurf

Common issues when connecting ServiceM8 to Windsurf through the Vinkius, and how to resolve them.

Server not connecting

Check Settings → MCP for the server status. Try toggling it off and on.

ServiceM8 + Windsurf FAQ

Common questions about integrating ServiceM8 MCP Server with Windsurf.

How does Windsurf discover MCP tools?

Windsurf reads the mcp_config.json file on startup and connects to each configured server via Streamable HTTP. Tools are listed in the MCP panel and available to Cascade automatically.

Can Cascade chain multiple MCP tool calls?

Yes. Cascade is an agentic system. it can plan and execute multi-step workflows, calling several tools in sequence to accomplish complex tasks without manual prompting between steps.

Does Windsurf support multiple MCP servers?

Yes. Add as many servers as needed in mcp_config.json. Each server's tools appear in the MCP panel and Cascade can use tools from different servers in a single flow.