# Factorial MCP for AI Agents AI Agent Connect > Factorial MCP lets you manage your entire HR department through an AI agent. You can pull employee lists, track team leave, audit shift schedules, and access company documents without switching tabs. It connects your Factorial account directly to your AI client so you can handle personnel tasks, check payslips, and manage organizational data using natural language commands. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_0jicYRQCsa0zo9eB6ojNVJFnsSR0lRawLwvtI74R/ai-agent-connect - **Tags:** employee-directory, time-off-management, payroll-processing, performance-reviews, hr-operations, leave-tracking ## Description Factorial HR is usually where the data lives, but getting to that data often feels like a chore. You have to log in, find the right department, and scroll through lists just to find one person's contact info or see if someone is on vacation. This Connector changes that by letting you just ask your AI agent. You can pull up employee lists, check shift schedules, or find specific company documents without ever leaving your chat interface. It turns your HR platform into a conversational tool. Vinkius makes it easy to connect this to your favorite AI client so you can handle the boring stuff like auditing payslips or checking team availability in seconds. It's about getting the info you need immediately so you can get back to actual work. ## Tools ### list_hr_documents Includes document metadata and identification IDs. List all company HR documents ### list_document_folders Use this to navigate the document library. List HR document folders ### list_time_off_leaves Useful for monitoring attendance and staff availability. List employee leave requests ### list_attendance_shifts Essential for tracking employee working hours and productivity patterns. List all attendance shifts ### list_company_teams Useful for understanding the organizational hierarchy. List all organizational teams ### get_employee_details Essential for reviewing detailed profile information and roles. Get details for a specific employee ### list_employee_contracts Essential for auditing and compliance reviews. List all employment contracts ### list_employees This tool lists all Factorial employees. It lets you see every person in your organization in one go. ## Prompt Examples **Prompt:** ``` Who is out of the office this month? ``` **Response:** ``` Checking the leave requests for this month... Here are the approved leaves for October: | Name | Dates | Status | | :--- | :--- | :--- | | **Jane Doe** | Oct 1 - Oct 5 | Approved | | **Robert Brown** | Oct 12 - Oct 15 | Approved | | **Sarah Connor** | Oct 20 - Oct 25 | Approved | Your team availability is currently at 85% for this month. ``` **Prompt:** ``` Find the remote work policy for me. ``` **Response:** ``` I've searched the company folders and found the following document: 📄 **2024_Remote_Work_Policy.pdf** Would you like me to summarize the key points of the remote work policy for you, or do you need the direct link to the folder? ``` **Prompt:** ``` List the engineering team members. ``` **Response:** ``` Retrieving members for the Engineering team... I found 12 employees in this department: * **John Smith** (Lead) * **Jane Doe** (Senior Dev) * **Alice Wong** (Dev) * **Mike Ross** (Junior Dev) * *...and 8 others* Would you like to see the contact details or manager relationships for any of these individuals? ``` ## Capabilities ### Pull employee profiles Get detailed info on any team member instantly. ### Track team leave See who's on holiday or taking time off for any year. ### Audit shift schedules Check rotation and coverage for specific months. ### Access payslips Verify compensation records and financial data for the team. ### Search company docs Find internal HR policies and folders using natural language. ### Verify company metadata Check workspace settings and organizational identities. ### Resolve personnel context Get manager relationships and hiring dates on the fly. ## Use Cases ### Finding a remote work policy An HR admin needs to find the remote work handbook. They ask the agent to find the file in the company folders, and it uses list_documents to find and summarize it. ### Checking June availability A team lead needs to see who is out of the office. They ask the agent to check leave requests for June, and it uses list_leaves to provide a summary. ### Auditing payroll records A finance clerk needs to verify if payslips were issued in March. The agent uses list_payslips to confirm the records for that specific month. ### Mapping out a new department A new manager wants to see the team structure. The agent uses list_teams and list_employees to map out the department members and roles. ## Benefits - Stop manual tab-switching by using list_employees to see your entire directory in one chat. - Plan projects faster by checking team availability with list_leaves for any year. - Audit payroll records quickly using list_payslips to verify specific months of compensation. - Find company policies instantly with list_documents instead of digging through folders. - Track shift coverage accurately using list_shifts to see rotations for specific months. - Get instant personnel context by using get_employee to see manager links and hiring dates. ## How It Works The bottom line is you get a conversational interface for your entire HR database. 1. Subscribe to the Factorial MCP on Vinkius. 2. Paste your Factorial API key from the advanced configuration settings. 3. Ask your AI client to list employees, check leaves, or find documents. ## Frequently Asked Questions **Can I use Factorial MCP to see who's on vacation?** Yes, you can ask your agent to list all leave requests for any specific year. It will provide a clear summary of who is away and when, helping you plan projects without opening the HR dashboard. **Does Factorial MCP work with Cursor?** Yes, this Connector works with any compatible client, including Cursor, Claude, and Windsurf. Once connected, your agent can access your Factorial data directly. **Can I find company documents using Factorial MCP?** Absolutely. You can ask your agent to find specific HR policies, employee handbooks, or other internal files. It will search your company folders and list the relevant documents for you. **How do I check payslips with Factorial MCP?** You can ask your agent to list payslips for a specific month and year. It will retrieve the available records so you can verify compensation data quickly through a chat interface. **Can I manage shifts with Factorial MCP?** Yes, the Connector allows you to list shifts for any given month. This makes it easy to audit team rotations, check coverage, and see who is scheduled to work at any time. **Is Factorial MCP good for HR managers?** It's a huge time saver for HR managers. It eliminates the need to manually search for employee profiles, leave dates, and company documents, letting you handle these requests in seconds via natural conversation. **Can my agent list all leave requests for the current year in Factorial?** Yes. Use the 'list_leaves' tool. You can specify the 'year' parameter, and the agent will fetch all absence and holiday requests, allowing you to track team availability flawlessly. **How do I check the shift schedule for a specific month via chat?** Use the 'list_shifts' tool. Provide the 'year' and 'month' (numeric). The agent will retrieve the detailed scheduling information, providing you with a clear view of operational coverage. **Can I audit payslip availability through the agent?** Absolutely. Use the 'list_payslips' tool for a target year and month. Your agent will verify which employees have available compensation records without you needing to manually navigate the payroll section. **Can my AI automatically find the details of a specific employee just by providing their ID?** Yes! Use the `get_employee` tool with the unique ID. Your agent will respond with complete metadata, contact information, and role details in seconds. **How do I monitor team leaves and availability?** Simply ask the agent to run the `list_leaves` tool. It will compile a list of all requested and approved absences, allowing you to see who is out of the office. **Does the integration permit modifying employee data?** No. The core set of tools focuses strictly on querying and analyzing HR context—listing employees, leaves, and attendance. State alteration operations are not currently exposed, ensuring your records remain secure.