How to Use the Humaans MCP in Windsurf

Q: How does Windsurf Cascade use the Humaans MCP Server to check team availability?

Cascade calls listleaves to see which Humaans users are out of the office. It crosses this with Humaans listpublicholidays to build a live calendar of team availability directly inside your Windsurf IDE.

Q: Can I map active developers to their specific roles using Humaans in Windsurf?

Yes, Windsurf Cascade queries Humaans listroles and listemployees to match active code authors with their official job titles. This lets you audit repository permissions against your live Humaans directory.

Q: How do I initialize the MCP connection inside the Windsurf workspace?

Add the server configuration to your Windsurf mcpconfig.json file. Once connected, Windsurf Cascade automatically discovers the ten available Humaans tools and uses them during conversational coding sessions.

Q: Can Cascade pull company documents using this integration?

Yes, Cascade invokes Humaans listdocuments to locate company policies or employee-specific files. It reads this Humaans file metadata to ensure your Windsurf workspace documentation matches official records.

Feed Humaans HRIS data straight into Windsurf Cascade to automate team mapping and leave tracking without manual lookups.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Humaans MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Map organizational structures in Windsurf

The `list_departments` tool pulls your Humaans organizational structure directly into your active Windsurf workspace. Cascade reads this Humaans structure, chains a follow-up query using `list_teams`, and draws an accurate map of your reporting lines. You do not need to copy-paste Humaans team rosters into your Windsurf editor anymore. The Windsurf agent matches these Humaans departments with active project repositories to assign code owners automatically.

Coordinate team coverage and leave schedules

The `list_leaves` tool retrieves active Humaans time-off requests to let Windsurf Cascade check who is actually available before assigning urgent tasks. By combining this Humaans data, Windsurf builds a reliable delivery timeline that respects regional office closures. When a Humaans team member goes offline, Windsurf dynamically adjusts project deadlines. It uses `list_offices` to help Windsurf identify alternative contributors in the same region, keeping your sprint planning grounded.

Automate team onboarding with this MCP Server

The `get_employee` tool extracts specific Humaans profile data to help Windsurf Cascade build personalized onboarding checklists. The Windsurf agent triggers this flow the moment a new employee is added, pulling Humaans roles directly from `list_roles`. This Humaans MCP Server eliminates manual directory searches during Windsurf setup. Windsurf Cascade reads the new hire's department, locates their team files, and provisions access to the exact Humaans documentation they need.

Setup guide

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

mcp_config.json

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

Cascade calls `list_leaves` to see which Humaans users are out of the office. It crosses this with Humaans `list_public_holidays` to build a live calendar of team availability directly inside your Windsurf IDE.

Yes, Windsurf Cascade queries Humaans `list_roles` and `list_employees` to match active code authors with their official job titles. This lets you audit repository permissions against your live Humaans directory.

Add the server configuration to your Windsurf `mcp_config.json` file. Once connected, Windsurf Cascade automatically discovers the ten available Humaans tools and uses them during conversational coding sessions.

Yes, Cascade invokes Humaans `list_documents` to locate company policies or employee-specific files. It reads this Humaans file metadata to ensure your Windsurf workspace documentation matches official records.

Your Humaans API token remains isolated within the local Windsurf runtime. Windsurf handles Humaans employee details, leave requests, and document lists locally, meaning your private HR data never touches external training servers.

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