Humanity Connector for AI agents.

20 live capabilities

Manage workforce scheduling and employee shifts through a conversational interface.

Live agent request Humanity / Connector

Waiting for input…

AI Agent

Why people use Humanity

Humanity for Workforce Scheduling and HR Management

This Connector changes that by bringing your Humanity data directly into your chat. You can ask your agent to list all employees at a specific site or check shift availability in seconds. You get a unified view of your workforce without the manual data entry.

What Vinkius changes

You get a conversational way to manage your entire workforce without leaving your chat interface.

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

One account · 5,900+ Connectors

Real-world use case 01

Verifying staff for a specific site

An HR manager needs to see who is assigned to a specific location.
Real-world use case 02

Monitoring nightly shift coverage

An operations lead wants to ensure the night shift is full.
Real-world use case 03

Adding new roles to the hierarchy

A manager needs to open a new position.

Complete set · 20capabilities

The complete Humanity capability set.

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

Capability set01 / 05

01—04

4 capabilities in this set.

Part of 20 available through Humanity.

01 Capability
Get employee
Fetch the profile for a specific staff member. Use this to see details about any team member.
02 Capability
List employees
See a list of all employees in your organization. This provides a quick overview of your staff.
03 Capability
List locations
View all companies, locations, and remote sites. This helps you see your entire business footprint.
04 Capability
List positions
View all job positions and roles. This shows the full hierarchy of your organization.

Capability set02 / 05

05—08

4 capabilities in this set.

Part of 20 available through Humanity.

05 Capability
List shifts
See all scheduled shifts. Use this to monitor coverage across different locations.
06 Capability
Terminal clockin
Clock in an employee using a terminal. This helps automate the attendance process.
07 Capability
List timeclocks
View all timeclock records. This provides a history of when people started and ended work.
08 Capability
Get training progress
Check the progress of employee training. Use this to see who is still in onboarding.

Capability set03 / 05

09—12

4 capabilities in this set.

Part of 20 available through Humanity.

09 Capability
Get training sections
View the different sections of a training program. This helps you see what training is available.
10 Capability
Get weekly availability
Check when an employee is available to work. Use this to plan upcoming shifts.
11 Capability
Create location
Create a new physical or remote location in your organization. This helps you organize different sites in one place.
12 Capability
Create message
Send a direct message to an employee. This allows for quick one-on-one communication.

Capability set04 / 05

13—16

4 capabilities in this set.

Part of 20 available through Humanity.

13 Capability
Create shift
Add a new shift to the schedule. Use this to manage daily staffing needs.
14 Capability
Update weekly availability
Change the weekly availability for an employee. This keeps your scheduling data accurate.
15 Capability
Create position
Set up a new job role or position. This helps you define the structure of your team.
16 Capability
Create timeclock event
Add a specific event to a timeclock record. This is useful for tracking specific activities.

Capability set05 / 05

17—20

4 capabilities in this set.

Part of 20 available through Humanity.

17 Capability
Create wall message
Post a message to the company wall. This helps you broadcast updates to the whole team.
18 Capability
Get me
Retrieve the details and permissions of the current user. Use this to check your own access levels.
19 Capability
List companies
See a list of all companies in your account. This helps manage multi-company accounts.
20 Capability
Get company
Get details for a specific company. Use this to see high-level company information.

Set up in minutes

One URL. Then ask Humanity to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Humanity 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_paTcXvKFV1MI2BcYi4ogH3YhzBUa0LrUGTgw4RjJ/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 Humanity, and paste the URL above.
Step 03

Turn it on in chat

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

ChatGPT · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_paTcXvKFV1MI2BcYi4ogH3YhzBUa0LrUGTgw4RjJ/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 Humanity URL.
Step 03

Save and start

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

