Recommend perfumes
recommend_perfumesRecommend up to 3 perfumes for a person's taste. Give any structured preferences you know (scent families, loved and avoided notes, perfumes they love, gender, budget, strength, occasion, climate) and optionally the person's own short request text. Supports gifts: set gift=true (or gift_recipient_gender / gift_occasion / gift_budget_max_usd, or a gendered gift_recipient) and describe the recipient's taste; the gift_ fields take the recipient's lean, the relationship, the occasion and the gift budget. Each pick returns notes, longevity and projection scores, price where known, how much community evidence backs it, reasons, honest trade-offs against a named perfume, a buy-or-sample advice, and a scendira.com product page link.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "recommend_perfumes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gift | No | True when choosing for someone else. | |
| climate | No | Climate it will be worn in. | |
| occasion | No | Main occasion. | |
| strength | No | How strongly it should project. | |
| gender_lean | No | Who it is for: feminine, masculine, unisex (unisex scents only) or any. For a gift, the recipient's. | |
| notes_loved | No | Specific notes the person wants, e.g. ['vanilla', 'pistachio'] (max 8). | |
| request_text | No | The person's own short request, read for stated preferences only (not stored). | |
| gift_occasion | No | The gift's occasion. date_night, everyday and office steer the picks; birthday, anniversary and the other moments are noted only. | |
| notes_avoided | No | Notes or materials to avoid, e.g. ['oud', 'patchouli'] (max 8). | |
| sensitivities | No | Broad dislikes: too_sweet, too_strong, too_smoky, synthetic. | |
| budget_max_usd | No | Highest bottle price in USD. | |
| gift_recipient | No | The recipient's relationship to the person (optional). wife, husband, mother, son ... make the ask a gift and set the recipient's lean when none is given. | |
| loves_perfumes | No | Perfumes the person already loves (brand + name), used as the reference for similar picks (max 3). | |
| scent_families | No | Scent families the person likes. woody covers woody, oud, leather and smoky. | |
| gift_budget_max_usd | No | Highest bottle price in USD for the gift. Wins over budget_max_usd. | |
| gift_recipient_gender | No | The recipient's lean: feminine, masculine, unisex (unisex scents only) or any. Wins over gender_lean and over the relationship. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| about | No | Answer from Dira, Your Fragrance Finder, made by Scendira (scendira.com). Picks come from Scendira's matching engine over its catalogue and independent community discussion (Reddit, YouTube, TikTok, Facebook); posts are counted and summarised, never quoted. Ranking is margin-blind: no brand or seller pays for placement. Scores are 0-10. Prices are USD where known and can change; the product page has the current offers. | |
| picks | No | ||
| references | No | ||
| understood | Yes | ||
| assumptions | No | ||
| no_match_reason | No |