# Humanity MCP > Humanity MCP lets your AI agent manage all workforce operations. Quickly find staff directories, build new job roles, schedule shifts, and track time clock events across multiple locations without opening the app. It’s your full HR ops desk, accessible through natural conversation. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** workforce-management, shift-scheduling, employee-tracking, team-collaboration, hr-tools ## Description You can talk to your AI client and get instant answers about your workforce. Need to know who's working at a specific site right now? You ask your agent, and it pulls up active shifts and employee details. Want to update the company structure because you opened a new remote office? Just tell your agent; it manages locations and organizational data. It handles everything from listing staff members and checking current job positions to creating entire shift schedules. When you connect this MCP through Vinkius, you get access to all these HR tools in one place. Instead of clicking through multiple tabs on the Humanity website, you simply talk to your agent and it executes the commands for you. ## Tools ### list_companies Shows you a list of all companies connected to the Humanity account. ### get_company Retrieves detailed information for one specific company by ID. ### create_location Adds a brand new physical or remote site location to the system. ### create_message Sends an internal message between users within the platform. ### create_position Sets up a new job title or role that can be assigned to employees. ### create_shift Schedules and establishes a new shift time for an employee. ### create_timeclock_event Records an employee's clock in or clock out event at a specific terminal. ### create_wall_message Posts an announcement visible on the company's internal message board. ### get_employee Pulls up a specific employee's detailed profile and records. ### list_employees Provides an overview of all employees, often with filtering options. ### list_locations Retrieves a list of every company location or remote site on file. ### get_me Shows your own current user profile and permission levels within Humanity. ### list_positions Displays all currently defined job roles or positions in the organization. ### list_shifts Generates a list of scheduled shifts for employees over time. ### terminal_clockin Registers an employee clocking into work using a physical terminal. ### list_timeclocks Lists all recorded timeclock events, allowing for review and audit. ### get_training_progress Checks how far an employee is in completing required training modules. ### get_training_sections Retrieves a list of all available training sections for staff to review or complete. ### update_weekly_availability Changes an employee's reported availability for the coming weeks. ### get_weekly_availability Fetches and reports an employee's currently set weekly working availability. ## Prompt Examples **Prompt:** ``` List all employees assigned to location 55012. ``` **Response:** ``` I've retrieved the staff list for location 55012. There are 8 employees currently assigned there, including Sarah J. (Manager) and Mike T. (Shift Lead). Would you like the contact details for any of them? ``` **Prompt:** ``` Get the details for company ID 10293. ``` **Response:** ``` Fetching company details... Company 10293 is 'Global Logistics North'. It currently has 4 active locations and 125 registered employees. Its primary timezone is set to America/New_York. ``` **Prompt:** ``` Create a new position called 'Night Supervisor' at location 8821. ``` **Response:** ``` The new position 'Night Supervisor' has been successfully created at location 8821. It is currently marked as active. You can now start assigning employees to this role. ``` ## Capabilities ### Check staff details Retrieve profiles and contact information for specific employees or list all people working at a location. ### Manage organizational structure List, get, or create company records, locations, and job positions to keep your business hierarchy accurate. ### Handle scheduling and time tracking View current shifts, list all available timeclock records, or schedule new employee shifts. ## Use Cases ### Checking Coverage for a New Site A new Operations Lead needs to know if the recently opened Dallas branch has enough staff scheduled. They ask their agent, and it immediately queries 'list_employees' and 'list_shifts' to confirm staffing levels at that specific location. ### Updating a Job Role After Reorganization The HR Manager realizes the 'Team Lead' title needs updating across three departments. They use the agent to list positions, then create a new role and assign it, preventing manual updates in multiple systems. ### Investigating Timecard Discrepancies A Team Lead notices time discrepancies and asks their agent about timeclock records. It pulls up the 'list_timeclocks' history so they can verify if an employee genuinely clocked in at the correct time. ### Onboarding a New Department The HR Administrator needs to set up a new division. They use the agent first to list companies, then create a brand new location and define all the necessary roles using 'create_position' before any employee starts. ## Benefits - Stop manually exporting employee lists. You can ask your agent to list employees, filtering instantly by location or job role, giving you the full picture without ever leaving your workspace. - Audit coverage quickly. Instead of digging through schedules, simply check active shifts and resource allocation for any given day. Need to know who's working? Just ask about 'list_shifts'. - Stay organized with company growth. Use the agent to manage locations or create new job positions when you open a remote site or hire a specialist. It handles the structure, so you don't have to. - Streamline time tracking. You can log an employee clock in using 'terminal_clockin', view all past records with 'list_timeclocks', and manage shifts without logging into the dedicated hardware terminal. - Keep communication flowing smoothly. Send internal messages or post company-wide announcements instantly, whether you use 'create_message' or 'create_wall_message'. ## How It Works The bottom line is you tell your AI agent what to do using plain English, and this MCP translates that into specific actions in Humanity. 1. Subscribe to this MCP on Vinkius and provide your Humanity Access Token. 2. Connect your agent by selecting the Humanity MCP within any compatible client. 3. Ask your agent a question like, 'Who is working at our Chicago office today?' and it runs the necessary commands. ## Frequently Asked Questions **How do I check if an employee is assigned to a location using Humanity MCP?** You ask your agent to list employees. It pulls up all staff records, allowing you to filter and confirm who works at any specific site. **Can Humanity MCP create new shifts for my team?** Yes, the agent handles this by running the 'create_shift' command, scheduling a defined time period for your employees automatically. **What if I need to update an employee’s role? Does Humanity MCP support that?** The MCP lets you manage roles. You can use the agent to list positions and create new job roles when a department changes or expands. **Does humanity MCP help with time clock data?** Yes, it handles this by letting you list all recorded timeclock events and even record an employee's arrival using 'terminal_clockin'.