# Giftbit MCP

> Giftbit lets you manage digital rewards and gift cards directly through your AI client. Order new campaigns, check if a customer claimed their bonus, generate custom links for apps, or track redemption status—all without leaving your primary workspace. It's the automated way to run employee recognition and customer loyalty programs.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** gift-cards, rewards, incentives, api-integration, automation, customer-loyalty

## Description

Need to distribute digital rewards but hate jumping between dashboards? This MCP connects Giftbit’s powerful reward platform right into your agent. You can use natural conversation to manage everything from ordering new gift cards to tracking whether a recipient actually claimed their bonus. Want to run an employee recognition campaign? Simply ask the AI client, and it handles generating the necessary rewards and sending them via email. If you're building a user research incentive program, you can have the agent generate custom links for your app on the fly. The system also lets you check brand availability in different regions or review past campaigns to confirm delivery status. By connecting Giftbit through Vinkius, you keep all your reward fulfillment operations accessible to your AI client—it’s pure automation.

## Tools

### verify_api_connection
Confirms that the connection credentials between your AI client and Giftbit are working correctly.

### order_email_rewards
Sends digital rewards to recipients directly through a customized email campaign.

### create_reward_links
Generates standard, direct URLs for specific gift card values that can be distributed anywhere.

### create_embedded_links
Creates special links designed to display the reward directly inside a website or mobile app.

### get_brand_details
Retrieves metadata for specific gift card brands, including allowed regions and pricing rules.

### get_campaign_status
Checks the status of a previous rewards campaign to ensure it completed delivery successfully.

### get_gift_status
Fetches the detailed, real-time status for an individual gift record, showing if it was opened or claimed.

### list_reward_brands
Provides a list of all available reward brands and allows filtering by geographical region.

### list_reward_campaigns
Lists records of past campaigns, helping you keep track of bulk rewards sent out previously.

### list_gift_records
Retrieves a list of all individual gift records associated with a campaign or date range.

### list_delivery_regions
Lists the geographical regions supported by Giftbit to ensure your rewards will reach the intended recipient.

### check_api_health
Runs a quick check to verify that the entire Giftbit API connection is operational and ready for use.

## Prompt Examples

**Prompt:** 
```
List available reward brands in the US region.
```

**Response:** 
```
Retrieving brands... I found several options for the US, including 'Amazon', 'Starbucks', and 'Target'. Would you like the minimum/maximum allowed prices for any of them?
```

**Prompt:** 
```
Check the status of gift 'uuid-12345'.
```

**Response:** 
```
Fetching gift status... The gift was 'DELIVERED' yesterday, and the redemption status is currently 'CLAIMED'. The recipient selected a Starbucks card.
```

**Prompt:** 
```
Generate 3 direct links for a $10.00 Amazon card.
```

**Response:** 
```
Links generated! I have successfully created 3 direct links for a $10.00 Amazon card (1000 cents). The short URLs are: [Link 1], [Link 2], and [Link 3].
```

## Capabilities

### Send rewards via email
Automatically orders and distributes digital gift cards directly to recipients' inboxes.

### Create direct links
Generates specific, raw URLs that can be pasted into any system or document for immediate use.

### Generate embedded rewards
Creates specialized link structures that display the reward card directly within a website or app interface.

### Check brand availability
Lists all available gift card brands, showing current regions and allowed price ranges for vetting new options.

### Track redemption status
Retrieves detailed records for specific gifts to confirm if they were delivered, claimed, or used.

### Manage campaign history
Lists past rewards campaigns and confirms their overall completion and delivery statuses.

## Use Cases

### Apology Gift Fulfillment
A Customer Success Manager needs to apologize to a high-value client whose service failed. Instead of emailing a support ticket and waiting for manual processing, they ask the agent to check brand availability using `list_reward_brands`, then immediately send the replacement gift via `order_email_rewards`.

### User Research Incentive Tracking
A Product Manager runs a study requiring 50 participants to submit data. They ask the agent to generate 50 unique direct links using `create_reward_links`, distributing them via their internal app, and then later use `list_gift_records` to track exactly who completed the survey.

### Internal Employee Recognition
An Operations Manager wants to recognize a team's huge effort. They ask the agent to list all available brands using `list_reward_brands`, select 'Amazon', and then send bulk rewards across multiple departments by calling `order_email_rewards`.

### Technical Audit
A developer needs to ensure their new integration point handles gift cards correctly. They use the agent to run `check_api_health`, verifying connectivity before any live transaction occurs, preventing downtime and ensuring reliability.

## Benefits

- Stop manual status checks. Instead of logging into a dashboard to see if a gift was claimed, simply ask the agent for the `get_gift_status` on any UUID and get instant answers.
- Manage full campaigns without leaving your client. Use this MCP to run multi-step workflows: checking brand options via `list_reward_brands`, then sending rewards using `order_email_rewards`—all in one conversation.
- Build better user experiences by generating dynamic links on the fly. You can use `create_embedded_links` or `create_reward_links` to embed incentives directly into a website, making redemption seamless for users.
- Never lose track of bulk rewards again. The MCP lets you `list_reward_campaigns`, giving you an immediate overview of past initiatives and confirming delivery status instantly.
- Scale recognition programs effortlessly. HR can trigger entire employee reward cycles with one command, eliminating the need to manually process hundreds of gift card orders.

## How It Works

The bottom line is, you get instant access to advanced reward management tools without ever touching a separate web dashboard.

1. Subscribe to this MCP via the Vinkius Marketplace.
2. Enter your Giftbit API Token into your AI client's configuration.
3. Start interacting with the rewards system through natural conversation.

## Frequently Asked Questions

**How do I use Giftbit MCP to check available gift card brands?**
You use the `list_reward_brands` tool. Just ask your agent to list all brands and specify the region you're interested in, like 'US.' It will show you what options are currently supported.

**Can Giftbit MCP track if a gift card was used?**
Yes, the `get_gift_status` tool retrieves detailed status updates. You can confirm if the recipient has opened or claimed their reward and see what type of card it is.

**Does Giftbit MCP support generating links for my own app?**
Yes, you have two options: use `create_reward_links` for simple direct URLs, or use `create_embedded_links` if you need the reward to display inside a web page or mobile app.

**What is the best way to run a bulk campaign with Giftbit MCP?**
Start by listing your delivery regions using `list_delivery_regions`. Then, use the agent to process the rewards in batches via `order_email_rewards`, ensuring you cover all necessary geographical areas.

**I need to test Giftbit MCP before going live. How?**
The system supports environment control. You should instruct your agent to use the 'testbed' or sandbox mode when running any commands, like `create_reward_links`, until you are ready for real transactions.