How to Use the KPA Flex MCP in Windsurf

Q: How does KPA Flex integrate with Windsurf to run multi-step safety audits?

Cascade reads your prompt and plans the sequence. It calls listflexemployees to find active staff, then automatically queries getemployeeehsprofile for each person to verify their current safety standing.

Q: Can Cascade in Windsurf automatically flag expired KPA Flex safety training?

Yes. Cascade uses listsafetytrainings to pull active records and compares the completion dates against your compliance requirements. It runs this check autonomously, flagging expired certs in your workspace.

Q: How do I configure the KPA Flex MCP Server in my Windsurf settings?

Open your /.codeium/windsurf/mcpconfig.json file and add this server under the mcpServers key. Once you hit refresh in the Windsurf MCP panel, Cascade instantly discovers the safety tools.

Q: Can I inspect custom safety forms using this toolset?

Yes. You can query listcustomforms to see what templates your team uses in the field. From there, you can instruct your agent to retrieve the specific layout using getformschema to understand what data points are being collected.

Audit safety training and track active field inspections directly from Windsurf using Cascade's autonomous tool chains.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect KPA Flex MCP to Windsurf

Create your Vinkius account to connect KPA Flex 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 KPA Flex with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Chain safety audits autonomously with Windsurf

Give Cascade a goal like checking if field workers are certified before they head to a job site. The agent calls `list_flex_employees` to grab your roster, checks their training history via `list_safety_trainings`, and flags anyone missing required credentials without you writing a single line of code. Windsurf runs this entire sequence in one shot. It reads the output from each tool, decides if it needs to query `get_employee_ehs_profile` for specific field flags, and presents you with a finished compliance report in your chat panel.

Dig into field inspection details with this MCP Server

When an inspection fails, Cascade doesn't just show you the error. It uses this server to pull the raw form structure with `get_form_schema` and then fetches the exact failure points using `get_inspection_details`. The agent connects these data points to pinpoint where your site operations broke down. You get a clear picture of whether a safety violation was a one-off mistake or a systemic issue across multiple custom forms.

Track physical assets against site incidents

Cascade links physical equipment failures directly to your safety reports. It queries `list_company_assets` to pull your active machinery list, then runs `search_ehs_reports` to see if those specific assets show up in recent incident logs. Instead of clicking through five different compliance dashboards, you let Windsurf handle the cross-referencing. It grabs the site metrics with `get_flex_site_stats` to show you which locations have the highest equipment-related risk.

Setup guide

Set up KPA Flex 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 KPA Flex 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 KPA Flex payment history." If connected, Cascade will call the KPA Flex tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "kpa-flex-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 KPA Flex. 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 KPA Flex 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 KPA Flex MCP in Windsurf

Cascade reads your prompt and plans the sequence. It calls `list_flex_employees` to find active staff, then automatically queries `get_employee_ehs_profile` for each person to verify their current safety standing.

Yes. Cascade uses `list_safety_trainings` to pull active records and compares the completion dates against your compliance requirements. It runs this check autonomously, flagging expired certs in your workspace.

Open your `~/.codeium/windsurf/mcp_config.json` file and add this server under the `mcpServers` key. Once you hit refresh in the Windsurf MCP panel, Cascade instantly discovers the safety tools.

Yes. You can query `list_custom_forms` to see what templates your team uses in the field. From there, you can instruct your agent to retrieve the specific layout using `get_form_schema` to understand what data points are being collected.

Vinkius runs this MCP Server in an isolated V8 sandbox, ensuring your employee safety profiles and incident reports never leak. Your API token is handled securely at the gateway level, so Windsurf only accesses the specific KPA Flex endpoints required to run your queries.

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