How to Use the HrFlow.ai MCP in Windsurf

Q: Can Windsurf handle my resume data using HrFlow.ai?

Yes. You just point the parseprofile tool at your resume file. The server converts it into a machine-readable format that stays local to your session.

Q: Is it possible to automate scoring in Windsurf with HrFlow.ai?

Absolutely. You can set up a script that triggers scoreprofiles for every new candidate you import. Cascade then presents the top matches for your review.

Use the HrFlow.ai MCP server in Windsurf to turn messy resumes into structured data and match candidates to jobs without leaving your IDE.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect HrFlow.ai MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Windsurf agents parse and score resumes instantly

Stop wasting time on manual data entry. Use `parse_profile` to pull raw resume text directly into your project's data schema so your AI client can work with clean, structured JSON. Once the data is ready, `score_profiles` lets you rank candidates against active job requirements. Cascade picks up the output and ranks the matches based on your specific hiring criteria.

Search job boards via Windsurf effortlessly

Finding the right role in a massive database is a slog. Use `search_jobs` to run semantic queries that find relevant postings across your boards without writing complex SQL. After you pull the list, `list_jobs` helps you verify the details. Your agent can then chain these calls to build a list of open positions that actually match your search intent.

Analyze career paths with Windsurf and HrFlow.ai

Surface the signal in a candidate's history by using `unfold_profile`. It breaks down work experience into a clear timeline so your agent can see the actual progression. Follow that up with `ask_profile` to query specific soft skills or technical gaps. You get a direct, natural language answer based on the candidate's verified background.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "hrflowai-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 HrFlow.ai. 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 HrFlow.ai 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 HrFlow.ai MCP in Windsurf

Open your Windsurf settings and head to the Cascade MCP panel. Add the server configuration under mcpServers, hit refresh, and your agent will discover all ten tools immediately.

Yes. You just point the `parse_profile` tool at your resume file. The server converts it into a machine-readable format that stays local to your session.

No. The server is ephemeral and doesn't hold onto your private documents. It only touches the data you explicitly send to the endpoints during your active coding session.

Absolutely. You can set up a script that triggers `score_profiles` for every new candidate you import. Cascade then presents the top matches for your review.

Your candidate profiles and resume files are treated as sensitive memory. The connection uses an endpoint token, and no data is cached on our side once your session ends.

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