# Factorial MCP MCP > Factorial MCP connects your AI agent directly to your entire Factorial HR system. It lets you manage complex HR operations—from tracking time off and reviewing attendance logs to checking contracts and department structures—all through natural conversation. Stop hopping between tabs; get a unified view of everything related to your workforce. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** employee-directory, time-off-management, payroll-processing, performance-reviews, hr-operations, leave-tracking ## Description Managing people data shouldn't feel like running three different software programs just to get one answer. This MCP connects any AI agent to Factorial, giving you full control over HR workflows using only conversation. You can list all staff members and pull their specific profile details in seconds. Need to check if a team has enough people for the next month? Just ask about leave requests or look at attendance logs. It's like having an administrative assistant that lives inside your chat window, instantly accessing company documents and reading out who reports to whom. Everything you need—employee directories, time sheets, contract status—is accessible right where you work. Connecting this through Vinkius gives your agent access to the whole catalog of tools, so you don't have to worry about which endpoint does what. You just ask it. ## Tools ### get_employee_details Retrieves detailed profile information and specific roles for a single staff member. ### list_employee_contracts Generates a list of all active and historical employment contracts for compliance review. ### list_hr_documents Lists all general company HR documents by their metadata and unique ID. ### list_employees Provides a full directory listing with names, emails, and basic staff IDs. ### list_document_folders Navigates the company's document library by listing available HR folder structures. ### list_time_off_leaves Checks the status of employee leave requests, showing both approved and pending time off. ### list_attendance_shifts Lists all recorded clock-in and clock-out shifts to track team working hours. ### list_company_teams Shows the names and groupings of every organizational department or team set up in Factorial. ## Prompt Examples **Prompt:** ``` List all active employees in Factorial. ``` **Response:** ``` I've retrieved your employee directory. You currently have access to your active staff members, including 'Jane Doe' and 'John Smith'. Which employee would you like to view in detail? ``` **Prompt:** ``` Show me recent leave requests. ``` **Response:** ``` Running the query... I found the recent leave requests. Notable items include approved leaves for next week and pending requests for the next month. Would you like the specific dates? ``` **Prompt:** ``` List all employee contracts. ``` **Response:** ``` Fetching contracts... I've found the active employment contracts for all staff. Notable items include the recently signed agreements. Would you like me to provide specific details? ``` ## Capabilities ### Get employee records Fetch detailed profiles and basic metadata for any active staff member. ### Review time off status Check all recorded leave requests, whether they're pending approval or already approved. ### Analyze work attendance Inspect chronological shift records and clock-in/out data to see team working patterns. ### Map organizational structure See the entire company hierarchy, including all defined teams and departments. ### Audit compliance documents List and retrieve employment contracts or general HR policies for review. ## Use Cases ### A team lead needs to know if they can launch a new project. The agent checks the current staffing levels by querying list_time_off_leaves and comparing it against the total staff count found via list_employees. It confirms there are enough available people, saving hours of manual spreadsheet cross-referencing. ### HR needs to audit employee compliance status. The agent pulls a list of all active contracts using list_employee_contracts and then uses get_employee_details for any gaps. This quickly flags employees whose contract details are incomplete or overdue. ### An operations manager needs to understand reporting lines. Instead of opening the internal directory, they ask about team hierarchy. The MCP responds by listing all company teams using list_company_teams, giving a structural map instantly. ## Benefits - Never manually check employee status again. You can pull detailed profile information, like roles and departments, instantly using get_employee_details. - Audit compliance without digging through folders. The list_employee_contracts tool gives you a clear view of all staff agreements. - Stop guessing who's available. By combining list_time_off_leaves with list_attendance_shifts, you get accurate real-time staffing levels. - Get the full picture of your company structure by calling list_company_teams; you don't have to rely on old org charts. - Quickly locate policy documents. Use list_document_folders and list_hr_documents to find everything from handbooks to compliance forms. ## How It Works The bottom line is that it turns complex HR lookups into simple chat commands. 1. Subscribe to this MCP and input your Factorial API key into your agent's settings. 2. Ask your AI client a direct question, like 'Who is on leave next week?' 3. The agent uses the necessary tools to pull data from Factorial and gives you one clear answer. ## Frequently Asked Questions **How do I check a team's full structure with the Factorial MCP?** You use list_company_teams to get an instant map of your organization. This tool retrieves all defined departments and teams, allowing you to see who reports where without navigating internal settings. **What if I need to check a specific person's profile details?** Use get_employee_details. You just provide the employee ID, and it pulls all the rich data—roles, department specifics, etc.—for that individual. **Can I see who is on leave using list_time_off_leaves?** Yes, list_time_off_leaves queries the system for both approved and pending requests. This is perfect for planning resource allocation without manual checks. **Does this MCP help with finding policy documents?** You can use list_document_folders to see where all your HR documentation lives, and list_hr_documents to get a metadata listing of the files themselves. **If I use `list_attendance_shifts`, can I see if an employee has missed a clock-in or out?** Yes, you can identify discrepancies. The tool returns chronological shift records, so your agent can flag any gaps between entries or shifts that fall outside expected working hours for deeper review. **When I run `list_employee_contracts`, what specific compliance data is included?** The listing provides essential contract metadata. You'll find details like the start/end dates, contract type, and key policy references needed for quick compliance auditing. **What information do I get by calling `list_employees`?** This function gives you a roster of all active staff. It returns full names, email addresses, and unique staff IDs, which are necessary identifiers to pull specific records using other tools. **Are there rate limits when I use `list_hr_documents`?** The API adheres to standard usage protocols. If you hit a limit, your AI client will generate an error code that tells you exactly how long to wait before retrying the document query. **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.