# Giftpack MCP MCP

> Giftpack MCP lets your AI agent manage every detail of corporate gifting, from planning large employee recognition campaigns to tracking individual package deliveries globally. Stop using spreadsheets for gift logistics; use this MCP to automate catalog searches, create recipient profiles, and monitor fulfillment status through conversation.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** corporate-gifting, employee-recognition, personalized-gifts, campaign-management, logistics-tracking, client-relations

## Description

Managing company gifts used to be a nightmare of scattered emails, multiple dashboards, and endless manual cross-referencing. Now, you connect Giftpack to your preferred agent via Vinkius. Your AI acts as a dedicated gifting coordinator, handling everything in natural language. Need to launch a welcome kit for new hires? Simply ask the agent to `create_campaign` and specify the criteria. The system handles selecting items from millions of catalog options using `search_gift_catalog`, building campaigns, and even sending out gifts via `trigger_gift_send`. You can also manage your employee data by adding recipients with `create_recipient` or checking their history through dedicated tools. If you need to know if a batch order shipped last week is actually in transit, the agent uses `get_order_fulfillment_status` to give you real-time tracking details. It gives you total control over recognition and client relations without ever opening an email thread.

## Tools

### create_campaign
Starts a new corporate gift campaign using required title and details.

### trigger_gift_send
Sends a specific gift product to a chosen recipient immediately.

### create_recipient
Adds a person to your gifting roster with just their name and email address.

### get_campaign_statistics
Pulls key metrics and analytics for an existing gift campaign.

### get_order_fulfillment_status
Checks the current shipping status of a specific gift order.

### get_product_details
Retrieves full specifications and costs for any single product in the catalog.

### get_recipient_details
Fetches all known information, including gifting history, about a specific person.

### list_gifting_campaigns
Lists every campaign you have set up in your account.

### list_gift_orders
Retrieves a list of all recent and pending gift orders placed through the system.

### list_recipients
Generates a list of all people currently saved as recipients in the system.

### list_active_webhooks
Lists any active event webhooks set up for gift tracking or notifications.

### search_gift_catalog
Searches the entire gift catalog using keywords, categories, or regions.

## Prompt Examples

**Prompt:** 
```
List all active gifting campaigns in my Giftpack account.
```

**Response:** 
```
I've retrieved your active campaigns. You have 2 drives running: 'New Hire Welcome 2026' (ID: camp_123) and 'Global Client Rewards' (ID: camp_456). Would you like the engagement stats for either of these?
```

**Prompt:** 
```
Send a 'Wellness Kit' to Jane Doe (ID: rec_789).
```

**Response:** 
```
Gifting triggered! I've initiated a new order for Jane Doe (ID: rec_789) with the product 'Wellness Kit' (ID: prod_001). The order ID is 'ord_101'. I'll alert you as soon as the fulfillment status changes.
```

**Prompt:** 
```
Check the delivery status of order 'ord_101'.
```

**Response:** 
```
Tracking order ord_101... The gift is currently 'In Transit' via FedEx and is expected to arrive at the recipient's location in London by tomorrow. Here is the tracking link: [link].
```

## Capabilities

### Create New Gifting Drives
Initiates a new corporate gift campaign with specific goals, titles, and scope.

### Track Order Status
Checks the current location and expected delivery date for any placed gift order.

### Find Products by Criteria
Searches millions of available gifts using keywords, categories, or geographical restrictions.

### Manage Recipient Records
Adds new people to the gifting roster and retrieves their complete history with your company.

### View Campaign Analytics
Retrieves performance metrics, including engagement rates and fulfillment totals for a specific campaign.

## Use Cases

### Tracking a Missing Shipment
A client asks: 'Where is the gift for Jane Doe?' The agent uses `get_order_fulfillment_status` to check the shipping carrier, reports it's stuck in customs, and tells you exactly what needs follow-up.

