Find perfumes by notes
find_perfumes_by_notesUse when the user wants perfumes that contain given notes or raw materials (1 to 5, for example vanilla and tobacco), optionally in the top, heart or base. Note names are accepted in French, English, Spanish, German, Italian or Portuguese. Optional filters: olfactory family (primary or secondary, for example "woody"), concentration and gender (women, men, unisex, children). Returns at most 10 perfumes carrying every note, most consulted first, with olfastory.com links. An unknown note returns close suggestions to retry with. Cite Olfastory.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"notes": "<notes>"
},
"name": "find_perfumes_by_notes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | Language of the answer and of the links: fr, en, es, de, it, pt (default fr) | |
| notes | Yes | ||
| family | No | Optional olfactory family, primary or secondary, in any of the six languages (for example "woody", "floral", "chypre") | |
| gender | No | Optional gender filter: women, men, unisex or children. "women" and "men" also return unisex perfumes; perfumes with no recorded gender are left out | |
| position | No | ||
| concentration | No | Optional concentration filter, for example "Eau de Parfum", "EDT", "Extrait" |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | ||
| results | Yes | ||
| ambiguous | No | ||
| suggestions | No | ||
| unknown_notes | No | ||
| corrected_query | No |