# Gift Up! MCP for AI Agents AI Agent Connect > Gift Up! helps you manage gift card orders, track balances, and handle redemptions through your AI agent. It lets you validate codes, check remaining values, and update order metadata instantly. Whether you're handling customer support or managing retail operations, this Connector connects your gift card data to your daily workflow, letting you skip the manual data entry and focus on your customers. ## Overview - **Category:** ecommerce - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_yxsJLNTXRX4yeIY9bYKtLArIvrl5zFPYxvCyEJGs/ai-agent-connect - **Tags:** gift-cards, redemption, order-management, payment-processing, retail ## Description This Connector connects your Gift Up! account to any AI agent so you can handle gift card operations without jumping between tabs. Instead of hunting through a dashboard to see if a code is valid or how much balance is left, you can just ask your agent to check it. You can pull up order details, find specific transactions by reference numbers, and see what cards are still active in your system. It handles the heavy lifting of redemption, letting you process full or partial amounts during a checkout or a support call. You can even update internal notes on orders to keep your CRM in sync. By using the Vinkius marketplace to get this set up, you're bringing your entire gift card registry into your primary workspace. It turns a manual process of copy-pasting codes into a conversation where you can just get things done. You won't have to worry about manual math or missing a step in the fulfillment chain. Your agent takes over the tedious work of looking up history and verifying values, making sure that every transaction is recorded correctly and every customer gets the exact balance they expect. It's about making the backend of your retail business feel like a natural conversation rather than a series of complex data entries. ## Tools ### find_order_by_ref Locate a specific order using a public reference number. It's great for quickly finding a customer's transaction. ### get_card_details Fetch the metadata for a specific gift card. This shows you the specific details tied to a card. ### validate_gift_card Check the current balance and status of a gift card code. This is the primary way to see if a card is still usable. ### list_gift_orders Get a list of all gift card orders. You can use this to scan through your recent sales history. ### verify_api_connection Check if your connection to Gift Up! is active. This ensures your agent can talk to the right account. ### get_account_details Pull the identity and basic info for your Gift Up! account. Use this to confirm which store or account you're managing. ### get_order_details Pull the metadata and history for a specific gift card order. Use this to see the full context of a purchase. ### list_gift_webhooks See your current webhook configurations. This helps you ensure your internal systems are getting real-time notifications. ### redeem_gift_card_full Deduct the entire balance of a gift card. This is the fastest way to clear a full redemption in one go. ### list_active_gift_cards See every active gift card currently in your system. This helps you maintain a clear view of your inventory. ### redeem_gift_card Process a partial redemption on a gift card. This lets you take a specific amount off the balance during checkout. ### update_order_metadata Set or change custom key-value pairs on an order. This keeps your internal notes synced with your CRM or ERP. ## 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 ### Validate gift card balances Check if a card is active and see the remaining value instantly. ### Process partial redemptions Deduct specific amounts from a card balance during a checkout or support call. ### Retrieve order history Pull up detailed metadata for any gift card order in your system. ### Sync order metadata Update internal notes and custom fields to keep your CRM and ERP in sync. ### Monitor active webhooks Keep track of your webhook configurations for real-time redemption notifications. ### Search by reference number Find specific transactions quickly using public reference numbers. ## Use Cases ### Verifying a customer's card status A customer says their card isn't working. The support rep asks the agent to validate_gift_card to see if it's active and what the balance is. ### Processing a partial spend A customer wants to spend $20 of a $50 card. The agent uses redeem_gift_card to deduct the $20 and confirms the remaining $30 balance. ### Auditing recent sales volume An admin needs to audit recent sales. The admin asks the agent to list_gift_orders from the last week to see total volume. ### Updating fulfillment notes A warehouse needs to update a shipping note on an order. The agent uses update_order_metadata to add a custom shipped tag to the order. ## Benefits - Stop manual code checking. Use validate_gift_card to instantly see if a card is active and what's left on it without opening a browser. - Handle partial redemptions faster. Use redeem_gift_card to deduct specific amounts during a support call instead of doing manual math. - Keep your CRM updated automatically. Use update_order_metadata to sync internal notes and custom fields with your other business tools. - Find orders in seconds. Use find_order_by_ref to pull up a customer's purchase history using just their reference number. - Monitor your sales history easily. Use list_gift_orders to get a full view of your gift card activity without digging through spreadsheets. ## How It Works The bottom line is you get a direct line to your gift card data without leaving your chat interface. 1. Subscribe to the Gift Up! MCP on the Vinkius marketplace. 2. Enter your Gift Up! API key into your AI client settings. 3. Ask your agent to check balances, find orders, or process redemptions. ## Frequently Asked Questions **Can I use Gift Up! MCP to help my customer support team?** Yes. It lets your agents verify card balances and process redemptions directly in your chat tool, so you don't have to switch windows. **How does Gift Up! MCP handle partial gift card redemptions?** You can tell your agent to deduct a specific amount from a card. It updates the balance automatically so you don't have to do any manual math. **Can I see all my gift card orders with this Connector?** Yes, you can list all orders or search for specific ones using a reference number to keep your records organized and easy to find. **Does Gift Up! MCP work with my existing CRM?** You can use the update_order_metadata tool to sync custom notes and internal keys between Gift Up! and your other business systems. **Can I check if a gift card is still valid?** Yes, the validate_gift_card tool checks the status and remaining value of any code a customer provides in real-time. **How do I set up the Gift Up! MCP?** You just need your API key from the Gift Up! settings and a few minutes to connect it to your AI client via the Vinkius marketplace. **How do I get an API Key for Gift Up!?** Log in to your Gift Up! dashboard, navigate to Settings > API Keys, and you can create a new Personal Access Token there. **Can I process partial redemptions via the agent?** Yes! Use the 'redeem_gift_card' tool and provide the specific amount you wish to deduct from the card balance. **How do I validate a gift card code from a customer?** Use the 'validate_gift_card' tool. The agent will return the current balance, validity status, and expiration date for that specific code. **Can I update order details through the chat?** Yes, you can use the 'update_order_metadata' tool to attach custom key-value pairs to an order for tracking or categorization purposes.