# Namely MCP for AI Agents AI Agent Connect

> Namely MCP lets you manage HRIS data directly through your AI agent. Track employee profiles, job titles, and organizational structures without switching tabs. It pulls real-time info from your Namely account so you can handle HR tasks using natural language commands.

## Overview
- **Category:** human-resources
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_4Og9mb5pe2c1JYPYTetMcM7AbOhS5DoWCF2Ye1RI/ai-agent-connect
- **Tags:** hris, payroll, employee-management, org-structure, benefits-administration

## Description

Imagine you're in the middle of a busy week and need to pull a list of everyone in the Engineering department who's eligible for a promotion. Usually, that means logging into your HRIS, navigating through several sub-menus, and exporting a CSV just to sort through it. With this Connector, you just ask your AI agent to do it for you. It connects directly to your Namely account, allowing your agent to see the actual data you use every day. You can ask about specific employee details, check out your company's org structure, or find out when the next batch of work anniversaries are coming up. It's about moving from clicking through dashboards to just getting answers. Since Vinkius hosts this, you can plug it into your existing workflow and let your agent handle the heavy lifting of data retrieval. Whether you're looking for custom fields in your profiles or trying to see what's on the company feed, the information is right there in your chat interface.

## Tools

### list_jobs
Get a full list of job titles and associated salary information. It's useful for auditing roles and pay.

### list_profiles
Get a complete list of all employee profiles in the system. This is the fastest way to see everyone in the company.

### list_reports
See all the HR reports currently available in your account. Use this to know what data you can export.

### get_profile
Fetch specific details for an individual employee profile. This helps you quickly find contact info or roles.

### get_team
Pull specific details about a particular team within the company. It's great for checking team-specific info.

### list_announcements
Get a list of recent company-wide announcements from the home feed. Use this to stay updated on company news.

### list_events
See upcoming HR events like birthdays and work anniversaries. It helps you stay on top of important dates.

### list_fields
See the custom data fields you've set up for employee profiles. This clarifies what data points are available.

### list_groups
View all departments, offices, and groups in the organization. Use this to see the full company hierarchy.

### list_teams
List all the different teams organized within your company. This gives you a high-level view of your team structure.

## Prompt Examples

**Prompt:** 
```
Who is in the Engineering department?
```

**Response:** 
```
I've pulled the list of employees in the Engineering department for you:

| Name | Role |
| :--- | :--- |
| **David Smith** | Lead Developer |
| **Elena Rodriguez** | Senior QA |
| **Marcus Chen** | Backend Engineer |

There are 15 members in total. Would you like me to get the contact details for anyone on this list?
```

**Prompt:** 
```
What's the latest news from the company feed?
```

**Response:** 
```
Here are the most recent announcements from the Namely home feed:

* **New Office Safety Guidelines** - Please review the updated protocols for the downtown office.
* **Q3 Performance Review Kickoff** - Reviews begin next Monday.
* **Welcome Our New Hires!** - We have 5 new team members joining us this month!

Let me know if you'd like the full text for any of these.
```

**Prompt:** 
```
Are there any birthdays this week?
```

**Response:** 
```
I checked the organization timeline. Here are the upcoming birthdays for this week:

* **Sarah Jenkins** (Tomorrow)
* **Michael Chen** (Thursday)
* **Jessica Wu** (Saturday)

Should I get their Slack handles or contact info for you?
```

## Capabilities

### Pull employee profiles
Get specific contact info and roles for any team member.

### View org structure
See how departments and groups are organized across the company.

### Check job details
Access a full list of job titles and salary structures.

### Monitor HR events
See upcoming birthdays and work anniversaries on the timeline.

### Access company news
Read recent company-wide announcements from the Namely home feed.

### List custom data
See the specific custom fields you've set up for employee profiles.

## Use Cases

### Onboarding a new hire
An HR manager asks the agent to list all profiles in the Marketing group to identify who needs to be added to the email list.

### Audit of job titles
An ops lead asks the agent to list all jobs to see if the current salary structures match the new company policy.

### Planning a team lunch
A manager asks the agent to list events to see which team members have birthdays coming up this week.

### Checking company news
A new employee asks the agent what the latest company-wide announcements are to get caught up on office news.

## Benefits

- Stop clicking through menus to find employee info by using get_profile to pull specific details instantly.
- Get a clear view of your company's hierarchy by using list_groups to see every department and office.
- Save time on manual reporting by using list_reports to see what data is available for export.
- Stay on top of company culture by using list_events to see upcoming birthdays and anniversaries.
- Quickly identify job roles and pay structures using list_jobs instead of searching through spreadsheets.
- Keep your team informed by pulling recent news from the Namely home feed using list_announcements.

## How It Works

The bottom line is you get instant access to your HRIS data through a simple chat interface.

1. Subscribe to the Namely MCP on Vinkius.
2. Provide your Namely Company Slug and API Token in your client settings.
3. Ask your AI agent to list employees, check jobs, or pull reports.

## Frequently Asked Questions

**Can the Namely MCP see my employee's contact info?**
Yes, it can pull specific profile details including roles and contact information from your Namely account.

**How does the Namely MCP help with org structure?**
It lets your agent list all departments, offices, and teams so you can see the hierarchy clearly without opening the portal.

**Can I use the Namely MCP to see salary info?**
Yes, you can ask the agent to list job titles and the salary structures defined in your organization.

**Does the Namely MCP show company announcements?**
It can pull recent news from the Namely home feed directly into your chat interface.

**Can the Namely MCP help me track work anniversaries?**
It can list upcoming events from your organization timeline, including work anniversaries and birthdays.

**Is the Namely MCP good for HR reporting?**
You can use it to see all available HR reports in your account to help with data planning and auditing.

**What kind of data can I see with the Namely MCP?**
You can see profiles, jobs, teams, groups, announcements, and custom fields.

**How do I get a Namely API Token?**
You can generate a Personal Access Token in your Namely account under API > Personal Access Tokens. Ensure your user has the appropriate permissions to view the data you want to retrieve.

**Can I see salary information through this server?**
This depends on the permissions of the user who generated the API token. If your Namely user can see salary data, the `get_profile` and `list_jobs` tools will return that information.

**What is the Company Slug?**
The slug is the unique part of your Namely URL. For example, if you log in at 'acme.namely.com', your slug is 'acme'.