# ChartHop MCP for AI Agents AI Agent Connect > ChartHop MCP lets you manage your entire workforce and headcount planning directly through your AI agent. It connects your organizational data—like team structures, job roles, and employee profiles—so you can ask questions about your roster, audit department hierarchies, and review compensation scenarios without switching tabs. ## Overview - **Category:** human-resources - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_2dqzMHinCTOzo1cjVBUGuoBdleYtNBRU5P0xlEke/ai-agent-connect - **Tags:** people-operations, headcount-planning, organizational-data, workforce-management, hr-analytics, roster-management ## Description Connect your ChartHop account to any AI agent to take control of your organizational data and workforce planning. You can manage your roster and headcount without leaving your chat interface. This Connector lets you pull up specific person profiles, check job history, and see how new hiring scenarios affect your budget. It turns your data into a conversational resource. Because it's part of the Vinkius catalog, you can get this up and running in minutes alongside your other tools. You stop hunting for information and start making decisions based on it. ## Tools ### get_organization_summary Get a high-level overview of your organization's core information and settings. This helps you verify your total headcount and basic account configuration quickly. ### list_organization_departments See a full list of all departments within your organization. This is useful for mapping out your company's high-level structure. ### list_organization_jobs View every job role currently listed in your company. Use this to see the full breadth of positions available in your roster. ### get_job_details Pull specific details for any job role in your company. Use this to see the exact requirements and status of a single position. ### get_person_details Retrieve a full profile for a specific person. It includes job history and compensation metadata for a complete view of an employee's path. ### list_organization_people Get a list of all employees currently in your organization. This gives you a quick way to see everyone on the team in one place. ### list_planning_scenarios View your current headcount and compensation planning scenarios. This lets you compare different hiring plans and budget projections. ### list_organization_teams See a complete list of all teams within your organization. Use this to understand how your departments are broken down into smaller units. ## Prompt Examples **Prompt:** ``` What's our current headcount summary? ``` **Response:** ``` Here is the summary for your organization: - **Total Filled Roles**: 150 - **Open Positions**: 12 - **Largest Department**: Engineering (65 people) - **Status**: On track with current hiring goals. ``` **Prompt:** ``` List all the departments for me. ``` **Response:** ``` I've pulled the current department list for you: - Engineering - Sales - Marketing - Product - HR ``` **Prompt:** ``` Give me the details for John Smith. ``` **Response:** ``` I found John Smith in the system: - **Role**: Senior Software Engineer - **Department**: Engineering - **Reporting to**: Jane Smith - **Start Date**: 2022-05-10 ``` ## Capabilities ### Pull up organization summaries Get a high-level overview of your organization's core information and settings in one go. ### Fetch specific job details Get the exact requirements and status for any specific job role in your company. ### Retrieve individual person profiles Pull up complete employee records including job history and compensation metadata. ### List all departments in the company See a full list of all departments to understand your high-level organizational structure. ### View all current jobs and roles Get a full list of every job role currently tracked in your company roster. ### See headcount and compensation scenarios Review different hiring plans and budget projections from your planning scenarios. ### List all teams within the org See how your departments are broken down into smaller teams and units. ## Use Cases ### Headcount Planning A manager asks for a summary of open roles and current headcount to see if they have the budget for a new hire. ### Team Audits An HRBP needs to list all departments and their teams to ensure the organizational structure is up to date. ### Onboarding Prep A new lead asks for the details of a specific job to understand the requirements before they start hiring. ### Executive Reporting A CEO asks for a summary of the organization's core settings and total headcount for a board meeting. ## Benefits - Stop manual data hunting by using `list_organization_people` to see your entire roster in seconds. - Plan budgets faster by checking various scenarios with `list_planning_scenarios` without leaving your chat. - Get instant team context by using `list_organization_departments` and `list_organization_teams` to map your hierarchy. - Access deep employee history with `get_person_details` to see job changes and compensation metadata. - Speed up hiring with `get_job_details` to see exactly what's open and what's needed. - Keep an eye on the big picture using `get_organization_summary` to verify total headcount and core settings. ## How It Works The bottom line is you get instant access to your HR data through a simple chat interface. 1. Subscribe to the ChartHop MCP on Vinkius. 2. Enter your ChartHop API Authorization Token and Org ID. 3. Ask your AI client questions about your headcount or team structure. ## Frequently Asked Questions **Can the ChartHop MCP help with headcount planning?** Yes, it lets you view and review headcount and compensation planning scenarios directly through your AI client. You can check different "what-if" scenarios without having to manually toggle settings in the dashboard. **How do I see my company's team structure with ChartHop?** You can ask your agent to list all departments and teams. It will pull the current organizational mapping so you can see who reports to whom and how the teams are grouped. **Can I use the ChartHop MCP to look up employee profiles?** Yes, you can retrieve complete person information. This includes job history and compensation metadata, making it easy to get a full picture of an employee's role. **Is the ChartHop MCP good for hiring managers?** It's great for hiring managers who need to quickly check open job roles or see specific job details. You can get these answers in a chat instead of hunting through the HR portal. **Does the ChartHop MCP show my organization's summary?** Yes, it can pull your core organization information and settings. This is helpful for getting a quick pulse on your total headcount and overall structure. **Can I see all the jobs in my company using ChartHop?** You can ask your agent to list all jobs in the organization. It will provide a full list of every role currently tracked in your ChartHop account. **Can I see all open job positions in my company?** Yes! Use the `list_organization_jobs` tool. The agent will return all roles, and you can filter or identify those that are currently marked as open or unfilled. **How do I check the reporting line for a specific person?** Use the `get_person_details` tool with the person's unique ID. Your agent will fetch the full profile, which includes their manager and organizational placement data. **Where do I find my ChartHop Org ID and API Token?** You can find your Org ID in the URL when logged into ChartHop. To get an API Token, you typically need to create a 'ChartHop App' or request one from your administrator.