# Freshteam MCP > Freshteam MCP lets you manage complex HR operations and recruitment workflows directly through your AI client. You can instantly access employee directories, track job applicants for specific roles, monitor time-off requests, and even create new records—all from a natural conversation. This connector gives your agent the power to handle everything from onboarding tasks to organizational lookups without ever leaving your primary workspace. ## Overview - **Category:** human-resources - **Price:** Free - **Tags:** applicant-tracking, employee-management, onboarding, time-off-management, hr-automation ## Description Connecting Freshteam through this MCP lets you automate core HR functions using only your voice or text prompts. Instead of jumping between dashboards, your AI client talks directly to your employee and applicant data. Need a list of all employees in the Marketing department? Ask for it. Want to know Jane Doe's time-off balance next month? Get that too. It handles everything from managing active job postings to pulling detailed candidate profiles. This makes sure you have real-time, accurate HR insights without any manual searching. When you subscribe via Vinkius, your AI client gets access to this full suite of tools, meaning whether you're a recruiter checking pipelines or an HR manager auditing records, the data is always right where you need it. ## Tools ### create_employee_record Adds a new record for an employee into the HR system. ### check_hris_status Verifies that the connection to the HR information system is working correctly. ### get_applicant_details Retrieves a candidate's full profile and application history. ### get_employee_details Pulls comprehensive metadata for any existing employee record. ### get_job_posting_details Gets specific details about an active job opening. ### list_job_applicants Generates a list of all candidates who applied for a given role. ### list_office_branches Provides a list of all physical office locations managed by the company. ### list_departments Returns a structured list of HR departments within the organization. ### list_employees Lists all active employee records in the system. ### list_job_postings Returns a list of all currently open job vacancies. ### list_job_roles Provides a list of defined job titles and roles used across the company. ### list_time_off_requests Lists pending or past employee leave requests and time-off balances. ## Prompt Examples **Prompt:** ``` List all active job postings in Freshteam. ``` **Response:** ``` Retrieving jobs... I found 3 active job postings, including 'Senior Software Engineer' and 'Marketing Manager'. Would you like to see the applicants for any of these? ``` **Prompt:** ``` Show me the HR profile for employee 'Jane Smith'. ``` **Response:** ``` Searching employees... I found Jane Smith (jane.smith@example.com). She is a 'Product Manager' in the 'Product' department and is currently 'Active'. ``` **Prompt:** ``` Create a new employee record for 'John Doe' (johndoe@email.com). ``` **Response:** ``` Employee created! I have successfully added 'John Doe' (johndoe@email.com) to your HR directory. The new Employee ID is 98765. ``` ## Capabilities ### Retrieve employee and company directory data Get detailed profiles for any employee, list all current staff members, and understand the full organizational structure by listing departments or office branches. ### Manage recruitment pipelines View active job openings, list candidates applied to a specific role, and pull comprehensive details on any applicant's profile. ### Handle time-off requests and leave balances Check employee time-off requests and monitor available leave balances to ensure proper staffing levels across teams. ### Onboard new staff members Create brand new records for employees directly within the HR system, streamlining the hiring process from application to entry. ## Use Cases ### A Department Head needs headcount visibility. The head asks, 'How many people are in Product and how much PTO is left for next month?' The agent runs `list_departments` to verify the department exists, then uses `list_employees` combined with `list_time_off_requests` to give a single, comprehensive answer. ### A Recruiter needs to update candidate status. The recruiter asks, 'What are the details for Sarah Connor?' The agent uses `get_applicant_details` and then can use `list_job_postings` to cross-reference her profile against current openings. ### HR needs to add a new hire record. Instead of filling out forms, the HR manager says, 'Create a record for John Smith.' The agent uses `create_employee_record`, ensuring all mandatory fields are populated correctly and instantly adding him to the directory. ### Someone needs to verify system connectivity. A new employee asks if the HRIS is working. They ask, 'Can you check the status?' The agent runs `check_hris_status` and immediately confirms API connection health for peace of mind. ## Benefits - Instant Staff Lookup: Instead of clicking through departmental menus to find Jane Doe's file, you simply ask your agent for 'employee details,' getting the full record immediately using `get_employee_details`. - Accelerated Hiring: You can list all job postings and then instantly run a report on applicants for any specific role by calling `list_job_applicants`, drastically cutting down manual data gathering time. - Clear Time-Off Visibility: Quickly check team availability. Just ask your agent to review pending leave requests using `list_time_off_requests` before approving PTO, eliminating scheduling headaches. - Building the Directory: Need to add a new hire? Use the `create_employee_record` tool to onboard staff directly through conversation, bypassing manual form submissions entirely. - Understanding Structure: You can map out who reports to whom or what departments exist by running simple queries like `list_departments`, giving you an instant view of your company's hierarchy. ## How It Works The bottom line is, your AI client translates simple commands into complex HR queries and returns structured data immediately. 1. Subscribe to this MCP on Vinkius and input your Freshteam Domain prefix and API Key. 2. Connect your preferred AI client (like Cursor or Claude) using the credentials you provided. 3. Directly ask your agent natural language questions, such as 'List all employees in Department X' or 'Get details for applicant Y'. ## Frequently Asked Questions **How do I check an employee’s profile using Freshteam MCP?** You use the `get_employee_details` tool by asking for the specific person's name or ID. This provides their full HR record, including job title and department. **What is the best way to track applicants with Freshteam MCP?** Run `list_job_postings` first to identify the role, then use `list_job_applicants` to get a list of candidates who applied for that specific opening. **Can I add a new employee record using Freshteam MCP?** Yes. Use the `create_employee_record` tool by giving your agent the necessary details, which instantly populates the HR system with the new hire's data. **Does Freshteam MCP help with department structure?** Absolutely. You can use `list_departments` and `list_office_branches` to map out exactly how your organization is structured across different physical locations. **How does the time-off management tool work in Freshteam MCP?** The agent uses `list_time_off_requests` to show both current leave requests and the remaining paid time off balances for any specified employee or team.