# Gift Up! MCP

> Gift Up! connects gift card management to your AI client through the Model Context Protocol. It lets you track orders, verify codes, and process redemptions using natural conversation instead of dashboards. Check account details, list all transactions, or instantly deduct balances with simple commands.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** gift-cards, redemption, order-management, payment-processing, retail

## Description

Managing physical goods is one thing; managing virtual gift cards is another. This MCP gives your AI client direct access to your entire Gift Up! system. You stop logging into multiple dashboards just to answer a basic customer question. Instead, you ask your agent to validate a code or find an order by reference number and get the result instantly. Need to process a partial redemption? Just ask for it; the MCP executes the transaction and updates the balance immediately. When you connect this through Vinkius, you're putting all that gift card functionality—from listing webhooks to checking account identity—right into your chat window. It’s about doing complex e-commerce operations using only words.

## Tools

### verify_api_connection
Tests the connection between your AI client and Gift Up! to ensure all data calls will work.

### find_order_by_ref
Searches for a specific gift card order using its public reference number.

### get_account_details
Retrieves general identity and setup information about your connected Gift Up! account.

### get_card_details
Fetches specific metadata or details associated with a particular gift card code.

### validate_gift_card
Checks the current status and remaining balance of any provided gift card code.

### get_order_details
Retrieves comprehensive metadata for a specific, known order ID.

### list_active_gift_cards
Lists all gift cards currently active in your system to maintain an audit trail.

### list_gift_orders
Generates a list of multiple completed or pending gift card orders over a specified time period.

### list_gift_webhooks
Displays the configuration and status of all active webhooks for real-time monitoring.

### redeem_gift_card_full
Processes a full redemption, deducting the entire remaining balance from a gift card code.

### redeem_gift_card
Handles partial redemptions, allowing you to deduct only a specified amount from a gift card balance.

### update_order_metadata
Adds or changes internal key-value pairs on an order for better mapping with your CRM or ERP system.

## Prompt Examples

**Prompt:** 
```
Check the balance for gift card code 'GIFT-123-ABC'.
```

**Response:** 
```
Validating code... Gift card GIFT-123-ABC is 'Active' with a remaining balance of $25.00 USD. It expires on December 31st.
```

**Prompt:** 
```
Redeem $10.00 from gift card 'abc-987'.
```

**Response:** 
```
Redemption successful! I have deducted $10.00 from gift card abc-987. The new remaining balance is $15.00 USD.
```

**Prompt:** 
```
List all gift card orders from the last 7 days.
```

**Response:** 
```
Retrieving orders... I found 8 orders created since last week, totaling $450.00 in gift card value. Would you like the details for the most recent one?
```

## Capabilities

### Check card status and balance
Validate any given code instantly to confirm its activity, remaining value, and expiration date.

### Find specific orders
Search for a gift card order using a public reference number or retrieve full details about the transaction.

### Process redemptions
Deduct money from a gift card, handling both full balance redemptions and specified partial amounts.

### Review order history
Generate comprehensive lists of all sales or retrieve metadata for specific orders to aid accounting.

### Manage system records
List active gift cards, track webhooks, or update custom fields attached to an order record.

## Use Cases

### A customer asks about an old order.
The agent doesn't have the ID. They use `find_order_by_ref` with just the public reference number and immediately get all the necessary details, saving a back-and-forth email exchange.

### End-of-month financial audit.
The accountant asks their agent to run `list_gift_orders` for the month. The AI pulls 40+ records and calculates the total value, giving a ready-to-use summary for reconciliation.

### Processing a complex return.
The support team needs to confirm a customer's gift card status before issuing credit. They use `validate_gift_card`, confirming the code is active and has sufficient funds, then proceed with the transaction.

### Migrating order data.
The e-commerce team needs to link new fulfillment records into Gift Up!. They use `update_order_metadata` to attach internal key-value pairs directly to existing orders, keeping the CRM and gift card system aligned.

## Benefits

- Instantly verify codes: Use `validate_gift_card` to check a code's status and balance in seconds, giving your customers immediate answers without delay.
- Automate transactions: Process money deductions with either `redeem_gift_card` for partial amounts or `redeem_gift_card_full` when the card is completely used up.
- Never lose track of sales: Run a report using `list_gift_orders` to pull comprehensive order lists and total values from the last few days in one go.
- Keep your systems clean: Use `update_order_metadata` to attach custom tracking data (like internal ticket numbers) directly to an order for better compliance and fulfillment.
- Full visibility: Run `list_active_gift_cards` or check `get_account_details` anytime you need a quick, reliable overview of your gift card inventory.

## How It Works

The bottom line is: you talk to your agent using natural language, and the MCP does the heavy lifting by talking directly to Gift Up!'s system.

1. Subscribe to Gift Up! through the Vinkius Marketplace and connect your account.
2. Enter your specific Gift Up! API Key into the MCP settings.
3. Ask your AI client a question, like 'What is the balance for code X?', and it runs the tool.

## Frequently Asked Questions

**How do I check gift card balances with Gift Up! MCP?**
You use the `validate_gift_card` tool. You simply ask your agent to validate a code, and it returns the current status, remaining balance, and expiration date.

**Can I list all gift card orders using Gift Up! MCP?**
Yes, running `list_gift_orders` allows you to pull comprehensive lists of sales over a time frame. It's great for generating quick reports or checking totals.

**Is the redemption process instant with Gift Up! MCP?**
Yes. When you ask your agent to redeem money using `redeem_gift_card` or `redeem_gift_card_full`, the change happens immediately in the live system.

**What is 'metadata' and how do I update it with Gift Up! MCP?**
Metadata are custom notes attached to an order. You use `update_order_metadata` when you need to attach specific internal data, like a fulfillment ticket ID, for tracking.

**Does Gift Up! MCP handle partial redemptions?**
Absolutely. The dedicated tool `redeem_gift_card` lets you process and deduct only a specified amount from the card, perfect for multi-stage use cases.