How to Use the HRBlade MCP in Windsurf

Q: How do I update interview templates using HRBlade in Windsurf?

You instruct Cascade to run createinterview with your raw JSON parameters. The agent formats the template structure, pushes it to your ATS, and verifies the new setup in one run.

Q: What happens if an interview invitation fails to send?

The sendinterviewinvitation tool returns a structured error payload to the Cascade agent. Windsurf catches this failure, analyzes the error code, and prompts you with the exact reason, like an invalid email format.

Q: How does this MCP Server secure sensitive candidate video responses?

All data retrieved via listinterviewresponses stays inside your local Windsurf sandbox. Vinkius routes the video metadata through secure, ephemeral isolates, meaning your candidate PII never touches external logs or third-party training sets.

Run your entire HRBlade hiring funnel autonomously inside Windsurf using Cascade's multi-step 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 HRBlade MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Auto-schedule candidate video screens in Windsurf

The `send_interview_invitation` tool runs on this MCP Server to let your Cascade agent dispatch video screen links directly to applicants without you clicking through a browser. Once a new application hits your desk, Cascade scans their profile, pulls their contact info, and fires off the invite. This automation cuts down the time spent chasing candidates for initial screens. Because Windsurf handles the logic, your agent can cross-reference applicant lists and trigger these invites in batches during off-hours.

Cascade analyzes video responses on the fly

Your agent uses `list_interview_responses` to pull down completed candidate video submissions directly into your Windsurf workspace. Cascade reads the transcripts and flags key responses based on your specific rubric. Instead of watching hours of footage, you let your IDE agent summarize the highlights. It pairs these summaries with candidate profiles so you only review the top-tier applicants.

Build custom interview templates inside Windsurf

The `create_interview` tool allows Cascade to build new structured evaluation templates without leaving your editor. Your agent drafts the assessment questions, formats the JSON string payload, and registers the template in your HRBlade account. You can test different evaluation criteria across engineering roles by letting Cascade update these templates dynamically. It ensures your interview loops stay consistent across all engineering hires using this MCP integration.

Setup guide

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

mcp_config.json

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

You configure it by adding the server configuration to your `~/.codeium/windsurf/mcp_config.json` file. Once connected, Cascade automatically discovers the six recruitment tools and starts executing multi-step hiring workflows.

Yes, Cascade handles multi-tool sequences autonomously. For example, it can call `list_candidates` to find active applicants and then immediately trigger `send_interview_invitation` for each one.

You instruct Cascade to run `create_interview` with your raw JSON parameters. The agent formats the template structure, pushes it to your ATS, and verifies the new setup in one run.

The `send_interview_invitation` tool returns a structured error payload to the Cascade agent. Windsurf catches this failure, analyzes the error code, and prompts you with the exact reason, like an invalid email format.

All data retrieved via `list_interview_responses` stays inside your local Windsurf sandbox. Vinkius routes the video metadata through secure, ephemeral isolates, meaning your candidate PII never touches external logs or third-party training sets.

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