# Namely MCP

> Namely connects your agent directly to your HRIS data, letting you manage employee profiles and company structure without logging into the Namely portal. You can instantly pull staff rosters, organizational charts, job titles, team lists, and recent company announcements using natural conversation.

## Overview
- **Category:** human-resources
- **Price:** Free
- **Tags:** hris, payroll, employee-management, org-structure, benefits-administration

## Description

Need a quick rundown of who works where? Connect this MCP to your agent and get full control over your organization's employee data through simple talk. Forget navigating complex HR portals just to find an address or confirm a role; you simply ask your AI client, and it handles the rest. You can pull every detail from employee profiles, check out current team structures, or even review upcoming birthdays using natural language commands. This capability is hosted on Vinkius, making it one of the easiest ways to bring complex HR data into your workflow. It also lets you list all available reports and custom fields specific to your company. The whole point is getting reliable answers instantly, whether you're checking an employee’s role or pulling a full directory.

## Tools

### get_profile
Retrieves specific contact details and information about one employee.

### get_team
Gets the detailed roster for a defined team within the organization.

### list_announcements
Fetches the most recent company-wide announcements from the main feed.

### list_events
Lists upcoming HR events, such as employee birthdays and work anniversaries.

### list_fields
Shows all custom data fields that are available for use on employee profiles.

### list_groups
Retrieves a list of major departments, offices, and organizational groupings.

### list_jobs
Lists all official job titles and the associated salary structures for your company.

### list_profiles
Generates a full list of every employee's basic profile information.

### list_reports
Lists all the standard and custom reports that can be run in your HR system.

### list_teams
Provides a list of smaller, defined working teams within the organization structure.

## Prompt Examples

**Prompt:** 
```
List all employees in the 'Engineering' department.
```

**Response:** 
```
I've retrieved the profiles for the Engineering department. You have 15 members, including 'David Smith' (Lead Developer), 'Elena Rodriguez' (Senior QA), and 13 others. Shall I show you the contact info for David?
```

**Prompt:** 
```
What company announcements were posted recently?
```

**Response:** 
```
I've checked the company feed. There are 3 recent announcements: 'New Office Safety Guidelines', 'Q3 Performance Review Kickoff', and 'Welcome Our New Hires!'. Would you like the full text for the safety guidelines?
```

**Prompt:** 
```
Show me upcoming birthdays in the organization.
```

**Response:** 
```
Retrieving upcoming events... We have 4 birthdays this week: Sarah Jenkins (Tomorrow), Michael Chen (Thursday), and two others on Saturday. Shall I get their Slack handles for you?
```

## Capabilities

### Retrieve individual employee details
Get the complete profile for any single staff member.

### List all active employees
Pull a comprehensive list of every person in your organization.

### Map out the org structure
View department groupings, team assignments, and official company hierarchy.

### Review job and salary data
Access a complete list of defined job titles and associated compensation structures.

### Monitor HR timelines
Check for upcoming organizational events, like work anniversaries or birthdays.

## Use Cases

### Onboarding new team members
A manager needs to onboard three people and confirm their reporting structure. They ask their agent: 'Show me the teams for Accounting, Engineering, and Marketing.' The agent uses list_groups and list_teams to pull the necessary structures, so the manager can immediately set up access.

### Auditing team membership
The IT department needs a definitive, current list of all employees to update network permissions. They ask their agent to run list_profiles and then use get_profile on specific names to cross-reference contact info for accurate provisioning.

### Preparing for an annual review meeting
An HR manager needs to pull a directory of employees who are approaching milestones. They ask the agent to run list_events, which immediately identifies all birthdays and work anniversaries happening in the next two weeks.

### Understanding reporting capabilities
A senior analyst wants to know what data is available for analysis. Instead of reading documentation, they ask their agent to use list_reports and list_fields, getting a quick overview of all potential datasets.

## Benefits

- Stop logging into multiple HR portals. With this MCP, you get all the profile data and org structure details in one place, accessed through conversation.
- Build instant reports by using list_profiles to pull complete staff rosters, then giving your agent a single command to filter them down for specific needs.
- Track team changes effortlessly. You can use list_groups or list_teams to understand the current departmental breakdown and who belongs where instantly.
- Never miss an important date again. The list_events tool automatically tracks work anniversaries and birthdays, giving you a clean reminder without manual calendar checks.
- Understand job scope quickly by listing all jobs. This lets you verify if someone's assigned role matches the official title defined in your organization.

## How It Works

The bottom line is you talk to your AI agent, and it uses this MCP connection to retrieve structured HR information from Namely.

1. Subscribe to this MCP and enter your Namely Company Slug along with the required API Token.
2. Connect your preferred AI client (Claude, Cursor, etc.) to Vinkius.
3. Start by asking a simple question, like 'List all employees in Accounting,' and let your agent pull the data.

## Frequently Asked Questions

**How do I use the Namely MCP to find all employees in a specific department?**
You start by asking your agent to 'List all employees in Accounting.' The agent uses list_profiles and filters the results, giving you a comprehensive roster for that exact department.

**Can I use Namely MCP to check my team's structure?**
Yes. You can use get_team or list_teams to view who belongs together. This is useful for planning departmental meetings and understanding reporting lines.

**What does the list_announcements tool do with Namely MCP?**
The list_announcements tool retrieves recent, company-wide news directly from the Namely home feed. You can ask your agent for a summary of what was posted recently.

**Does the Namely MCP let me edit employee records?**
No. This connection is read-only. It lets you retrieve and view data using tools like get_profile, but it cannot make changes to profiles or job titles.

**How many different types of reports can I list with the Namely MCP?**
You use the list_reports tool. This function reads all standard and custom report definitions available in your HR system, letting you know what data sets are ready for analysis.