How to Use the intelliHR MCP in Windsurf

Q: How do I configure the intelliHR MCP Server in Windsurf?

Open your /.codeium/windsurf/mcpconfig.json file and add the server configuration under the mcpServers key. Alternatively, use the Windsurf settings UI to paste the connection details. Once saved, Cascade immediately detects the new MCP tools.

Q: Can Windsurf autonomously update employee records in intelliHR?

No, this integration is read-only. Tools like getperson and listpeople allow Cascade to retrieve details, but it cannot modify or delete any records in your directory.

Q: What tools are available for checking organizational structure?

You can use listpositions, listjobs, and listbusinessentities to map out your company. These tools let your agent see how roles are distributed across different entities.

Let Windsurf autonomously query your HR directory and map organizational structures.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect intelliHR MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Map employee skills and training in Windsurf

Cascade reads your prompt and chains `list_people`, `list_skills`, and `list_training` to build a complete profile of your team's capabilities. It does not ask you for permission at every step. It just gathers the data and presents a finished report on who is trained for what. You get a direct view of your organizational skills gap without manually cross-referencing spreadsheets. Cascade handles the API pagination and filters the results down to exactly what you asked for.

Audit payroll data using Cascade automation

Let this MCP Server handle the heavy lifting of compensation audits. Cascade calls `list_remuneration` and matches it against `list_jobs` to flag discrepancies in salary bands across different departments. It runs these checks in the background while you focus on other work. You see the final list of anomalies directly in your editor without writing a single line of integration code.

Verify office locations and legal entities

Cascade inspects your organizational footprint by hitting `list_locations` and `list_business_entities` in a single run. It maps which employees belong to which legal entities so your compliance reports are always accurate. Instead of navigating multiple HR dashboards, you let your IDE pull this data directly into your active workspace. It makes onboarding and location-based reporting incredibly straightforward.

Setup guide

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

mcp_config.json

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

Open your ~/.codeium/windsurf/mcp_config.json file and add the server configuration under the mcpServers key. Alternatively, use the Windsurf settings UI to paste the connection details. Once saved, Cascade immediately detects the new MCP tools.

No, this integration is read-only. Tools like `get_person` and `list_people` allow Cascade to retrieve details, but it cannot modify or delete any records in your directory.

Cascade manages API requests sequentially when executing its plans. If you run a broad query that triggers `list_people`, it handles pagination automatically without hitting API thresholds.

You can use `list_positions`, `list_jobs`, and `list_business_entities` to map out your company. These tools let your agent see how roles are distributed across different entities.

Your API tokens are stored locally in your Windsurf configuration and never sent to third-party LLMs. The MCP server runs in a secure V8 sandbox, ensuring your employee directory details remain private.

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