# Freshteam MCP for AI Agents AI Agent Connect > Freshteam. This Connector lets you manage your entire HR lifecycle from tracking job applicants and managing employee records to overseeing time-off requests directly through your AI client. It connects your Freshworks HR software to your workspace so you can handle people operations without switching tabs. ## Overview - **Category:** human-resources - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_lNHtSaXMT5SaqCzoAz5L9PyKnb06EFHSHZaSIjrZ/ai-agent-connect - **Tags:** applicant-tracking, employee-management, onboarding, time-off-management, hr-automation ## Description This Freshteam MCP connects your HR software to your AI client so you can manage people operations without leaving your current workspace. Managing a workforce usually means jumping between different tabs to find a single employee's profile, checking if a candidate's application hit the right folder, or looking up a department's current head. This connection changes that by letting your agent pull that data into your current conversation. You can ask about a specific hire, see who's out of the office today, or grab a list of open roles without ever touching the dashboard. It's a way to keep your HR operations moving while you stay focused on the actual work. You'll find this in the Vinkius marketplace, where it sits alongside hundreds of other tools to help you get things done. Instead of manually digging through folders, you just tell your agent what you need to know about your team or your hiring pipeline and get the answer immediately. You can also track your recruitment efforts by asking about active postings or looking into the details of specific applicants. This means you spend less time on data entry and more time making decisions about your team's growth and structure. ## Tools ### check_hris_status Verify your API connection is active. This ensures your agent can talk to your HR data without errors. ### list_time_off_requests List all leave requests. This helps you monitor who's away and manage workforce coverage. ### create_employee_record Create a new employee record. Use this to add a new hire to your directory through a simple command. ### get_job_posting_details Get specific information about a job. Use this to see the details of a particular opening. ### list_job_applicants List all candidates for a role. This helps you see the entire hiring pipeline for a specific position. ### list_office_branches List all office locations. Use this to see where your teams are physically located. ### list_departments List all HR departments. This gives you a quick look at your company's internal structure. ### list_employees List all employees in your directory. Use this to get a high-level view of your entire workforce. ### list_job_postings List all active job openings. This lets you see every role you're currently hiring for. ### list_job_roles List all job roles. Use this to see the variety of positions available in your company. ### get_applicant_details Pull a specific candidate's profile. Use this to see a person's history and status quickly. ### get_employee_details Get metadata for a specific employee. This helps you find details on a staff member's role or status. ## Prompt Examples **Prompt:** ``` Show me all the active job openings we have right now. ``` **Response:** ``` ### Active Job Openings I've pulled the current listings from Freshteam: | Job Title | Department | Status | | :--- | :--- | :--- | | **Senior Software Engineer** | Engineering | Active | | **Marketing Manager** | Marketing | Active | | **Product Designer** | Product | Active | Would you like to see the applicant list for any of these? ``` **Prompt:** ``` Who is currently out of the office on leave? ``` **Response:** ``` ### Current Time-Off Requests Here are the employees currently on leave: * **Jane Smith** (Returning Monday) * **John Doe** (Returning Wednesday) * **Alice Wong** (Returning Friday) I can give you more details on their specific leave balances if needed. ``` **Prompt:** ``` Create a new employee record for Sarah Jenkins with email sarah@company.com. ``` **Response:** ``` ### Record Created I've successfully added the new hire to your directory: * **Name:** Sarah Jenkins * **Email:** sarah@company.com * **Status:** Active * **New Employee ID:** 88291 Is there anything else you'd like me to do for her profile? ``` ## Capabilities ### Verify the HRIS connection status Confirm your AI client is properly linked to your HR data. ### Pull detailed candidate profiles Get a full look at a specific applicant's history and status. ### Retrieve specific employee metadata Get the details on a staff member's role, status, and info. ### List all current job postings See every active role you're currently hiring for in one view. ### View all applicants for a role Check the full hiring pipeline for any specific position. ### View all leave requests Monitor who's away and manage your team's coverage easily. ### Create a new employee record Add a new hire to your HR directory using a simple command. ## Use Cases ### Checking coverage for a busy week An HR manager asks the agent who is on leave next week and uses list_time_off_requests to see the schedule without opening a spreadsheet. ### Reviewing a high-priority candidate A recruiter asks for the profile of a specific applicant and uses get_applicant_details to see their history and status instantly. ### Onboarding a new hire An admin tells the agent to add a new person to the team and uses create_employee_record to update the directory in one step. ### Mapping out a new department A head of operations asks for a list of all current roles and uses list_job_roles to see what's already in place before planning. ## Benefits - Stop switching tabs to check leave balances. Use list_time_off_requests to see who's out and manage coverage in one go. - Speed up hiring by pulling candidate data. Use get_applicant_details to review profiles without leaving your chat. - Keep your employee directory updated easily. You can use create_employee_record to add new hires instantly. - Get a clear view of your company structure. Use list_departments and list_job_roles to see how the organization is built. - Monitor your hiring pipeline in real time. Use list_job_applicants to see who's in the queue for specific roles. - Verify your HR data is always reachable. Use check_hris_status to make sure your connection stays active and reliable. ## How It Works The bottom line is you get a conversational interface for your entire HR and recruitment database. 1. Subscribe to the Freshteam MCP through the Vinkius Marketplace. 2. Enter your Freshteam Domain prefix and API Key from your Profile Settings. 3. Ask your AI client to list employees, check job postings, or pull candidate details. ## Frequently Asked Questions **Can I use Freshteam MCP to see who's on vacation?** Yes, you can ask your agent to list leave requests, which pulls data from Freshteam to show you who's away and helps you manage team coverage. **How does Freshteam MCP help with hiring?** It lets your agent see all active job postings and the list of applicants for each role in one place, making it easier to track your recruitment pipeline. **Can I add new employees using this?** Yes, you can tell your agent to create a new employee record and it will add them to your Freshteam directory automatically. **Does Freshteam MCP work with my current AI client?** It works with any MCP-compatible client like Claude, Cursor, or Windsurf once you connect it via the Vinkius marketplace. **Is my HR data safe with this?** The Connector only accesses the data your agent needs to answer your questions based on the permissions in your Freshteam API key. **How do I get an API Key for Freshteam?** Log in to your Freshteam account, click on your Profile Icon in the top right corner, select 'API Settings', and copy 'Your API Key'. **What is my 'Domain prefix'?** Your domain prefix is the first part of your Freshteam URL (e.g. if your URL is 'acme.freshteam.com', the prefix is 'acme'). **Can I see all applicants for a specific job?** Yes! First use the 'list_job_postings' tool to get the Job ID, then use 'list_job_applicants' with that ID to see everyone who applied. **Is it possible to add a new employee via the agent?** Yes, use the 'create_employee_record' tool. Provide the first name, last name, and official email to instantly add them to your HRIS directory.