# Humanity MCP for AI Agents AI Agent Connect > Humanity MCP for AI Agents. Manage workforce scheduling, employee shifts, and team communication via Humanity. List employees, manage locations, and track shifts directly from any AI agent. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_paTcXvKFV1MI2BcYi4ogH3YhzBUa0LrUGTgw4RjJ/ai-agent-connect - **Tags:** workforce-management, shift-scheduling, employee-tracking, team-collaboration, hr-tools ## Description Connect your Humanity account to your AI agent to handle workforce management and scheduling without jumping between tabs. Instead of digging through dashboards to find who is working where, you can just ask your agent to pull up staff lists or check shift coverage. This Connector lets you manage the entire organizational structure, from high-level company locations to specific job positions, through a simple conversation. You can handle day-to-day tasks like sending wall messages to the team or updating weekly availability for specific staff members. It takes the manual work out of HR and operations, making it easier to keep your business hierarchy accurate and your team's schedule updated. You can also manage timeclock events and track training progress as part of your regular workflow. Vinkius makes it easy to connect this to your existing setup so you can get these tasks done faster. This means you spend less time on data entry and more time actually leading your team. You can see who is on the clock, who needs training, and where your staff is located with just a few prompts. It turns a complex management platform into a conversational tool that fits into your existing habits. ## Tools ### get_employee Fetch the profile for a specific staff member. Use this to see details about any team member. ### list_employees See a list of all employees in your organization. This provides a quick overview of your staff. ### list_locations View all companies, locations, and remote sites. This helps you see your entire business footprint. ### list_positions View all job positions and roles. This shows the full hierarchy of your organization. ### list_shifts See all scheduled shifts. Use this to monitor coverage across different locations. ### terminal_clockin Clock in an employee using a terminal. This helps automate the attendance process. ### list_timeclocks View all timeclock records. This provides a history of when people started and ended work. ### get_training_progress Check the progress of employee training. Use this to see who is still in onboarding. ### get_training_sections View the different sections of a training program. This helps you see what training is available. ### get_weekly_availability Check when an employee is available to work. Use this to plan upcoming shifts. ### create_location Create a new physical or remote location in your organization. This helps you organize different sites in one place. ### create_message Send a direct message to an employee. This allows for quick one-on-one communication. ### create_shift Add a new shift to the schedule. Use this to manage daily staffing needs. ### update_weekly_availability Change the weekly availability for an employee. This keeps your scheduling data accurate. ### create_position Set up a new job role or position. This helps you define the structure of your team. ### create_timeclock_event Add a specific event to a timeclock record. This is useful for tracking specific activities. ### create_wall_message Post a message to the company wall. This helps you broadcast updates to the whole team. ### get_me Retrieve the details and permissions of the current user. Use this to check your own access levels. ### list_companies See a list of all companies in your account. This helps manage multi-company accounts. ### get_company Get details for a specific company. Use this to see high-level company information. ## Prompt Examples **Prompt:** ``` Who is currently scheduled to work at the downtown location? ``` **Response:** ``` I've checked the schedule for the downtown location. Here are the shifts for tonight: | Name | Role | Shift Time | | :--- | :--- | :--- | | **Sarah J.** | Manager | 6pm - 10pm | | **Mike T.** | Lead | 6pm - 10pm | Would you like me to list more? ``` **Prompt:** ``` Can you create a new job position called 'Night Supervisor' for location 8821? ``` **Response:** ``` I've created the **Night Supervisor** position for location 8821. It is now active in your system and ready for you to assign staff to. ``` **Prompt:** ``` What is the training progress for the new hires? ``` **Response:** ``` Here is the current training status for the new team members: | Employee | Progress | Status | | :--- | :--- | :--- | | Jane D. | 80% | In Progress | | Tom W. | 100% | Completed | Let me know if you want to see the specific sections. ``` ## Capabilities ### Pull employee profiles Get detailed information on any staff member in your organization instantly. ### Check shift coverage See who is currently working and what their schedules look like across all sites. ### Manage business locations Add or list different physical and remote locations in your business hierarchy. ### Create job positions Set up new roles and titles within your organization to define your team structure. ### Send team messages Post updates to the company wall or send direct messages to specific employees. ### Track timeclock events Log and view timeclock records to maintain accurate attendance and activity logs. ## Use Cases ### Verifying staff for a specific site An HR manager needs to see who is assigned to a specific location. They ask their agent to list employees for that site using list_employees. ### Monitoring nightly shift coverage An operations lead wants to ensure the night shift is full. They ask their agent to check active shifts with list_shifts. ### Adding new roles to the hierarchy A manager needs to open a new position. They ask the agent to create a new job role using create_position. ### Checking employee work windows A team lead needs to know when a worker can take a shift. They ask the agent to check weekly availability with get_weekly_availability. ## Benefits - Faster staff lookups: Use list_employees to quickly find specific people without manual filtering. - Real-time shift oversight: Use list_shifts to see coverage gaps instantly as they happen. - Easier location management: Use create_location to add new sites to your business hierarchy without navigating complex menus. - Accurate time tracking: Use list_timeclocks to monitor attendance and clock-in events for precise reporting. - Quick communication: Use create_wall_message to broadcast updates to your whole team in one step. - Simplified training tracking: Use get_training_progress to see who needs more onboarding at a glance. ## How It Works The bottom line is you get a conversational way to manage your entire workforce without leaving your chat interface. 1. Subscribe to this Connector and provide your Humanity Access Token. 2. Connect your preferred AI client to the Vinkius platform. 3. Ask your agent to perform tasks like listing employees or creating new shifts. ## Frequently Asked Questions **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` tool 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` tool. It will retrieve your current user details, including your profile information and account status.