How to Use the BrioHR MCP in Windsurf

Cascade chains BrioHR tools to pull payroll, check leave requests, and audit team details inside Windsurf without constant prompting.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect BrioHR MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Cascade chains BrioHR tool sequences in Windsurf

Cascade executes BrioHR `get_payroll_summary` and pairs it with `list_claim_reports` to build complete monthly financial profiles inside Windsurf without waiting for your input. It spots mismatches between BrioHR claims and base salary by running these tools back-to-back in your active editor. You give Cascade one command to audit a department's monthly spend using BrioHR data. It handles the API calls, grabs the data, and presents a finished report directly in your Windsurf workspace.

Track team availability and leave requests

Your Windsurf editor monitors who is out of the office by pulling live schedules with BrioHR `get_who_is_away` and mapping them against `list_leave_requests`. Cascade identifies scheduling conflicts before you assign new tasks to teammates. This setup keeps your resource planning accurate within Windsurf. You don't have to open a BrioHR browser tab to check who is taking off next week because the live data lives right in your active editor.

Automate hiring and review pipelines

The Windsurf editor updates your recruitment tracking by fetching active BrioHR roles with `list_job_postings` and matching candidates via `list_job_candidates`. Cascade evaluates applicant profiles against open positions to flag the best matches. It then pulls BrioHR `list_performance_appraisals` to help you compare internal talent with external applicants in Windsurf. This keeps your hiring pipeline moving without manual copy-pasting.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "briohr-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 BrioHR. 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 BrioHR 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 BrioHR MCP in Windsurf

Cascade reads the schema of the BrioHR MCP server and calls tools like `list_employees` directly. It runs the tools in sequence to answer your prompts without needing manual step-by-step guidance.

Yes, you can ask Cascade to list your organizational structure using `list_departments` and cross-reference employee details. The agent handles the data extraction and structures it inside your active workspace.

No, the connection runs through a local Vinkius endpoint that translates tool calls instantly. Windsurf executes your queries in milliseconds without lagging your editor.

Open your Windsurf settings, go to the Cascade MCP configuration, and paste your Vinkius server URL. Cascade instantly discovers all ten tools, making them ready for your next prompt.

Your payroll summaries and employee profiles never touch external AI training sets. The Vinkius MCP server sandbox isolates all data transfers, ensuring that sensitive HR records remain strictly between your editor and the platform.

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