### Launching an Anniversary Program
The Marketing Lead asks: 'Set up a 5-year work anniversary campaign for all employees.' The agent uses `list_recipients` to get the list, then runs `create_campaign`, and populates the roster.

### Finding a Replacement Gift
The Sales team needs a thank-you gift under $50 for a West Coast client. Instead of manually browsing, they ask the agent to `search_gift_catalog`, and it returns immediate, filtered options.

### Onboarding New Teams
The HR Manager needs to process 20 new hires. She uses `create_recipient` for each person's name and email, then runs `trigger_gift_send` to get the welcome kits shipped out automatically.

## Benefits

- Stop manually checking spreadsheets for delivery status. Use `get_order_fulfillment_status` to track a gift order's location in real time, giving you confidence the package arrives when promised.
- Never start a campaign from scratch. You can use `list_gifting_campaigns` and then run `get_campaign_statistics` to see exactly where your outreach efforts are succeeding or failing.
- Finding the right gift used to take hours of browsing. Now, simply ask the agent to `search_gift_catalog`, filtering by region or budget, and instantly narrow down millions of options.
- When a new client signs on, you can't wait for an HR team member. Use `trigger_gift_send` immediately, specifying a product, and send the welcome gift right away.
- Maintain accurate relationship data by using `get_recipient_details`. This tool lets your agent pull a person's entire gifting history in one go, ensuring personalized follow-up.

## How It Works

The bottom line is, you tell your agent what you need done in plain English, and it handles the complex tool calls behind the scenes.

1. Subscribe to the Giftpack MCP on Vinkius. Then, pull your API Key from your Giftpack account settings.
2. Connect your AI client (like Cursor or Claude) and authorize access using that API key.
3. Start by giving a natural language instruction—for example: 'List all active gifting campaigns'—and the agent executes the necessary tools.

## Frequently Asked Questions

**How do I check if a gift is ready to ship with get_order_fulfillment_status?**
The agent checks the current status and provides expected delivery dates. If it shows 'Ready for Shipment,' that means all internal fulfillment steps are complete, and it's awaiting carrier pickup.

**Can I see what gifts were sent to a specific person using get_recipient_details?**
Yes. The agent pulls the recipient's full history from Giftpack, showing every product they’ve received and when it was ordered.

**What is the best tool for starting an employee recognition campaign? Is it create_campaign?**
Yep. You use `create_campaign` to initialize the drive. This function requires you to provide a title and general details, setting up the structure before you add specific gifts or recipients.

**How do I find gift ideas if I don't know the category? Should I use search_gift_catalog?**
Yes, `search_gift_catalog` is designed for this. You can query it using keywords or regions to narrow down options when you don't have a specific filter.

**How can I view all my current gifting initiatives using list_gifting_campaigns?**
It provides a complete roster of your drives. This tool gives you an overview of every campaign, which is helpful for auditing and reporting on multiple initiatives at once.

**When I use create_recipient, what data fields are required to add a new contact?**
You must provide a name and an email. These two fields are mandatory for the system to correctly profile the person and ensure successful communication records.

**Do I need to use list_gift_orders if I want a bulk view of recent shipments?**
Yes, list_gift_orders retrieves multiple order records. This is better than checking individual statuses because it gives you a quick, comprehensive view of everything recently placed.

**How do I verify that my external systems are connected using list_active_webhooks?**
The tool lists all currently active webhooks. You can use this to confirm that your external systems are correctly set up to receive real-time event notifications from Giftpack.

**How do I find my Giftpack API Key?**
Log in to your Giftpack business dashboard and navigate to the **Settings** or **API** section to generate your unique key.

**Can I search for gifts in a specific region?**
Yes! The `search_gift_catalog` tool allows you to include regional filters in your query to find products available for specific countries.

**How do I track the delivery status of a gift?**
Use the `get_order_fulfillment_status` tool with the unique order ID to retrieve real-time shipping updates and tracking links.