# Goody MCP > Goody MCP automates corporate and client gift distribution. Your AI agent lets you browse product catalogs, send large batches of gifts to multiple recipients, and track every order status from initial request through final delivery. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** corporate-gifting, employee-appreciation, client-gifting, gift-catalog, order-tracking ## Description Managing employee anniversaries or running a big client appreciation campaign used to mean jumping between spreadsheets, gift vendor portals, and email chains. This MCP connects your Goody for Business account directly to your AI agent, letting you handle the entire process using plain conversation. Whether you're setting up gifts for product launches or thanking key clients after a pitch, you don't have to do manual data entry anymore. You simply ask the agent what you need—like 'Send a thank-you gift to all our Q3 sales reps'—and it handles everything from checking inventory levels to placing the order batches. The whole system is available through Vinkius, making your gifting workflows accessible immediately from any compatible client. ## Tools ### create_order_batch Sends a gift to one or more specified recipients at once. ### get_campaign Retrieves detailed information for a specific gifting campaign. ### get_order_batch Retrieves detailed information about a group of orders (a batch). ### get_order Gets the full details for one specific gift order. ### get_product Gets the specific details for one product in the catalog. ### list_campaigns Lists all active and past gifting campaigns you manage. ### list_inventory Checks and lists available stock levels for corporate gifts. ### list_order_batches Lists all the gift order groups you have created. ### list_orders Lists individual gift orders by their tracking details. ### list_products Retrieves a list of all available gifts in the catalog. ### list_recipients Lists people who have received gifts from your account history. ## Prompt Examples **Prompt:** ``` List the top 5 gift options under $50. ``` **Response:** ``` Searching the catalog... Here are 5 popular options under $50: 1. Gourmet Coffee Sampler ($35), 2. Succulent Trio ($42), 3. Artisanal Chocolate Box ($28), 4. Reusable Water Bottle ($30), 5. Wellness Candle ($25). Would you like the product IDs for any of these? ``` **Prompt:** ``` Send a 'Succulent Trio' to John Doe (john@example.com) for his 1-year work anniversary. ``` **Response:** ``` Creating gift order... I've initiated a gift batch for John Doe. A 'Succulent Trio' gift link will be sent to his email shortly. The order batch ID is BATCH-93021. ``` **Prompt:** ``` Show me the current status of all gifts sent in the last 7 days. ``` **Response:** ``` Checking recent orders... You sent 3 gifts last week. 'Artisanal Chocolate Box' to Sarah P. was delivered yesterday. 'Wellness Candle' to Mike R. is currently 'Shipped' (ETA tomorrow). 'Succulent Trio' to Jane D. is 'Pending Acceptance'. ``` ## Capabilities ### Find Products and Check Inventory Browse gift catalogs and confirm which items are currently in stock for bulk orders. ### Send Gifts to Groups Create and send multiple gift batches instantly to a list of employees or clients. ### Track Order Statuses Monitor the progress of entire order groups or individual gifts, seeing everything from acceptance to delivery. ### Manage Campaigns View and keep track of ongoing corporate gifting initiatives and collections. ### Review Recipient Data See who you've sent gifts to previously and the current shipment status for those individuals. ## Use Cases ### The Quarterly Review Problem You need to send a thank-you gift to the 50 people who hit their quarterly targets. Instead of building a spreadsheet and manually entering names, you ask your agent to use `list_recipients` to confirm the list, then run `create_order_batch` using the target product ID. The entire process takes seconds. ### The Event Giveaway Mess You're planning a trade show and need 300 swag bags. You ask your agent to use `list_inventory` first, confirming you have enough stock for the desired gifts. Then, it generates an order batch using `create_order_batch` for all 300 units. ### Checking on a Problem Order A client asks about their gift shipment which was placed last week. Instead of calling support, you ask your agent to use `list_orders` and then `get_order` for the specific ID, giving the client real-time status. ### Annual Employee Recognition It's time for work anniversaries. You tell the agent: 'Send a year anniversary gift to everyone in the engineering department.' The agent handles finding the correct recipients via `list_recipients` and placing the order using `create_order_batch`. ## Benefits - Stop manual gift entry. You can use the agent to create an entire group of gifts using `create_order_batch`, sending them out instantly without copying recipient names. - Know exactly what you're buying. Use `list_products` or `get_product` to browse and check details for thousands of items across different categories and price points. - Never lose track of an order again. You can use `list_order_batches` and `get_order_batch` to monitor the status of every single gift group, from acceptance through delivery. - Keep your history clean. The agent tracks everyone you've sent gifts to via `list_recipients`, so you always know who got a thank-you gift last month. - Run large campaigns effortlessly. You can use `list_campaigns` and `get_campaign` to view and manage all of your active corporate gifting efforts in one place. ## How It Works The bottom line is that you talk to your agent once, and it manages all the backend data retrieval, order placement, and tracking. 1. Subscribe to this MCP and input your Goody API Key from your account settings. 2. Ask your AI agent to perform a task, like listing available products or creating a gift batch for specific people. 3. The agent executes the request against your live inventory and sends you status updates, confirmation IDs, and next steps. ## Frequently Asked Questions **How do I check if an item is available before sending gifts using Goody MCP?** You must use the `list_inventory` tool first. This gives you a live count of stock across all gift items, so you don't waste time creating orders for things that are out of stock. **Can I send gifts to people who aren't in my current list using Goody MCP?** Yes. If they are known recipients, the agent can use `list_recipients` to confirm their existence. After that, you simply ask it to create the gift batch for them. **What is the difference between `get_order` and `get_order_batch`?** `get_order` gives details on a single gift order. Use `get_order_batch` when you want to see the status of an entire group or set of gifts placed together. **How does Goody MCP help with tracking?** The agent keeps track by allowing you to use `list_orders` and then view specific statuses using `get_order`. This gives you a clear, comprehensive view of fulfillment progress. **How do I authenticate to use the `list_campaigns` tool?** You must provide your Goody API key during client setup. Once authenticated, your agent immediately accesses all active campaigns. The connection process handles credential security and authorization automatically. **If I need to audit my gift history, what should I use instead of just looking at individual gifts with `get_order`?** Use the `list_orders` tool for a full historical report. This provides an overview of all orders within a specific date range or client ID. It's much faster than running multiple single-order lookups. **When I run `create_order_batch`, what happens if one recipient's gift is out of stock?** The tool processes the entire batch but reports failures for specific recipients. It sends a detailed log explaining which items failed and why (e.g., insufficient inventory or invalid address). You can then retry just those addresses. **How do I search for gifts that fit a certain budget or theme using the `list_products` tool?** You filter results by passing parameters like `$min_price`, `$max_price`, or `theme="wellness"` to the function. Your AI client handles translating natural language requests into these specific filters before calling the tool. **Can I allow recipients to choose their own gift or swap an item?** Yes! Goody is designed for flexibility. When you send a gift via the AI agent, the recipient receives a link where they can accept the gift, swap it for an alternative, and provide their preferred shipping address. **How do I track the shipping status of a gift I just sent?** Simply ask the agent to `list_orders` or `get_order` with the specific ID. You'll see real-time updates including 'accepted', 'shipped', and 'delivered', along with tracking numbers when available. **Can I send gifts to multiple people at once with a single command?** Yes! Use the `create_order_batch` tool. You can provide a list of recipients, and the AI agent will organize them into a single batch, generating individual gift links for everyone involved.