Cursor · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "humanity": {
      "url": "https://edge.vinkius.com/vk_preview_paTcXvKFV1MI2BcYi4ogH3YhzBUa0LrUGTgw4RjJ/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 Humanity

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

VS Code Copilot · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "humanity": {
      "url": "https://edge.vinkius.com/vk_preview_paTcXvKFV1MI2BcYi4ogH3YhzBUa0LrUGTgw4RjJ/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 Humanity

Ask Copilot: "Using Humanity, help me...". 20 tools available

Windsurf · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "humanity": {
      "url": "https://edge.vinkius.com/vk_preview_paTcXvKFV1MI2BcYi4ogH3YhzBUa0LrUGTgw4RjJ/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 Humanity

Open Cascade and ask: "Using Humanity, help me...". 20 tools available

Cline · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "humanity": {
      "url": "https://edge.vinkius.com/vk_preview_paTcXvKFV1MI2BcYi4ogH3YhzBUa0LrUGTgw4RjJ/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 Humanity

Ask Cline: "Using Humanity, help me...". 20 tools available

Claude Code · Terminal command

Official guide ↗

Advanced setup

claude mcp add humanity --transport http "https://edge.vinkius.com/vk_preview_paTcXvKFV1MI2BcYi4ogH3YhzBUa0LrUGTgw4RjJ/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 Humanity

Ask Claude: "Using Humanity, show me...". 20 tools are ready

Where the request belongs

Work Humanity can move forward.

Built around the request

This is for HR managers who are tired of manual data entry and operations leads who need to see shift coverage in real-time without clicking through five different screens.

01

HR Manager

Audits employee lists and organizational structures during hiring cycles to ensure data accuracy.

02

Operations Lead

Monitors shift coverage and location data to ensure every site is properly staffed.

03

Team Lead

Verifies staff assignments and updates weekly availability for their direct reports on a daily basis.

Build the capability set

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

Browse Connectors

01 8 capabilities

Personio

Orchestrate HR logistics via Personio. manage workforce lists, track specific absences, log attendances securely, and evaluate custom attributes structurally via AI.

02 10 capabilities

Deputy

Equip your AI agent to manage employee rosters, track timesheets, and monitor leave requests via the Deputy API.

03 9 capabilities

BambooHR

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

04 10 capabilities

Beisen (iTalentX)

Comprehensive HR cloud platform. manage employees, attendance, and recruitment via AI.

05 12 capabilities

Freshteam

Manage HR operations, track job applicants, and oversee employee records via AI agents with Freshteam.

06 11 capabilities

HiBob

Automate HR workflows via HiBob. manage employees, time off, and tasks directly from any AI agent.

Bring your own AI

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

Before you connect

Questions about Humanity.

The practical details behind the request, access and result.

Can I use the Humanity MCP to see my employee list?

Yes, you can ask your agent to pull up your full employee directory instantly. It makes it easy to find specific staff members without opening the Humanity dashboard.

How does this help with shift scheduling?

You can query active shifts and check coverage for specific locations. This helps you see who is working in real-time and identify any staffing gaps.

Can I manage company locations with this?

Yes, you can use your agent to list existing companies and locations or create new remote sites. It keeps your business hierarchy organized and up to date.

Can I use this to send messages to my team?

You can send messages to the company wall or direct messages to employees. It is a fast way to broadcast updates or reach out to specific staff.

Does this help with training?

Yes, you can check the progress of employee training and view the different sections of your training programs. This helps you keep track of onboarding.

Can I update employee availability?

You can get and update weekly availability through your agent. This ensures your team's schedules are always based on the most current information.

Can I filter the employee list by a specific location ID?

Yes! Use the list_employees capability and provide the location parameter with the target ID. The agent will return only the staff members assigned to that specific site.

Is it possible to create a new work location through the AI?

Certainly. You can use the create_location action. You'll need to provide a name and type (1 for Location, 2 for Remote Site), and optionally include address and timezone details.

How do I check the details of my own Humanity account?

Simply ask the agent to run the get_me capability. It will retrieve your current user details, including your profile information and account status.

One connection away

Give your agent a direct line to Humanity.

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

Explore every Connector No credit card required · Free tier available