# GaggleAMP MCP MCP

> GaggleAMP MCP gives your AI agent full control over employee advocacy and B2B social marketing. Manage sharing tasks across LinkedIn and Twitter, track engagement metrics, monitor advocate points, and run leaderboards—all through natural conversation. It lets you automate everything from inviting new team members to processing reward claims.

## Overview
- **Category:** collaboration
- **Price:** Free
- **Tags:** employee-advocacy, social-sharing, brand-reach, b2b-marketing, engagement-metrics, content-amplification

## Description

Stop checking dashboards manually just to see who shared what last week. This MCP connects your AI agent directly to GaggleAMP's core functions, letting you manage your entire employee advocacy program without ever leaving your chat window. You can tell the agent exactly which tasks need to be launched, check detailed performance metrics for any activity, and even process reward claims using a member's earned points. It handles everything from onboarding new team advocates to tracking top performers on the leaderboard. When you connect this through Vinkius, your AI acts like a dedicated program manager, handling complex workflows that used to take hours of clicks.

## Tools

### create_activity
Adds a new social sharing task that members must complete.

### get_activity_engagement
Pulls detailed statistics showing how well members engaged with a specific activity.

### get_top_advocates
Retrieves a list of high-performing members and their cumulative points/reach.

### get_account_details
Retrieves the profile information for a specific member or user.

### get_member_points
Checks the current point balance for any specified member.

### invite_new_advocate
Sends an invitation to a new person to join the advocacy program.

### list_activities
Shows all currently available or scheduled social sharing tasks for the team.

### list_all_gaggles
Retrieves a list of all accessible groups (Gaggles) within the platform.

### list_gaggle_members
Generates a full directory listing of every advocate in the program.

### list_reward_history
Shows a record of rewards that have already been claimed by members.

### list_available_rewards
Lists all items that members can redeem points for.

### redeem_reward_item
Processes the actual claim, deducting points from a member's account for a chosen reward.

## Prompt Examples

**Prompt:** 
```
List all active social activities in my Gaggle.
```

**Response:** 
```
I've retrieved your activities. You have 5 active tasks, including a LinkedIn share for the 'Q3 Product Update' and a Twitter like request. Would you like the engagement stats for any of these?
```

**Prompt:** 
```
Who are the top 3 performers in the leaderboard right now?
```

**Response:** 
```
Retrieving rankings... Currently, the top performers are 'John Smith' (1,200 points), 'Sarah Jane' (950 points), and 'Michael Scott' (880 points). John has the highest social reach this month.
```

**Prompt:** 
```
Show me all available rewards and their point costs.
```

**Response:** 
```
Scanning reward catalog... You have 4 items available: 'Gift Card' (500 pts), 'Company Swag' (300 pts), 'Extra Day Off' (2,000 pts), and 'Charity Donation' (100 pts). Should I check the redemption history?
```

## Capabilities

### Launch social tasks
The agent can create and schedule new sharing activities for members across platforms like LinkedIn and Twitter.

### Track campaign performance
You retrieve detailed engagement statistics for any existing activity to see what content is actually working.

### Manage the advocate directory
The system lets you view profiles, including point balances and impact scores, for every member in your network.

### Monitor team rankings
You access global or custom leaderboards to identify top-performing advocates immediately.

### Handle rewards distribution
The agent processes reward claims, deducting points from a member's balance for redeemed items.

## Use Cases

### Campaign launch follow-up
The social media lead asks, 'What did the Q3 product update share do?' The agent runs `list_activities` and then uses `get_activity_engagement` to report back the specific metrics (likes, shares) for that single campaign.

### Spotting a star performer
The marketing manager asks, 'Who should we reward this month?' The agent runs `get_top_advocates`, identifies the top three performers, and then checks their points using `get_member_points`.

### Onboarding a new team
The HR lead asks, 'Add five people from the Sales department.' The agent uses `list_gaggle_members` to confirm IDs and then runs `invite_new_advocate` for each person in bulk.

### Running end-of-quarter cleanup
The manager asks, 'What rewards are available, and who claimed them?' The agent calls `list_available_rewards` then runs `list_reward_history` to give a complete picture.

## Benefits

- Stop relying on manual reports. You can launch new sharing activities instantly using `create_activity` and measure their impact with `get_activity_engagement`.
- Never lose track of your best people again. Use `get_top_advocates` to see exactly who is driving the most social reach, making recognition easy.
- The team directory is always current. With `list_gaggle_members`, you get a clean list of advocates and their current point status via `get_member_points`.
- Reward programs are seamless. Instead of manually deducting points in two places, the agent handles it all when running `redeem_reward_item`.
- Scale your program faster than ever. You can invite new people with `invite_new_advocate` and manage team structures without touching a dashboard.
- See everything at once. The ability to list available rewards alongside checking the `list_reward_history` gives a complete financial view of the program.

## How It Works

The bottom line is that your AI client handles the whole connection process, taking commands from plain language to specific actions inside GaggleAMP.

1. First, subscribe to the GaggleAMP MCP and retrieve your API token from your manager dashboard settings.
2. Next, tell your AI agent what you want to do—for example, 'Show me all members who need a new sharing task.'
3. Your agent executes the necessary functions and returns structured data about activities, member points, or reward options.

## Frequently Asked Questions

**How do I check points using get_member_points?**
You simply ask your agent to run `get_member_points` for the member's name or ID. It instantly returns their current point balance and status.

**Can I use create_activity with GaggleAMP MCP?**
Yes, you can. The agent runs `create_activity` to schedule a new social sharing task for your advocates across the required channels.

**What is the purpose of get_top_advocates?**
This tool pulls ranking data from GaggleAMP, showing you who has contributed the most points or achieved the highest social reach recently.

**Can I list all members using list_gaggle_members?**
Absolutely. `list_gaggle_members` generates a comprehensive roster of every advocate in your program, making it easy to audit or analyze the whole group.

**How does using list_reward_history help audit our program's spending?**
The tool provides a full record of claimed rewards. It allows you to audit point usage by showing the date, item redeemed, and member ID for every transaction.

**What is the purpose of list_all_gaggles in my workflow?**
It retrieves a comprehensive list of all accessible 'Gaggles' or groups. This confirms which specific social circles your agent can manage and interact with for campaigns.

**If I need to scale, how does invite_new_advocate work?**
This tool programmatically sends invites to new advocates and manages the resulting team structures. It lets you expand your social reach without manual dashboard clicks.

**What should I expect when running redeem_reward_item?**
The system processes the reward claim and deducts points immediately. The response confirms if the item was successfully redeemed or if there's a point balance issue.

**How do I get an API token in GaggleAMP?**
Log in to your Manager Dashboard, navigate to **Settings** > **Integrations**, and copy the API Token provided under the API Access section.

**Can I check a member's point balance via AI?**
Yes! Use the `get_member_points` tool with the specific member ID to retrieve their current points and overall program impact.

**Does the integration support inviting new users?**
Absolutely. The `invite_new_advocate` tool allows you to send email invitations to join your program by providing a name and email address.