# All Digital Rewards MCP

> All Digital Rewards manages your entire incentive lifecycle through natural conversation. Use this MCP to enroll participants, track their point balances, issue performance points based on behavior, and audit fulfillment orders—all without logging into separate dashboards. It handles everything from listing global reward catalogs to tracking merchandise redemption status.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** incentive-programs, rewards, loyalty-management, fulfillment, customer-engagement, points-system

## Description

Forget jumping between the participant list, the catalog page, and the order dashboard just to run a report. This MCP lets your AI client handle complex engagement strategies through simple chat commands. You can use it to find out who needs rewards or if an item is actually in stock before promising it. Need to recognize top sellers? Ask your agent to identify them, or ask it to issue points for hitting a specific milestone right away. It's about automating the whole cycle: registration, point accrual, and fulfillment monitoring. When you connect this through Vinkius, your agent gets access to everything in one place—a massive win over having multiple siloed systems.

## Tools

### list_programs
Displays metadata for all active incentive programs available in the account.

### get_program_details
Gets details on a specific incentive program structure.

### list_participants
Provides a list of all users currently enrolled in the program.

### get_participant_details
Gets a detailed profile, including point balance and history, for a specific user.

### create_participant
Enrolls a new user into the rewards system.

### issue_points
Awards points to a user for achieving a certain behavior or milestone.

### list_reward_products
Shows a list of all digital and physical rewards that can be redeemed.

### get_product_details
Retrieves metadata about an available reward product.

### list_orders
Generates a list of all submitted reward redemption orders.

### get_order_details
Retrieves specific information about an order's fulfillment status.

## Prompt Examples

**Prompt:** 
```
List all active incentive programs in my account.
```

**Response:** 
```
I've retrieved your programs. You have 3 active incentive structures: 'Employee Wellness 2026', 'Customer Loyalty Platinum', and 'Q1 Sales Contest'. Would you like to see the participant count for any of these?
```

**Prompt:** 
```
Issue 500 points to participant ID 'part_12345' for 'Excellence Award'.
```

**Response:** 
```
I've successfully issued 500 points to participant part_12345. Their new balance is 1,250 points. The transaction has been logged under the 'Excellence Award' reason. Would you like to see their full transaction history?
```

**Prompt:** 
```
List the top 5 most popular rewards in my catalog.
```

**Response:** 
```
I've analyzed your reward catalog. The top 5 most redeemed items are: 1. $50 Amazon Gift Card, 2. $25 Starbucks Card, 3. Noise-cancelling Headphones, 4. Wireless Mouse, and 5. $100 Visa Prepaid Card. Would you like to check the current stock for the physical items?
```

## Capabilities

### Manage Participants
Enroll new users or check any participant's profile and current point balance.

### Track Rewards Inventory
List available digital goods, physical merchandise, and gift cards in your catalog.

### Issue Points Programmatically
Award points to users based on specific actions or milestones they hit.

### Audit Orders
List all redemption orders and check the real-time status of fulfillment, from request to shipping.

### View Program Rules
Retrieve metadata on active incentive structures to understand how points are calculated or rewards are structured.

## Use Cases

### New employee onboarding
The People Ops Manager needs to onboard a new hire and give them an immediate welcome bonus. They ask their agent to run `create_participant` first, then use `issue_points` with the 'Welcome Bonus' reason code, all in one chat session.

### Running quarterly sales contests
The Sales Director needs to know which reps are performing best. They ask the agent to run `list_participants`, filter for high point totals, and then use `get_product_details` to see what rewards those top performers qualify for.

### Checking on a delayed order
A customer calls asking about an old reward redemption. Instead of opening three different dashboards, the agent runs `list_orders`, finds the specific transaction ID, and uses `get_order_details` to see if it shipped.

### Updating program rules
A Marketing Manager needs to understand if a new reward type fits into an existing loyalty structure. They run `list_programs`, then use `get_program_details` to confirm the current point value constraints before adding a new product.

## Benefits

- Audit reward redemption orders in real-time. Use `list_orders` to track whether a gift card or merchandise is shipped out—no more guessing games about fulfillment status.
- Manage user bases instantly. You can enroll new members using `create_participant` and get detailed profiles, including point balances, with `get_participant_details`.
- Automate recognition efforts. Don't manually process bonuses; use `issue_points` to reward specific behaviors or milestones programmatically.
- Keep track of everything available. Need to know if a physical item is still stocked? Run `list_reward_products` and get the current catalog metadata.
- Understand your incentives. Use `list_programs` and `get_program_details` to quickly review how points are calculated or what rules govern specific campaigns.

## How It Works

The bottom line is that your AI client runs all these steps for you using natural conversation instead of manual API calls.

1. First, connect your credentials. You subscribe to this MCP and provide the required RewardSTACK Email and Password.
2. Next, tell your AI client what you need—for example, 'List all active incentive programs' or 'Check participant part_12345's balance'.
3. The agent executes the necessary calls, retrieving structured data on participants, rewards, or orders directly into the chat window.

## Frequently Asked Questions

**How do I check a participant's point balance using get_participant_details?**
You pass the unique user ID to `get_participant_details`. The system returns their full profile, which includes their current accumulated points and activity history. It’s fast and reliable.

**Can I list all available rewards using list_reward_products?**
Yes. Running `list_reward_products` gives you a complete dump of every digital gift card, physical item, or merchandise type currently in the catalog for redemption.

**What do I use to award points for good behavior? Is it issue_points?**
Yes, `issue_points` is exactly what you need. You give your agent the participant ID, the point amount, and a reason code (like 'Excellence Award') so it logs the transaction correctly.

**How can I get fulfillment status for an order? Do I use list_orders or get_order_details?**
Use `list_orders` first to find the specific order ID, then pass that ID into `get_order_details`. This two-step process ensures you get the most accurate, real-time status update.

**How do I use list_programs to see all currently active incentive structures?**
The list_programs function pulls every structured program available in your account. It gives you a high-level overview, including the program name and its status (active or paused). This is the starting point for figuring out what kinds of incentives you run.

**What data points are necessary when I use the create_participant tool?**
The create_participant function requires core identifying information, typically an email address and a unique user ID. Providing these basic details enrolls the individual into your system so they can start earning or redeeming rewards.

**If I need to know the precise rules governing point allocation, how do I use get_program_details?**
get_program_details retrieves a deep dive into a specific program's metadata. You can pull key parameters like minimum required points or eligibility criteria defined by your administrators. This helps you verify if an award meets the program's rules.

**Can list_participants handle filtering to get a roster of users who haven't logged in recently?**
list_participants provides a comprehensive directory of all enrolled members. You can usually filter this output by date range or status flags, allowing you to identify inactive participants for re-engagement campaigns.

**How do I find my RewardSTACK API credentials?**
Use your standard RewardSTACK administrative email and password. Your AI agent will use these to obtain a temporary JWT (JSON Web Token) for all API requests.

**Can I issue points to multiple participants at once?**
The `issue_points` tool currently processes points for a specific participant ID. For bulk processing, you can ask your agent to loop through a list of IDs or use the RewardSTACK batch file upload feature.

**What types of rewards are available in the catalog?**
The Reward Catalog API provides access to thousands of digital gift cards (Visa, Amazon, etc.), physical merchandise from major retailers, and unique experiential rewards.