# Bonusly MCP

> Bonusly connects your employee recognition system directly to any AI agent. Use natural conversation to give points, check leaderboards, see who's spent their rewards, and track company values—all without leaving your chat client.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** employee-recognition, rewards-program, company-culture, team-engagement, peer-feedback

## Description

Need to manage team morale? This MCP lets you run your entire corporate reward program through simple text commands. You can instantly recognize a colleague for great work by giving them points with a specific reason, making sure the recognition sticks. Want to know what's happening in the company? Just ask about recent bonuses or look up who’s leading the leaderboard right now. If you need to check your own status, you can pull up your profile and current point balance quickly. You also monitor reward spending by listing redemptions so HR knows how people are using their earned points. This connection lives within Vinkius, giving your AI client access to all these tools from one place. It turns complex internal workflows into simple chats.

## Tools

### get_bonus
Retrieves specific details about a single recognition bonus event.

### get_leaderboard
Fetches the current list of employees ranked by their earned points.

### get_my_profile
Pulls up your personal user details and point history.

### get_user
Retrieves detailed profile information for any employee in the company.

### give_bonus
Assigns a recognition bonus, allowing you to specify the recipient and reason.

### list_bonuses
Generates a list of all recent bonuses given within the company.

### list_hashtags
Displays popular hashtags that represent common team achievements or values.

### list_redemptions
Lists recent instances of employees spending their earned points on rewards.

### list_users
Provides a complete list of all active employee accounts.

### list_company_values
Shows the core company values and related recognition hashtags.

## Prompt Examples

**Prompt:** 
```
Give +10 to sarah@example.com for helping with the client presentation #teamwork.
```

**Response:** 
```
Recognition posted! I've given 10 points to Sarah with the reason: 'helping with the client presentation #teamwork'.
```

**Prompt:** 
```
What is my current Bonusly balance?
```

**Response:** 
```
You currently have 150 points available to give and 450 points that you've received and can redeem for rewards.
```

**Prompt:** 
```
Show the recent bonuses in the company.
```

**Response:** 
```
Retrieving recent bonuses... Notable recognition includes Mark giving to Alice for 'great code review' and Janet giving to the team for 'launching the new site'.
```

## Capabilities

### Give Recognition Bonuses
Award points and recognition to any employee in the system.

### Review Company Activity
Check recent bonuses given out or see a list of all company-wide rewards.

### Manage Employee Data
Get profiles for specific employees, check your own point history, or list everyone in the company.

### Track Reward Usage
View details on which earned points have been redeemed by team members.

### Understand Company Culture
Access current company values, popular hashtags, and the real-time leaderboard.

## Use Cases

### Celebrating a Team Win
The team lead needs to give 50 points to three people for finishing a project early. They just prompt their agent: 'Give 50 points to John, Jane, and Mike for the Q3 launch #speed'. The agent calls `give_bonus` for all of them, posting the recognition instantly.

### Audit Team Engagement
The HR manager wants to know if people are actually using their points. They ask the agent to run a report on recent spending. The agent uses `list_redemptions` and provides a summary of how many rewards were claimed last week.

### Checking Internal Policy
A new employee wants to know what the company values are for recognition. They ask, 'What are our core values?' The agent uses `list_company_values` and provides a definitive list of approved hashtags.

### Finding Team Info
A manager needs to give a bonus but can't remember the full email address for a new hire. They ask the agent to find the person using `get_user` and get the correct profile details instantly.

## Benefits

- Instant Recognition: Use the `give_bonus` tool to award points immediately, mentioning a specific reason and company value without leaving your current workflow.
- Full Visibility: Keep HR informed by using `list_redemptions` to see exactly how employees are spending their hard-earned points. This tracks engagement better than any spreadsheet.
- Culture Insights: Never guess what the team cares about again. Check out popular hashtags with `list_hashtags` or view all core values via `list_company_values` to guide recognition efforts.
- Performance Tracking: Instantly know who's leading the charge by calling `get_leaderboard`, giving you a real-time pulse on company performance and team effort.
- Employee Self-Service: Employees can check their own standing using `get_my_profile` or view the full list of colleagues with `list_users`, making them part of the reward loop.

## How It Works

The bottom line is, you use natural language chat prompts instead of logging into a separate HR dashboard.

1. Subscribe to this MCP and enter your Bonusly API Access Token.
2. Your AI client authenticates with Vinkius and connects to the Bonusly service.
3. You instruct your agent in plain language (e.g., 'Give 10 points to John for project completion').

## Frequently Asked Questions

**How do I give points using the Bonusly MCP?**
You simply tell your agent to award points using `give_bonus`. You just need to specify who gets points, how many, and why.

**Can the Bonusly MCP track spending?**
Yes. You can use the `list_redemptions` tool to get a record of all recent times employees have spent their earned points on rewards.

**What does the leaderboard show with the Bonusly MCP?**
The agent uses `get_leaderboard` to retrieve a real-time ranking, showing who has accumulated the most recognition points across the company.

**Is this good for HR managers? Does it help with employee engagement?**
Absolutely. By connecting directly and providing tools like `list_company_values` and `get_leaderboard`, you can monitor engagement metrics without leaving your chat client.

**How do I check my own point balance using Bonusly MCP?**
You call the `get_my_profile` tool. This instantly gives you a summary of your current points available to give and how many you've received for redemption.