# ChartHop MCP

> ChartHop connects your organizational data to any AI agent, letting you manage people operations and workforce planning using natural conversation. You can get a full overview of your roster, map department structures, check headcount scenarios, or pull detailed profiles for any person—all without opening a dashboard.

## Overview
- **Category:** human-resources
- **Price:** Free
- **Tags:** people-operations, headcount-planning, organizational-data, workforce-management, hr-analytics, roster-management

## Description

Want an accurate picture of your organization's health? Instead of navigating multiple dashboards and clicking through endless reports, you just talk to your AI agent. This MCP gives you direct access to all your workforce planning data in ChartHop. You can ask it things like, 'What are our open roles?' or 'How many people report into the Engineering department?' Your agent then pulls that information instantly. It's like having an HR analyst sitting right next to you, ready to answer complex questions on demand. Because this MCP sits within the Vinkius catalog, your agent can connect to this data no matter what AI client you prefer. You get immediate oversight of roles, people, and headcount planning from a single chat window.

## Tools

### get_job_details
Retrieves detailed information about a single, specific job role in the company.

### get_organization_summary
Pulls core organization data and account settings for an overview of your company structure.

### get_person_details
Gathers a complete profile, including job history and compensation metadata, for one employee.

### list_organization_departments
Lists every department within the organization to understand how many groups exist.

### list_organization_jobs
Retrieves a list of all defined job roles (or positions) across the company.

### list_organization_people
Provides a comprehensive roster listing every employee in the organization.

### list_planning_scenarios
Lists and compares different hypothetical plans for headcount or compensation across your company.

### list_organization_teams
Shows a list of all internal teams, helping you map out team groupings within the company.

## Prompt Examples

**Prompt:** 
```
Show me the headcount summary for my organization.
```

**Response:** 
```
Retrieving organization summary... You currently have 150 filled roles and 12 open positions across 5 departments. The largest department is Engineering with 65 people.
```

**Prompt:** 
```
List all departments and their leaders.
```

**Response:** 
```
Checking departments... I found 5 departments: Engineering (Lead: John Doe), Sales (Lead: Sarah Miller), Marketing (Lead: Mike Scott), Product (Lead: Jane Smith), and HR (Lead: Pam Beesly).
```

**Prompt:** 
```
Show me details for 'John Smith' in ChartHop.
```

**Response:** 
```
Searching for 'John Smith'... I found 1 matching profile. John is a 'Senior Software Engineer' in the 'Engineering' department, reporting to 'Jane Smith'. He started on 2022-05-10.
```

## Capabilities

### Check overall organizational health
Get an immediate summary detailing total filled roles, open positions, and departmental breakdowns.

### Map department structures
List every department and team in the organization to understand the reporting hierarchy.

### Review employee profiles
Fetch complete details for a specific person, including their job history and compensation information.

### Analyze open positions
List all available jobs (roles) and monitor different headcount planning scenarios.

### Get core system settings
Access foundational organization data and account configurations directly through the agent.

## Use Cases

### Auditing department reporting lines
An HR Business Partner needs to confirm if the Marketing team reports up through the main Product line. They ask their agent to 'list departments and teams.' The agent runs `list_organization_departments` and `list_organization_teams`, showing the exact structure immediately.

### Checking total headcount before a meeting
An Executive needs an immediate, reliable number for Q3 staffing levels. They prompt their agent to 'show me the current organization summary.' The MCP uses `get_organization_summary` and returns the total filled roles in seconds.

### Investigating a specific employee's background
A People Ops Manager needs to verify an employee’s full job history for an audit. They prompt 'details for Sarah Jones.' The MCP uses `get_person_details` and provides the complete professional record, including compensation metadata.

### Comparing hiring scenarios
A Hiring Manager needs to compare two staffing options: Option A (hiring 10 people) versus Option B (restructuring three departments). They use `list_planning_scenarios` and get a clear, actionable comparison of both models.

## Benefits

- Get instant organizational summaries. Instead of digging into reports, you ask the agent to check total filled roles or open positions using `get_organization_summary`.
- Understand team structure immediately. You can list all departments and then use `list_organization_teams` to map out how specific teams are grouped under those departments.
- Deep dive on any employee profile. Need to know John Smith's job history or pay grade? Use `get_person_details` to pull a complete background check instantly.
- Plan for the future with confidence. Reviewing multiple workforce possibilities is easy; just call `list_planning_scenarios` and compare your options in real-time.
- See every open role at once. Don't manually list jobs; use `list_organization_jobs` to pull a complete, updated roster of all available positions.

## How It Works

The bottom line is you treat complex HR data like simple conversation.

1. Subscribe to this MCP, then enter your ChartHop API Authorization Token and Org ID.
2. Your AI client uses those credentials to establish a secure connection to your organizational data.
3. You ask your agent natural language questions—like 'Show me the total headcount'—and get instant answers pulled from ChartHop.

## Frequently Asked Questions

**How do I find out the total number of employees using ChartHop MCP?**
You can get a summary count by asking your agent to retrieve the organization summary. The `get_organization_summary` tool gives you an immediate count of both filled roles and open positions across departments.

**Can I compare different headcount options with ChartHop MCP?**
Yes, you can list and review multiple planning scenarios at once. Use the `list_planning_scenarios` tool to access and compare various hypothetical workforce models.

**What information does get_person_details provide?**
`get_person_details` provides a comprehensive profile for an employee, including their job history and compensation metadata. It's the deepest dive into any single person's record.

**How can I see all the available roles in my company?**
To get a full list of every defined role across the organization, use `list_organization_jobs`. This gives you the definitive roster of job titles that exist.

**Does ChartHop MCP help me map department hierarchies?**
Yes. You can first call `list_organization_departments` to get all departments, and then use `list_organization_teams` to see how those departments are broken down into specific teams.