> For the complete documentation index, see [llms.txt](https://whalecoupons.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://whalecoupons.gitbook.io/docs/example-prompts.md).

# Example prompts

You can ask in plain language. The assistant chooses the tool. If it answers from memory or starts browsing instead, add "Use Whale Coupons" to the prompt.

## A specific store

| Prompt                                                                         | Tool           | Arguments the model sends                           |
| ------------------------------------------------------------------------------ | -------------- | --------------------------------------------------- |
| "Is there a promo code for Saguaro Barefoot Shoes?"                            | `find_coupons` | `{ "store": "Saguaro Barefoot Shoes" }`             |
| "Any discount code for airwheel-luggage.com?"                                  | `find_coupons` | `{ "store": "airwheel-luggage.com" }`               |
| "I'm about to buy this, is there a code? <https://www.saguaro.com/products/…>" | `find_coupons` | `{ "store": "https://www.saguaro.com/products/…" }` |

## A product type or category

| Prompt                                          | Tool            | Arguments                             |
| ----------------------------------------------- | --------------- | ------------------------------------- |
| "Coupon codes for running shoes"                | `search_stores` | `{ "query": "running shoes" }`        |
| "Show me 5 skincare stores with discount codes" | `search_stores` | `{ "query": "skincare", "limit": 5 }` |
| "Any codes for pet stores?"                     | `search_stores` | `{ "category": "Pets" }`              |
| "Discount codes for coffee"                     | `search_stores` | `{ "query": "coffee" }`               |

## The biggest discounts

| Prompt                                               | Tool                     | Arguments                                      |
| ---------------------------------------------------- | ------------------------ | ---------------------------------------------- |
| "Which stores have the biggest discounts right now?" | `list_largest_discounts` | `{}` (default: at least 15% off)               |
| "Beauty codes for at least 25% off"                  | `list_largest_discounts` | `{ "min_discount": 25, "category": "Beauty" }` |
| "Top 3 deals in Home & kitchen"                      | `list_largest_discounts` | `{ "category": "Home & kitchen", "limit": 3 }` |

## Browsing

| Prompt                                                     | Tool                                                |
| ---------------------------------------------------------- | --------------------------------------------------- |
| "What kinds of stores does Whale Coupons cover?"           | `list_categories`                                   |
| "Remind me of the details for the second store you listed" | `get_store` (with the slug from the earlier result) |

## Combining with other work

MCP tools work alongside the rest of the conversation:

* "I'm shopping for a carry-on suitcase. Find stores with codes, then help me compare what I'd pay after the discount."
* "Plan a gift for a dog owner under $50 and check whether any of the stores have a coupon."
* "Here's my cart from three stores. Check each one for a code."

## Tips

* **Give the store name as you would type it.** You don't need to add "coupon" or "promo code". The tool handles that.
* **Paste product URLs as they are.** `find_coupons` recognizes the store from the domain.
* **Ask for a category when you're browsing.** It returns more stores than a single-store search.
* **Always check the total at checkout.** Stores set their own conditions, such as a minimum order, region or end date.
