# Brilliant Made MCP

> Brilliant Made manages your corporate swag and gifting programs directly through your AI agent. It lets you list all current orders, check real-time product inventory levels, browse custom merchandise catalogs, create gift cards for employees, and even cancel pending shipments—all in natural conversation.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** corporate-gifting, swag-management, order-fulfillment, inventory-tracking, merchandise-logistics, procurement

## Description

Managing company gifts used to mean jumping between a dozen tabs: one for stock counts, another for open orders, and yet another just to see which products were available. Now you can talk to your agent about swag management. You tell it what you need—like checking if you have enough branded hoodies for the Q3 kickoff, or seeing every order that shipped last week. It gets you the data instantly. Want to reward a client? You can generate and assign gift cards right from your chat interface. Need to stop a shipment because the wrong address was entered? The system handles cancellations on pending orders. Vinkius hosts this connection so whether you're working in VS Code, Cursor, or Claude, you get one centralized place to run your entire merchandising operation.

## Tools

### cancel_order
Cancels an existing swag merchandise order.

### create_gift_card
Generates a new storefront gift card for rewards or purchases.

### create_order
Places a completely new swag order with specified products and quantities.

### get_inventory_status
Retrieves the current, real-time stock count for all available merchandise products.

### get_order
Fetches detailed information on one specific swag order using its ID number.

### get_product_variant
Gets the specific details, like color and size, for a single product type.

### list_fulfillment_orders
Lists all orders currently being processed through the fulfillment center.

### list_gift_cards
Retrieves a list of all existing gift cards in the store's system.

### list_orders
Lists every swag order placed through the platform, regardless of status.

### list_products
Retrieves a complete list of all merchandise available in the storefront catalog.

## Prompt Examples

**Prompt:** 
```
List all my recent swag orders in Brilliant Made.
```

**Response:** 
```
I've retrieved your orders. You have 3 recent orders, including Order #1001 (Status: Shipped) and Order #1005 (Status: Processing). Would you like to see the tracking info for any of them?
```

**Prompt:** 
```
Show the current inventory status for all products.
```

**Response:** 
```
Retrieving inventory... You have 'Branded Hoodie' (Stock: 150), 'Custom Mug' (Stock: 80), and 'Logo Sticker Pack' (Stock: 500) available.
```

**Prompt:** 
```
Get details for product variant var_123.
```

**Response:** 
```
Variant var_123 is the 'Blue / Large' version of the Branded Hoodie. Its current price is $45.00 and it is in stock.
```

## Capabilities

### Check live stock levels
Get an immediate count of available merchandise across all product types.

### Review and track orders
See a full list of every swag order, checking its current fulfillment status or retrieving details on specific past orders.

### Manage gift card rewards
List existing gift cards or generate new ones for employees and clients.

### Place or cancel shipments
Create a brand-new swag order, or stop an order that hasn't shipped yet.

## Use Cases

### The New Hire Onboarding Check
An HR manager needs 50 welcome kits. Instead of checking stock sheet by sheet, they ask their agent to check inventory status for the specific items and list products to confirm variants are available before placing a massive new order using create_order.

### The Event Day Panic
A marketing team realizes they need 10 more customized mugs. They immediately ask their agent to get the product variant details and check inventory status for that specific item before telling ops to place an emergency order using create_order.

### The Failed Shipment
An operations lead notices a mistake on a shipment destined for a client. They use their agent to get the details of the affected order and immediately cancel_order before the package leaves the facility, logging the incident in one place.

### The Annual Bonus Program
An HR manager needs to reward 100 employees. They use their agent to list gift cards first, then create new ones for each employee and record the assignment using create_gift_card.

## Benefits

- Instead of manually checking inventory dashboards, you can ask your agent to check real-time stock levels for all products. This immediate feedback helps you plan events without running out of key items.
- Need to know what's shipped? You can use the list_fulfillment_orders tool to see every order currently moving through the warehouse. It keeps fulfillment tracking centralized and fast.
- When a client needs a reward, you don't need a dedicated finance person; your agent handles creating and assigning new gift cards instantly via create_gift_card.
- If an address changes or an item is ordered wrong, you can use cancel_order to stop pending shipments right from your chat window. It saves time and prevents unnecessary costs.
- You don't have to guess what products are available; list_products gives you a complete rundown of the entire catalog, helping you plan future swag themes.

## How It Works

The bottom line is you run complex merchandising tasks using only chat prompts and conversational logic.

1. Subscribe to this MCP and input your Brilliant Made API key.
2. Your AI agent connects the service credentials, giving it access to your swag platform data.
3. You ask a question in plain language—for example, 'What's our stock of mugs?'—and get the answer immediately.

## Frequently Asked Questions

**How do I check inventory status using get_inventory_status?**
You ask the agent directly: 'What is our current stock level for branded mugs?' It retrieves real-time data, so you always know if a product can be ordered right now.

**Can I create an order using create_order?**
Yes. You tell the agent what items and how many you need. The tool places the new swag order into your system, kicking off the fulfillment process immediately.

**What is list_orders for?**
list_orders gives you a master list of every single order ever placed in your account. It helps you audit historical data quickly without knowing the specific ID number.

**How does cancel_order work?**
You use cancel_order when an order hasn't shipped yet and needs to be stopped. This prevents fulfillment costs and ensures the inventory records are updated correctly.

**If I need to check product details, what should I use for get_product_variant?**
Use the `get_product_variant` tool. This function pulls specific metadata for a single item variant, like color or size, which is useful if you only know the SKU number.

**How do I list all available products in the store using list_products?**
The `list_products` tool provides an overview of every product type sold. It helps you see general categories and names, which is necessary before checking specific inventory levels.

**When should I use get_order to check a specific order's status?**
Use `get_order` when you have an order ID. It gives full details on one single fulfillment request, including its current processing status and shipping information.

**What is the process for listing gift cards using list_gift_cards?**
The `list_gift_cards` tool fetches all existing storefront gift cards. You use this to audit which reward codes have been created and assigned to employees or clients.

**Can I check if a specific swag item is in stock?**
Yes! Use the `get_inventory_status` tool. Your agent will fetch the real-time stock levels for all products in your Brilliant Made store.

**How do I see the fulfillment status of my last order?**
Simply ask the agent to `get_order` and provide the Order ID. It will retrieve the current status, such as 'processing', 'shipped', or 'delivered', directly from Brilliant Made.

**Does the integration allow creating a new gift card?**
Yes. Use the `create_gift_card` action and provide the amount. The card will be generated in your storefront and can then be assigned to a recipient.