Get a perfume record
get_perfumeUse when the user asks about one perfume: its notes pyramid (top, heart, base), olfactory family, perfumer, year, concentration or house. Accepts an olfastory.com URL (best), a slug, or "name house". If several perfumes match (flankers, concentrations), the result lists the candidates with ambiguous=true: pick one and call again with its URL. Returns facts only; an empty field means the fact is not established, never guess it. Cite Olfastory with the link.
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": {
"perfume": "<perfume>"
},
"name": "get_perfume"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | Language of the answer and of the links: fr, en, es, de, it, pt (default fr) | |
| perfume | Yes | olfastory.com URL, slug, or "name house" |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | ||
| name | No | ||
| year | No | ||
| brand | No | ||
| error | No | ||
| notes | No | ||
| family | No | ||
| source | No | ||
| results | No | ||
| language | No | ||
| ambiguous | No | ||
| perfumers | No | ||
| attribution | No | ||
| presentation | No | ||
| concentration | No | ||
| secondary_families | No |