How to Use the WorkWave MCP in Windsurf

Q: How does WorkWave and Windsurf handle order status changes?

You use updateorderstatus within your workflow. Cascade figures out if you need to change it to Pending, InProgress, or Completed based on the preceding steps.

Q: Can WorkWave and Windsurf list available field staff?

Yep. The listfieldemployees tool gives you a roster of all technicians and field personnel registered in WorkWave that your agent can then use for scheduling logic.

Q: Does WorkWave and Windsurf support checking API health?

It does. You can call getapihealth to verify the connection status of the WorkWave API integration before running a multi-step action. This is great for testing flows.

Automate Field Service Tasks with Windsurf and WorkWave MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect WorkWave MCP to Windsurf

Create your Vinkius account to connect WorkWave to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup WorkWave with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Manage Orders for Windsurf

You can change the lifecycle status of a service order using `update_order_status`. This tool lets you mark an order as Pending, InProgress, or Completed directly. Cascade reads this state and knows when to trigger follow-up actions.

Service Listing for Windsurf

`list_service_locations` shows every physical job site and service area registered in WorkWave. Need to know where the techs are? Use `list_field_employees` to pull a list of all available field staff.

Account Data for Windsurf

`get_account_details` retrieves specific information about any customer account you need. You can pair this with `list_field_service_accounts` to quickly pull a roster of all service clients in the WorkWave platform.

Setup guide

Set up WorkWave MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the WorkWave MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my WorkWave payment history." If connected, Cascade will call the WorkWave tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

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

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by WorkWave. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect WorkWave now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about WorkWave MCP in Windsurf

You use `update_order_status` within your workflow. Cascade figures out if you need to change it to Pending, InProgress, or Completed based on the preceding steps.

Yep. The `list_field_employees` tool gives you a roster of all technicians and field personnel registered in WorkWave that your agent can then use for scheduling logic.

This WorkWave MCP Server touches various operational data, including customer account details, service order information, and field employee profiles. Keep that in mind when setting up your Cascade goal.

It does. You can call `get_api_health` to verify the connection status of the WorkWave API integration before running a multi-step action. This is great for testing flows.

The server touches customer account data, specifically details like service addresses and associated order records. Always confirm your permissions before letting Cascade run complex sequences.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript