Humaans Connector for AI agents.

10 live capabilities

Manage global employee data and leave requests without leaving your chat interface.

Live agent request Humaans / Connector

Waiting for input…

AI Agent

Why people use Humaans

Humaans for Solving Manual HRIS Data Entry

With this Connector, you can just ask your agent. You get a conversational way to query your HRIS, allowing you to pull a list of employees or check leave requests in seconds. You get your answers immediately without the manual clicking.

What Vinkius changes

You get a conversational interface for your entire HRIS database.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 5,900+ Connectors

Real-world use case 01

Quick Onboarding

An HR generalist asks the agent for the details of a new hire.
Real-world use case 02

Capacity Planning

A team lead asks who is on vacation next week.
Real-world use case 03

Org Mapping

An ops manager needs to see the company structure.

Complete set · 10capabilities

The complete Humaans capability set.

These are the exact actions your AI can choose when you ask it to work with Humaans.

Capability set01 / 03

01—04

4 capabilities in this set.

Part of 10 available through Humaans.

01 Capability
List documents
View company and employee documents. This helps you find internal records or policies quickly.
02 Capability
List employees
Get a full list of everyone. This is great for pulling a complete directory of your staff.
03 Capability
List leaves
See who is out of the office. This lets you track leave requests without opening separate tabs.
04 Capability
List roles
See all job titles. This helps you understand the various roles available within your company.

Capability set02 / 03

05—07

3 capabilities in this set.

Part of 10 available through Humaans.

05 Capability
List teams
See all team structures. This allows you to see how your organization is grouped into teams.
06 Capability
Get me
See your own account info. This helps the agent understand which user is currently authenticated.
07 Capability
List departments
See all company departments. Use this to map out the various divisions of your organization.

Capability set03 / 03

08—10

3 capabilities in this set.

Part of 10 available through Humaans.

08 Capability
List offices
See all physical locations. This helps you coordinate logistics across different global offices.
09 Capability
List public holidays
Get a list of public holidays. Use this to plan deadlines across different time zones and regions.
10 Capability
Get employee
Get specific details for an individual. This is useful for quick profile lookups during the onboarding process.

Set up in minutes

One URL. Then ask Humaans to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Humaans from the conversation.

Choose your client

Live preview

Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_LarqqH4EDHEPnslQdaPVgGeeelzn7f5eRT2uEUac/mcp

Step 01

Open Connectors

In Claude Web or Claude Desktop, open Settings and choose Connectors.
Step 02

Add the URL

Choose Add custom connector, name it Humaans, and paste the URL above.
Step 03

Turn it on in chat

Select +, open Connectors, and enable Humaans for the conversation.

ChatGPT · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_LarqqH4EDHEPnslQdaPVgGeeelzn7f5eRT2uEUac/mcp

Step 01

Open MCP settings

On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
Step 02

Add the URL

Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Humaans URL.
Step 03

Save and start

Save the connection and enable Humaans in your conversation. Desktop may ask you to restart once.

Cursor · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "humaans": {
      "url": "https://edge.vinkius.com/vk_preview_LarqqH4EDHEPnslQdaPVgGeeelzn7f5eRT2uEUac/mcp"
    }
  }
}

Step 01

Open MCP Settings

Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
Step 02

Add the server config

Paste the JSON configuration above into the mcp.json file that opens
Step 03

Save the file

Cursor will automatically detect the new Connector
Step 04

Start using Humaans

Open Agent mode in chat and ask: "Using Humaans, help me...". 10 tools available

VS Code Copilot · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "humaans": {
      "url": "https://edge.vinkius.com/vk_preview_LarqqH4EDHEPnslQdaPVgGeeelzn7f5eRT2uEUac/mcp"
    }
  }
}

Step 01

Create MCP config

Create a .vscode/mcp.json file in your project root
Step 02

Add the server config

Paste the JSON configuration above
Step 03

Enable Agent mode

Open GitHub Copilot Chat and switch to Agent mode using the dropdown
Step 04

Start using Humaans

Ask Copilot: "Using Humaans, help me...". 10 tools available

Windsurf · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "humaans": {
      "url": "https://edge.vinkius.com/vk_preview_LarqqH4EDHEPnslQdaPVgGeeelzn7f5eRT2uEUac/mcp"
    }
  }
}

Step 01

Open MCP Settings

Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
Step 02

Add the server

Paste the JSON configuration above into mcp_config.json
Step 03

Save and reload

Windsurf will detect the new server automatically
Step 04

Start using Humaans

Open Cascade and ask: "Using Humaans, help me...". 10 tools available

Cline · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "humaans": {
      "url": "https://edge.vinkius.com/vk_preview_LarqqH4EDHEPnslQdaPVgGeeelzn7f5eRT2uEUac/mcp"
    }
  }
}

Step 01

Open Cline MCP Settings

Click the Connectors icon in the Cline sidebar panel
Step 02

Add remote server

Click "Add Connector" and paste the configuration above
Step 03

Enable the server

Toggle the server switch to ON
Step 04

Start using Humaans

Ask Cline: "Using Humaans, help me...". 10 tools available

Claude Code · Terminal command

Official guide ↗

Advanced setup

claude mcp add humaans --transport http "https://edge.vinkius.com/vk_preview_LarqqH4EDHEPnslQdaPVgGeeelzn7f5eRT2uEUac/mcp"

Step 01

Install Claude Code

Run npm install -g @anthropic-ai/claude-code if not already installed
Step 02

Add the Connector

Run the command above in your terminal
Step 03

Verify the connection

Run claude mcp to list connected servers, or type /mcp inside a session
Step 04

Start using Humaans

Ask Claude: "Using Humaans, show me...". 10 tools are ready

Where the request belongs

Work Humaans can move forward.

Built around the request

This is for People Ops managers who are tired of manual data entry and HR generalists who need to answer employee questions quickly without leaving their chat app.

People Operations Manager

They use this to quickly check team capacity and manage global holiday schedules for large teams.

HR Generalist

They use this to pull employee details and department lists to help with onboarding new hires.

Team Lead

They use this to see who is on leave so they can plan project deadlines without checking calendars.

IT Administrator

They use this to verify job roles and department info when setting up new company accounts.

Build the capability set

Each Connector adds new actions and data without changing how you work.

Browse Connectors

01 8 capabilities

SmartHR

Empower your AI to manage employee records, organizational structures, and payrolls directly from your SmartHR workspace.

View Connector

02 9 capabilities

BambooHR

Human Resources management platform. organize employee data, track time off, and audit HR workflows via AI.

View Connector

03 10 capabilities

Namely

Manage HRIS data via Namely. track employee profiles, job info, and organization groups directly from your AI agent.

View Connector

04 9 capabilities

Workday

Manage workers, payroll data, org structures, and HR workflows on Workday. the enterprise HCM platform.

View Connector

05 11 capabilities

Finch

Connect Finch to automate HRIS and Payroll integration. list employees, retrieve employment data, and manage pay statements directly from your AI agent.

View Connector

06 10 capabilities

BrioHR

Orchestrate BrioHR management. retrieve employee profiles, monitor leave, and integrate claim reports directly from any AI agent.

View Connector

Bring your own AI

Change the model, client or framework. Keep Humaans connected.

Claude
ChatGPT
Gemini
Cursor
VS Code
Windsurf
ZCode
Cline
Zed
Continue
Kiro
Roo Code
Zencoder
Goose
Void
Augment Code
Amp
Qodo
Tabnine
Pieces
Sourcegraph Cody
JetBrains
Warp
Amazon Q
Antigravity
BoltAI
Raycast
Jan
LM Studio
AnythingLLM
Open WebUI
Msty
Cherry Studio
LibreChat
TypingMind
Chorus
5ire
n8n
LangChain
LlamaIndex
CrewAI
Vercel AI SDK

Before you connect

Questions about Humaans.

The practical details behind the request, access and result.

Can Humaans MCP help me check employee leave status?

Yes, it can. You can ask your agent who is currently on leave, and it will pull that information directly from your HRIS so you can see who is away without opening a dashboard.

How do I use Humaans MCP for employee lookups?

You can simply ask your agent for a specific person's details. It will retrieve their profile information from your Humaans account and show it to you in the chat.

Does Humaans MCP support global offices?

Yes, it does. You can ask your agent to list all the offices your company has, which is helpful for coordinating work across different locations.

Can I use Humaans MCP to see company departments?

Absolutely. It can pull a list of all departments in your organization, making it easy to see how your company is structured.

Is Humaans MCP good for HR teams?

It is specifically designed for people operations. It helps HR teams answer common questions about staff, leave, and org structure much faster than manual lookups.

Can Humaans MCP find public holidays?

Yes, it can pull a list of public holidays. This is great for planning deadlines and understanding regional time-off across your global team.

How do I get Humaans API credentials?

You can generate an Access Token in your Humaans user profile settings under 'API'. Ensure you have the necessary permissions to access organizational data.

Can I see salary information?

Access to sensitive fields like salary depends on the permissions of the Access Token provided. This Connector uses the standard people and organization endpoints.

Does it support leave management?

Yes, the list_leaves capability allows you to track and monitor employee leave requests.

One connection away

Give your agent a direct line to Humaans.

Connect Humaans once. Keep it beside 5,900+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available

Humaans for Solving Manual HRIS Data Entry

You get a conversational interface for your entire HRIS database.

Quick Onboarding

Capacity Planning

Org Mapping

List documents

List employees

List leaves

List roles

List teams

Get me

List departments

List offices

List public holidays

Get employee

Open Connectors

Add the URL

Turn it on in chat

Open MCP settings

Add the URL

Save and start

Open MCP Settings

Add the server config

Save the file

Start using Humaans

Create MCP config

Add the server config

Enable Agent mode

Start using Humaans

Open MCP Settings

Add the server

Save and reload

Start using Humaans

Open Cline MCP Settings

Add remote server

Enable the server

Start using Humaans

Install Claude Code

Add the Connector

Verify the connection

Start using Humaans

People Operations Manager

HR Generalist

Team Lead

IT Administrator

SmartHR

BambooHR

Namely

Workday

Finch

BrioHR

Give your agent a direct line to Humaans.