# Pointagram MCP for AI Agents AI Agent Connect

> Pointagram MCP connects your gamification platform to your AI agent. It lets you manage player profiles, team memberships, and score series while automating point distribution for real-time leaderboards and employee engagement.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_9QnerOvNCZPaF0zesLvoJ6bvnLPvw0kfgvoThdLu/ai-agent-connect
- **Tags:** gamification, employee-engagement, leaderboards, kpi-tracking, performance-management, rewards

## Description

Pointagram connects your gamification platform to your AI agent so you can manage rewards and leaderboards through a simple conversation. It handles the repetitive tasks of updating scores, creating player profiles, and checking team stats. Instead of jumping between tabs to find a specific score series or manually entering points for a sale, you just tell your agent what happened. It takes care of the data entry, making it much easier to keep your team engaged and motivated. You can pull full player lists or check specific stats to see who's leading the pack. By plugging this into your workflow via Vinkius, you turn a manual administrative hurdle into a quick command. You get to spend less time on the mechanics of the game and more time actually rewarding your people.

## Tools

### create_player
Create a new player profile with a nickname and avatar. Use this to quickly onboard new team members into your rewards program.

### list_teams
Pull a list of all teams and their membership details. Use this to manage group-based rewards and competitions.

### get_player_stats
Retrieve specific stats for a single player. It's useful for checking an individual's progress toward a goal.

### list_players
Get a full list of every player in your Pointagram account. Use this to see everyone involved in your active programs.

### list_score_series
View all your active score series. This helps you understand how points are being distributed across different competitions.

### post_event
Send a scoring event to update player points. This is how you reward achievements instantly through your AI agent.

## Prompt Examples

**Prompt:** 
```
Show me who's winning the 'Monthly Sales' challenge.
```

**Response:** 
```
Here are the top 5 participants for the **Monthly Sales** challenge:

| Rank | Player | Points | Status |
| :--- | :--- | :--- | :--- |
| 1 | Alex Chen | 1,250 | 🏆 Leader |
| 2 | Sarah J. | 1,180 | 
| 3 | Mike Ross | 1,050 | 
| 4 | Elena R. | 990 | 
| 5 | David W. | 950 | 

Would you like to see the full stats for any of these players?
```

**Prompt:** 
```
Give 50 points to player 992 for a great customer review.
```

**Response:** 
```
Done! I've posted a scoring event for **player 992**. They've been awarded **50 points** for their great customer review. The leaderboard will update automatically.
```

**Prompt:** 
```
List all the teams we have right now.
```

**Response:** 
```
You currently have 4 active teams in Pointagram:

*   **Sales Alpha** (12 members)
*   **Support Heroes** (8 members)
*   **Marketing Mavens** (5 members)
*   **Product Pioneers** (3 members)

Let me know if you want to see the membership details for any of these.
```

## Capabilities

### Create new player profiles
Use create_player to add new participants to your gamification program with nicknames and avatars.

### Fetch individual player stats
Get real-time progress and rankings for any specific participant using get_player_stats.

### View full participant lists
Retrieve a complete list of everyone involved in your programs using list_players.

### See all active score series
Check all your current competitions and point rules with list_score_series.

### Manage team memberships
Access and monitor your gamification groups and their metadata using list_teams.

### Record scoring events
Update points instantly for any achievement using the post_event tool.

## Use Cases

### Real-time sales rewards
A sales manager asks the agent to award 50 points to the Northeast team for hitting their Friday goal using post_event.

### HR onboarding tracking
An HR lead asks for the top 5 participants in the new hire challenge to see who's progressing fastest using get_player_stats.

### Competition oversight
An engagement specialist asks to see all active score series to check which competitions are currently live using list_score_series.

### Team membership auditing
An admin asks for a list of all teams to verify who is in the 'Alpha' group using list_teams.

## Benefits

- Award points instantly: Use post_event to give rewards the moment a win happens without leaving your chat.
- Check live standings: Use get_player_stats to see exactly how a specific player is tracking against their goals.
- Fast-track onboarding: Use create_player to add new team members to your rewards program in seconds.
- View all competitions: Use list_score_series to get a bird's eye view of every active challenge you're running.
- Manage group rewards: Use list_teams to quickly check memberships and group-level progress.

## How It Works

The bottom line is you turn manual gamification management into a simple conversation with your AI.

1. Connect your Pointagram API key and email in your AI client settings.
2. Ask your agent to list your active teams or score series to see your current setup.
3. Give commands to award points or create new players using natural language.

## Frequently Asked Questions

**Can Pointagram MCP help me run a sales competition?**
Yes, it connects your Pointagram account to your AI agent so you can manage scoring and rewards for sales competitions using natural language.

**How do I award points to my team using an AI agent?**
You can just tell your AI agent to award points for a specific achievement. The Connector will handle the update in Pointagram automatically.

**Can I see who is winning my gamification programs?**
Yes, your agent can pull live stats and rankings for any player or team in your Pointagram account to show you who's leading.

**Is Pointagram MCP good for HR engagement?**
It's perfect for HR. It allows you to automate employee recognition and rewards, making it much easier to keep staff engaged with less manual work.

**How do I add new people to my leaderboard?**
You can simply ask your AI agent to create a new player profile. It will add the new person to your Pointagram program instantly.

**Can I see all my active score series at once?**
Yes, you can ask your agent to list all active score series to get a quick overview of every competition currently running.

**How do I get my Pointagram API credentials?**
Log in to your Pointagram account, navigate to the **Settings** or **API** section, and you will find your Api-Key. Your Api-User is your login email.

**Can I update points programmatically?**
Yes, the `post_event` tool allows you to send new scoring activities for any player, which will automatically update their score in the corresponding series.

**Does it support team stats?**
Absolutely. You can use the `list_teams` tool to view all teams and their members, and use individual player tools to build aggregate team views.