10ML Perfume Finder

Get perfume profile

get_perfume

Read-onlyIdempotent

The full Fragrance Index profile of one perfume, cologne or fragrance: house, launch year, audience, concentration, family, accords, note pyramid (top, heart and base notes), best seasons and occasions, longevity, projection and perfumers (full profiles), the editors' character description, five similar perfumes, editorial alternatives from other houses when they exist, related 10ML guides and links. Use when you know which perfume is meant and need facts about it ('tell me about Aventus', 'what notes are in Delina', 'what does Baccarat Rouge 540 smell like'). Not for browsing (use search_perfumes), not for comparing two or more (use compare_perfumes). Unknown names return the closest matches.

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
`house`	No	House, when the name alone is ambiguous. Example: "Creed"
`locale`	No	Language of the 10ml.com links and labels.	en
`perfume`	Yes	A perfume by name, optionally with its house, e.g. "Baccarat Rouge 540", "Dior Sauvage", "Delina". An id from another tool also works, e.g. "creed-aventus".
`response_format`	No	concise (default) or detailed (adds pyramid, seasons, occasions, longevity).	concise

Output Schema

Name	Required	Description	Default
`exact`	Yes
`found`	Yes
`guides`	No
`source`	Yes
`message`	No
`perfume`	No
`similar`	No
`house_info`	No
`suggestions`	No
`alternatives`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 22, 2026

changedInput schema / properties / locale / enum

Previous value: -[
-  "en",
-  "de",
-  "fr",
-  "es",
-  "it",
-  "ro",
-  "el",
-  "hu",
-  "cs",
-  "pl",
-  "nl"
-]New value: +[
+  "en",
+  "de",
+  "fr",
+  "es",
+  "it",
+  "ro",
+  "el",
+  "hu",
+  "cs",
+  "pl",
+  "nl",
+  "pt",
+  "sv",
+  "da",
+  "fi",
+  "bg",
+  "hr"
+]

Changed1 schema field changedOct 21, 2026

changedInput schema / properties / locale / enum

Previous value: -[
-  "en",
-  "de",
-  "fr",
-  "es",
-  "it",
-  "ro",
-  "el",
-  "hu",
-  "cs",
-  "pl"
-]New value: +[
+  "en",
+  "de",
+  "fr",
+  "es",
+  "it",
+  "ro",
+  "el",
+  "hu",
+  "cs",
+  "pl",
+  "nl"
+]

Changed16 schema fields changedOct 21, 2026

changedInput schema / properties / locale / description

Previous value: -"Language of the 10ml.com links and labels. Perfume, house and note names stay as they are."New value: +"Language of the 10ml.com links and labels."

changedInput schema / properties / response_format / description

Previous value: -"concise (default) or detailed (adds note pyramid, seasons, occasions, longevity, projection)."New value: +"concise (default) or detailed (adds pyramid, seasons, occasions, longevity)."

removedOutput schema / $defs

Removed value: -{
-  "d1": {
-    "items": {
-      "properties": {
-        "title": {
-          "type": "string"
-        },
-        "type": {
-          "enum": [
-            "try",
-            "guide",
-            "note"
-          ],
-          "type": "string"
-        },
-        "url": {
-          "type": "string"
-        }
-      },
-      "required": [
-        "type",
-        "title",
-        "url"
-      ],
-      "type": "object"
-    },
-    "type": "array"
-  }
-}

removedOutput schema / properties / alternatives / items / properties

Removed value: -{
-  "closeness": {
-    "enum": [
-      "very close",
-      "similar vibe",
-      "same spirit"
-    ],
-    "type": "string"
-  },
-  "house": {
-    "type": "string"
-  },
-  "id": {
-    "type": "string"
-  },
-  "name": {
-    "type": "string"
-  },
-  "why": {
-    "type": "string"
-  }
-}

removedOutput schema / properties / alternatives / items / required
```
Removed value: -[
-  "name",
-  "closeness",
-  "why"
-]
```
removedOutput schema / properties / guides / $ref
```
Removed value: -"#/$defs/d1"
```
addedOutput schema / properties / guides / items
```
Added value: +{
+  "type": "object"
+}
```
addedOutput schema / properties / guides / type
```
Added value: +"array"
```

removedOutput schema / properties / house_info / properties

Removed value: -{
-  "country": {
-    "type": "string"
-  },
-  "name": {
-    "type": "string"
-  },
-  "style": {
-    "type": "string"
-  },
-  "type": {
-    "type": "string"
-  }
-}

removedOutput schema / properties / house_info / required
```
Removed value: -[
-  "name",
-  "type",
-  "style"
-]
```

removedOutput schema / properties / perfume / properties

Removed value: -{
-  "accords": {
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "character": {
-    "type": "string"
-  },
-  "concentration": {
-    "type": "string"
-  },
-  "family": {
-    "type": "string"
-  },
-  "gender": {
-    "enum": [
-      "men",
-      "women",
-      "unisex"
-    ],
-    "type": "string"
-  },
-  "house": {
-    "type": "string"
-  },
-  "id": {
-    "type": "string"
-  },
-  "key_notes": {
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "links": {
-    "$ref": "#/$defs/d1"
-  },
-  "longevity": {
-    "type": "number"
-  },
-  "name": {
-    "type": "string"
-  },
-  "occasions": {
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "other_versions": {
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "perfumers": {
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "profile": {
-    "enum": [
-      "full",
-      "core"
-    ],
-    "type": "string"
-  },
-  "projection": {
-    "type": "number"
-  },
-  "pyramid": {
-    "properties": {
-      "base": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "heart": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "top": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "top",
-      "heart",
-      "base"
-    ],
-    "type": "object"
-  },
-  "seasons": {
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "styles": {
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "year": {
-    "type": "number"
-  }
-}

removedOutput schema / properties / perfume / required

Removed value: -[
-  "id",
-  "name",
-  "house",
-  "gender",
-  "family",
-  "accords",
-  "key_notes",
-  "character",
-  "links",
-  "profile"
-]

removedOutput schema / properties / similar / items / properties

Removed value: -{
-  "closeness": {
-    "enum": [
-      "very close",
-      "similar vibe",
-      "same spirit"
-    ],
-    "type": "string"
-  },
-  "house": {
-    "type": "string"
-  },
-  "id": {
-    "type": "string"
-  },
-  "name": {
-    "type": "string"
-  },
-  "shared_notes": {
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "url": {
-    "type": "string"
-  }
-}

removedOutput schema / properties / similar / items / required

Removed value: -[
-  "id",
-  "name",
-  "house",
-  "closeness",
-  "shared_notes",
-  "url"
-]

removedOutput schema / properties / suggestions / items / properties

Removed value: -{
-  "accords": {
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "character": {
-    "type": "string"
-  },
-  "concentration": {
-    "type": "string"
-  },
-  "family": {
-    "type": "string"
-  },
-  "gender": {
-    "enum": [
-      "men",
-      "women",
-      "unisex"
-    ],
-    "type": "string"
-  },
-  "house": {
-    "type": "string"
-  },
-  "id": {
-    "type": "string"
-  },
-  "key_notes": {
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "links": {
-    "$ref": "#/$defs/d1"
-  },
-  "longevity": {
-    "type": "number"
-  },
-  "name": {
-    "type": "string"
-  },
-  "occasions": {
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "other_versions": {
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "perfumers": {
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "profile": {
-    "enum": [
-      "full",
-      "core"
-    ],
-    "type": "string"
-  },
-  "projection": {
-    "type": "number"
-  },
-  "pyramid": {
-    "properties": {
-      "base": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "heart": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "top": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "top",
-      "heart",
-      "base"
-    ],
-    "type": "object"
-  },
-  "seasons": {
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "styles": {
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "year": {
-    "type": "number"
-  }
-}

removedOutput schema / properties / suggestions / items / required

Removed value: -[
-  "id",
-  "name",
-  "house",
-  "gender",
-  "family",
-  "accords",
-  "key_notes",
-  "character",
-  "links",
-  "profile"
-]

Changed31 schema fields changedOct 20, 2026

addedOutput schema / $defs

Added value: +{
+  "d1": {
+    "items": {
+      "properties": {
+        "title": {
+          "type": "string"
+        },
+        "type": {
+          "enum": [
+            "try",
+            "guide",
+            "note"
+          ],
+          "type": "string"
+        },
+        "url": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "type",
+        "title",
+        "url"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  }
+}

removedOutput schema / properties / exact / description

Removed value: -"False when this is a closest-match guess"

addedOutput schema / properties / guides / $ref
```
Added value: +"#/$defs/d1"
```

removedOutput schema / properties / guides / items

Removed value: -{
-  "properties": {
-    "title": {
-      "type": "string"
-    },
-    "type": {
-      "enum": [
-        "try",
-        "guide",
-        "note"
-      ],
-      "type": "string"
-    },
-    "url": {
-      "description": "A 10ml.com link in the requested locale",
-      "type": "string"
-    }
-  },
-  "required": [
-    "type",
-    "title",
-    "url"
-  ],
-  "type": "object"
-}

removedOutput schema / properties / guides / type
```
Removed value: -"array"
```
removedOutput schema / properties / perfume / properties / accords / description
```
Removed value: -"Main accords, strongest first"
```
removedOutput schema / properties / perfume / properties / character / description
```
Removed value: -"One-sentence description by 10ML's fragrance editors"
```
removedOutput schema / properties / perfume / properties / family / description
```
Removed value: -"Fragrance family, e.g. \"amber floral\""
```

removedOutput schema / properties / perfume / properties / id / description

Removed value: -"Stable Fragrance Index id, usable with get_perfume and find_similar_perfumes"

removedOutput schema / properties / perfume / properties / key_notes / description
```
Removed value: -"The defining notes (empty when no pyramid is published)"
```
addedOutput schema / properties / perfume / properties / links / $ref
```
Added value: +"#/$defs/d1"
```
removedOutput schema / properties / perfume / properties / links / description
```
Removed value: -"1-3 relevant 10ml.com links"
```

removedOutput schema / properties / perfume / properties / links / items

Removed value: -{
-  "properties": {
-    "title": {
-      "type": "string"
-    },
-    "type": {
-      "enum": [
-        "try",
-        "guide",
-        "note"
-      ],
-      "type": "string"
-    },
-    "url": {
-      "description": "A 10ml.com link in the requested locale",
-      "type": "string"
-    }
-  },
-  "required": [
-    "type",
-    "title",
-    "url"
-  ],
-  "type": "object"
-}

removedOutput schema / properties / perfume / properties / links / type
```
Removed value: -"array"
```
removedOutput schema / properties / perfume / properties / longevity / description
```
Removed value: -"1 (short) to 5 (very long)"
```

removedOutput schema / properties / perfume / properties / other_versions / description

Removed value: -"Ids of other concentrations or flankers of the same perfume in the index"

removedOutput schema / properties / perfume / properties / projection / description
```
Removed value: -"1 (skin scent) to 5 (fills a room)"
```
removedOutput schema / properties / perfume / properties / year / description
```
Removed value: -"Launch year when known"
```
removedOutput schema / properties / suggestions / items / properties / accords / description
```
Removed value: -"Main accords, strongest first"
```
removedOutput schema / properties / suggestions / items / properties / character / description
```
Removed value: -"One-sentence description by 10ML's fragrance editors"
```
removedOutput schema / properties / suggestions / items / properties / family / description
```
Removed value: -"Fragrance family, e.g. \"amber floral\""
```

removedOutput schema / properties / suggestions / items / properties / id / description

Removed value: -"Stable Fragrance Index id, usable with get_perfume and find_similar_perfumes"

removedOutput schema / properties / suggestions / items / properties / key_notes / description
```
Removed value: -"The defining notes (empty when no pyramid is published)"
```
addedOutput schema / properties / suggestions / items / properties / links / $ref
```
Added value: +"#/$defs/d1"
```
removedOutput schema / properties / suggestions / items / properties / links / description
```
Removed value: -"1-3 relevant 10ml.com links"
```

removedOutput schema / properties / suggestions / items / properties / links / items

Removed value: -{
-  "properties": {
-    "title": {
-      "type": "string"
-    },
-    "type": {
-      "enum": [
-        "try",
-        "guide",
-        "note"
-      ],
-      "type": "string"
-    },
-    "url": {
-      "description": "A 10ml.com link in the requested locale",
-      "type": "string"
-    }
-  },
-  "required": [
-    "type",
-    "title",
-    "url"
-  ],
-  "type": "object"
-}

removedOutput schema / properties / suggestions / items / properties / links / type
```
Removed value: -"array"
```
removedOutput schema / properties / suggestions / items / properties / longevity / description
```
Removed value: -"1 (short) to 5 (very long)"
```
removedOutput schema / properties / suggestions / items / properties / other_versions / description
```
Removed value: -"Ids of other concentrations or flankers of the same perfume in the index"
```
removedOutput schema / properties / suggestions / items / properties / projection / description
```
Removed value: -"1 (skin scent) to 5 (fills a room)"
```
removedOutput schema / properties / suggestions / items / properties / year / description
```
Removed value: -"Launch year when known"
```

Changed4 schema fields changedOct 20, 2026

addedOutput schema / properties / perfume / properties / profile

Added value: +{
+  "enum": [
+    "full",
+    "core"
+  ],
+  "type": "string"
+}

changedOutput schema / properties / perfume / required

Previous value: -[
-  "id",
-  "name",
-  "house",
-  "gender",
-  "family",
-  "accords",
-  "key_notes",
-  "character",
-  "links"
-]New value: +[
+  "id",
+  "name",
+  "house",
+  "gender",
+  "family",
+  "accords",
+  "key_notes",
+  "character",
+  "links",
+  "profile"
+]

addedOutput schema / properties / suggestions / items / properties / profile

Added value: +{
+  "enum": [
+    "full",
+    "core"
+  ],
+  "type": "string"
+}

changedOutput schema / properties / suggestions / items / required

Previous value: -[
-  "id",
-  "name",
-  "house",
-  "gender",
-  "family",
-  "accords",
-  "key_notes",
-  "character",
-  "links"
-]New value: +[
+  "id",
+  "name",
+  "house",
+  "gender",
+  "family",
+  "accords",
+  "key_notes",
+  "character",
+  "links",
+  "profile"
+]

Changed15 schema fields changedOct 19, 2026
- removedInput schema / $schema
```
Removed value: -"http://json-schema.org/draft-07/schema#"
```
- changedInput schema / properties / locale / description
```
Previous value: -"Language of the 10ml.com links and fixed labels: en, de, fr, es, it, ro, el, hu, cs or pl. Perfume, house and note names are never translated."New value: +"Language of the 10ml.com links and labels. Perfume, house and note names stay as they are."
```
- changedInput schema / properties / response_format / description
```
Previous value: -"concise (default): the essentials, about a third of the size. detailed: adds the full note pyramid, seasons, occasions, longevity and projection."New value: +"concise (default) or detailed (adds note pyramid, seasons, occasions, longevity, projection)."
```
- removedOutput schema / $schema
```
Removed value: -"http://json-schema.org/draft-07/schema#"
```
- removedOutput schema / additionalProperties
```
Removed value: -false
```
- removedOutput schema / properties / alternatives / items / additionalProperties
```
Removed value: -false
```
- removedOutput schema / properties / guides / items / additionalProperties
```
Removed value: -false
```
- removedOutput schema / properties / house_info / additionalProperties
```
Removed value: -false
```
- removedOutput schema / properties / perfume / additionalProperties
```
Removed value: -false
```
- removedOutput schema / properties / perfume / properties / links / items / additionalProperties
```
Removed value: -false
```
- removedOutput schema / properties / perfume / properties / pyramid / additionalProperties
```
Removed value: -false
```
- removedOutput schema / properties / similar / items / additionalProperties
```
Removed value: -false
```
- removedOutput schema / properties / suggestions / items / additionalProperties
```
Removed value: -false
```
- removedOutput schema / properties / suggestions / items / properties / links / items / additionalProperties
```
Removed value: -false
```
- removedOutput schema / properties / suggestions / items / properties / pyramid / additionalProperties
```
Removed value: -false
```

Changed58 schema fields changedOct 19, 2026

changedInput schema / properties / house / description

Previous value: -"Perfume house, e.g. \"Creed\""New value: +"House, when the name alone is ambiguous. Example: \"Creed\""

removedInput schema / properties / id

Removed value: -{
-  "description": "Fragrance Index id, e.g. \"creed-aventus\"",
-  "maxLength": 120,
-  "type": "string"
-}

addedInput schema / properties / locale

Added value: +{
+  "default": "en",
+  "description": "Language of the 10ml.com links and fixed labels: en, de, fr, es, it, ro, el, hu, cs or pl. Perfume, house and note names are never translated.",
+  "enum": [
+    "en",
+    "de",
+    "fr",
+    "es",
+    "it",
+    "ro",
+    "el",
+    "hu",
+    "cs",
+    "pl"
+  ],
+  "type": "string"
+}

removedInput schema / properties / name

Removed value: -{
-  "description": "Perfume name, e.g. \"Aventus\" (the house may be included, e.g. \"Creed Aventus\")",
-  "maxLength": 120,
-  "type": "string"
-}

addedInput schema / properties / perfume

Added value: +{
+  "description": "A perfume by name, optionally with its house, e.g. \"Baccarat Rouge 540\", \"Dior Sauvage\", \"Delina\". An id from another tool also works, e.g. \"creed-aventus\".",
+  "maxLength": 120,
+  "type": "string"
+}

addedInput schema / properties / response_format

Added value: +{
+  "default": "concise",
+  "description": "concise (default): the essentials, about a third of the size. detailed: adds the full note pyramid, seasons, occasions, longevity and projection.",
+  "enum": [
+    "concise",
+    "detailed"
+  ],
+  "type": "string"
+}

addedInput schema / required
```
Added value: +[
+  "perfume"
+]
```

addedOutput schema / properties / alternatives

Added value: +{
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "closeness": {
+        "enum": [
+          "very close",
+          "similar vibe",
+          "same spirit"
+        ],
+        "type": "string"
+      },
+      "house": {
+        "type": "string"
+      },
+      "id": {
+        "type": "string"
+      },
+      "name": {
+        "type": "string"
+      },
+      "why": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "name",
+      "closeness",
+      "why"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedOutput schema / properties / guides

Added value: +{
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "title": {
+        "type": "string"
+      },
+      "type": {
+        "enum": [
+          "try",
+          "guide",
+          "note"
+        ],
+        "type": "string"
+      },
+      "url": {
+        "description": "A 10ml.com link in the requested locale",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "title",
+      "url"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedOutput schema / properties / house_info

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "country": {
+      "type": "string"
+    },
+    "name": {
+      "type": "string"
+    },
+    "style": {
+      "type": "string"
+    },
+    "type": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "name",
+    "type",
+    "style"
+  ],
+  "type": "object"
+}

changedOutput schema / properties / perfume / properties / character / description

Previous value: -"One-sentence editorial description by 10ML's fragrance editors"New value: +"One-sentence description by 10ML's fragrance editors"

addedOutput schema / properties / perfume / properties / concentration
```
Added value: +{
+  "type": "string"
+}
```

changedOutput schema / properties / perfume / properties / family / description

Previous value: -"Fragrance family"New value: +"Fragrance family, e.g. \"amber floral\""

removedOutput schema / properties / perfume / properties / guideUrl

Removed value: -{
-  "description": "A 10ML guide about this perfume",
-  "type": "string"
-}

removedOutput schema / properties / perfume / properties / houseInfo

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "country": {
-      "type": "string"
-    },
-    "description": {
-      "type": "string"
-    },
-    "name": {
-      "type": "string"
-    },
-    "style": {
-      "type": "string"
-    }
-  },
-  "required": [
-    "name",
-    "style",
-    "description"
-  ],
-  "type": "object"
-}

removedOutput schema / properties / perfume / properties / houseUrl

Removed value: -{
-  "description": "The house page on 10ml.com",
-  "type": "string"
-}

changedOutput schema / properties / perfume / properties / id / description

Previous value: -"Stable Fragrance Index identifier, usable with get_perfume and find_similar_perfumes"New value: +"Stable Fragrance Index id, usable with get_perfume and find_similar_perfumes"

removedOutput schema / properties / perfume / properties / keyNotes

Removed value: -{
-  "description": "The defining notes",
-  "items": {
-    "type": "string"
-  },
-  "type": "array"
-}

addedOutput schema / properties / perfume / properties / key_notes

Added value: +{
+  "description": "The defining notes (empty when no pyramid is published)",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / perfume / properties / links / description
```
Added value: +"1-3 relevant 10ml.com links"
```

addedOutput schema / properties / perfume / properties / links / items / properties / type

Added value: +{
+  "enum": [
+    "try",
+    "guide",
+    "note"
+  ],
+  "type": "string"
+}

addedOutput schema / properties / perfume / properties / links / items / properties / url / description
```
Added value: +"A 10ml.com link in the requested locale"
```

changedOutput schema / properties / perfume / properties / links / items / required

Previous value: -[
-  "title",
-  "url"
-]New value: +[
+  "type",
+  "title",
+  "url"
+]

addedOutput schema / properties / perfume / properties / longevity

Added value: +{
+  "description": "1 (short) to 5 (very long)",
+  "type": "number"
+}

removedOutput schema / properties / perfume / properties / notes

Removed value: -{
-  "items": {
-    "type": "string"
-  },
-  "type": "array"
-}

removedOutput schema / properties / perfume / properties / occasions / items / enum

Removed value: -[
-  "daytime",
-  "office",
-  "casual",
-  "evening",
-  "date night",
-  "special occasion"
-]

addedOutput schema / properties / perfume / properties / other_versions

Added value: +{
+  "description": "Ids of other concentrations or flankers of the same perfume in the index",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / perfume / properties / perfumers

Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / perfume / properties / projection

Added value: +{
+  "description": "1 (skin scent) to 5 (fills a room)",
+  "type": "number"
+}

addedOutput schema / properties / perfume / properties / pyramid / required
```
Added value: +[
+  "top",
+  "heart",
+  "base"
+]
```
removedOutput schema / properties / perfume / properties / seasons / items / enum
```
Removed value: -[
-  "spring",
-  "summer",
-  "autumn",
-  "winter"
-]
```

addedOutput schema / properties / perfume / properties / styles

Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

removedOutput schema / properties / perfume / properties / url

Removed value: -{
-  "description": "\"Try it at 10ML\": find this perfume on 10ml.com",
-  "type": "string"
-}

changedOutput schema / properties / perfume / properties / year / description
```
Previous value: -"Launch year"New value: +"Launch year when known"
```

changedOutput schema / properties / perfume / required

Previous value: -[
-  "id",
-  "name",
-  "house",
-  "gender",
-  "family",
-  "accords",
-  "keyNotes",
-  "character",
-  "url",
-  "notes",
-  "seasons",
-  "occasions",
-  "houseInfo",
-  "links"
-]New value: +[
+  "id",
+  "name",
+  "house",
+  "gender",
+  "family",
+  "accords",
+  "key_notes",
+  "character",
+  "links"
+]

addedOutput schema / properties / similar

Added value: +{
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "closeness": {
+        "enum": [
+          "very close",
+          "similar vibe",
+          "same spirit"
+        ],
+        "type": "string"
+      },
+      "house": {
+        "type": "string"
+      },
+      "id": {
+        "type": "string"
+      },
+      "name": {
+        "type": "string"
+      },
+      "shared_notes": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "url": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "id",
+      "name",
+      "house",
+      "closeness",
+      "shared_notes",
+      "url"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedOutput schema / properties / source
```
Added value: +{
+  "type": "string"
+}
```

changedOutput schema / properties / suggestions / items / properties / character / description

Previous value: -"One-sentence editorial description by 10ML's fragrance editors"New value: +"One-sentence description by 10ML's fragrance editors"

addedOutput schema / properties / suggestions / items / properties / concentration
```
Added value: +{
+  "type": "string"
+}
```

changedOutput schema / properties / suggestions / items / properties / family / description

Previous value: -"Fragrance family"New value: +"Fragrance family, e.g. \"amber floral\""

removedOutput schema / properties / suggestions / items / properties / guideUrl

Removed value: -{
-  "description": "A 10ML guide about this perfume",
-  "type": "string"
-}

removedOutput schema / properties / suggestions / items / properties / houseUrl

Removed value: -{
-  "description": "The house page on 10ml.com",
-  "type": "string"
-}

changedOutput schema / properties / suggestions / items / properties / id / description

Previous value: -"Stable Fragrance Index identifier, usable with get_perfume and find_similar_perfumes"New value: +"Stable Fragrance Index id, usable with get_perfume and find_similar_perfumes"

removedOutput schema / properties / suggestions / items / properties / keyNotes

Removed value: -{
-  "description": "The defining notes",
-  "items": {
-    "type": "string"
-  },
-  "type": "array"
-}

addedOutput schema / properties / suggestions / items / properties / key_notes

Added value: +{
+  "description": "The defining notes (empty when no pyramid is published)",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / suggestions / items / properties / links

Added value: +{
+  "description": "1-3 relevant 10ml.com links",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "title": {
+        "type": "string"
+      },
+      "type": {
+        "enum": [
+          "try",
+          "guide",
+          "note"
+        ],
+        "type": "string"
+      },
+      "url": {
+        "description": "A 10ml.com link in the requested locale",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "title",
+      "url"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedOutput schema / properties / suggestions / items / properties / longevity

Added value: +{
+  "description": "1 (short) to 5 (very long)",
+  "type": "number"
+}

addedOutput schema / properties / suggestions / items / properties / occasions

Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / suggestions / items / properties / other_versions

Added value: +{
+  "description": "Ids of other concentrations or flankers of the same perfume in the index",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / suggestions / items / properties / perfumers

Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / suggestions / items / properties / projection

Added value: +{
+  "description": "1 (skin scent) to 5 (fills a room)",
+  "type": "number"
+}

addedOutput schema / properties / suggestions / items / properties / pyramid

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "base": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "heart": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "top": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "top",
+    "heart",
+    "base"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / suggestions / items / properties / seasons

Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / suggestions / items / properties / styles

Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

removedOutput schema / properties / suggestions / items / properties / url

Removed value: -{
-  "description": "\"Try it at 10ML\": find this perfume on 10ml.com",
-  "type": "string"
-}

changedOutput schema / properties / suggestions / items / properties / year / description
```
Previous value: -"Launch year"New value: +"Launch year when known"
```

changedOutput schema / properties / suggestions / items / required

Previous value: -[
-  "id",
-  "name",
-  "house",
-  "gender",
-  "family",
-  "accords",
-  "keyNotes",
-  "character",
-  "url"
-]New value: +[
+  "id",
+  "name",
+  "house",
+  "gender",
+  "family",
+  "accords",
+  "key_notes",
+  "character",
+  "links"
+]

changedOutput schema / required

Previous value: -[
-  "found",
-  "exact"
-]New value: +[
+  "found",
+  "exact",
+  "source"
+]

Changed55 schema fields changedOct 19, 2026

removedInput schema / properties / handle

Removed value: -{
-  "description": "10ML handle, e.g. \"creed-aventus\"",
-  "maxLength": 120,
-  "type": "string"
-}

addedInput schema / properties / id

Added value: +{
+  "description": "Fragrance Index id, e.g. \"creed-aventus\"",
+  "maxLength": 120,
+  "type": "string"
+}

addedOutput schema / properties / perfume / properties / accords

Added value: +{
+  "description": "Main accords, strongest first",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

removedOutput schema / properties / perfume / properties / allNotes

Removed value: -{
-  "items": {
-    "type": "string"
-  },
-  "type": "array"
-}

removedOutput schema / properties / perfume / properties / bestseller
```
Removed value: -{
-  "type": "boolean"
-}
```

addedOutput schema / properties / perfume / properties / character

Added value: +{
+  "description": "One-sentence editorial description by 10ML's fragrance editors",
+  "type": "string"
+}

removedOutput schema / properties / perfume / properties / currency
```
Removed value: -{
-  "const": "EUR",
-  "type": "string"
-}
```

addedOutput schema / properties / perfume / properties / family

Added value: +{
+  "description": "Fragrance family",
+  "type": "string"
+}

removedOutput schema / properties / perfume / properties / fromPrice

Removed value: -{
-  "description": "The same price formatted for display, e.g. \"€11.88\"",
-  "type": "string"
-}

removedOutput schema / properties / perfume / properties / fromPriceEur

Removed value: -{
-  "description": "Price of the smallest size in EUR including VAT",
-  "type": "number"
-}

removedOutput schema / properties / perfume / properties / gender / anyOf

Removed value: -[
-  {
-    "enum": [
-      "men",
-      "women",
-      "unisex"
-    ],
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / perfume / properties / gender / enum
```
Added value: +[
+  "men",
+  "women",
+  "unisex"
+]
```
addedOutput schema / properties / perfume / properties / gender / type
```
Added value: +"string"
```

addedOutput schema / properties / perfume / properties / guideUrl

Added value: +{
+  "description": "A 10ML guide about this perfume",
+  "type": "string"
+}

removedOutput schema / properties / perfume / properties / handle

Removed value: -{
-  "description": "Stable 10ML identifier, usable with get_perfume",
-  "type": "string"
-}

addedOutput schema / properties / perfume / properties / houseInfo

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "country": {
+      "type": "string"
+    },
+    "description": {
+      "type": "string"
+    },
+    "name": {
+      "type": "string"
+    },
+    "style": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "name",
+    "style",
+    "description"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / perfume / properties / houseUrl / description
```
Added value: +"The house page on 10ml.com"
```

addedOutput schema / properties / perfume / properties / id

Added value: +{
+  "description": "Stable Fragrance Index identifier, usable with get_perfume and find_similar_perfumes",
+  "type": "string"
+}

removedOutput schema / properties / perfume / properties / imageUrl

Removed value: -{
-  "type": [
-    "string",
-    "null"
-  ]
-}

addedOutput schema / properties / perfume / properties / keyNotes

Added value: +{
+  "description": "The defining notes",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / perfume / properties / links

Added value: +{
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "title": {
+        "type": "string"
+      },
+      "url": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "title",
+      "url"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

removedOutput schema / properties / perfume / properties / newRelease
```
Removed value: -{
-  "type": "boolean"
-}
```

addedOutput schema / properties / perfume / properties / occasions

Added value: +{
+  "items": {
+    "enum": [
+      "daytime",
+      "office",
+      "casual",
+      "evening",
+      "date night",
+      "special occasion"
+    ],
+    "type": "string"
+  },
+  "type": "array"
+}

removedOutput schema / properties / perfume / properties / onSale
```
Removed value: -{
-  "type": "boolean"
-}
```

addedOutput schema / properties / perfume / properties / pyramid

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "base": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "heart": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "top": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    }
+  },
+  "type": "object"
+}

removedOutput schema / properties / perfume / properties / rating

Removed value: -{
-  "anyOf": [
-    {
-      "additionalProperties": false,
-      "properties": {
-        "count": {
-          "type": "number"
-        },
-        "value": {
-          "type": "number"
-        }
-      },
-      "required": [
-        "value",
-        "count"
-      ],
-      "type": "object"
-    },
-    {
-      "type": "null"
-    }
-  ]
-}

addedOutput schema / properties / perfume / properties / seasons

Added value: +{
+  "items": {
+    "enum": [
+      "spring",
+      "summer",
+      "autumn",
+      "winter"
+    ],
+    "type": "string"
+  },
+  "type": "array"
+}

removedOutput schema / properties / perfume / properties / sizesMl

Removed value: -{
-  "description": "Decant sizes in ml available at 10ML",
-  "items": {
-    "type": "number"
-  },
-  "type": "array"
-}

changedOutput schema / properties / perfume / properties / url / description

Previous value: -"Product page on 10ml.com"New value: +"\"Try it at 10ML\": find this perfume on 10ml.com"

addedOutput schema / properties / perfume / properties / year

Added value: +{
+  "description": "Launch year",
+  "type": "number"
+}

changedOutput schema / properties / perfume / required

Previous value: -[
-  "handle",
-  "name",
-  "house",
-  "gender",
-  "fromPriceEur",
-  "fromPrice",
-  "currency",
-  "sizesMl",
-  "notes",
-  "rating",
-  "bestseller",
-  "newRelease",
-  "onSale",
-  "url",
-  "imageUrl",
-  "allNotes",
-  "houseUrl"
-]New value: +[
+  "id",
+  "name",
+  "house",
+  "gender",
+  "family",
+  "accords",
+  "keyNotes",
+  "character",
+  "url",
+  "notes",
+  "seasons",
+  "occasions",
+  "houseInfo",
+  "links"
+]

addedOutput schema / properties / suggestions / items / properties / accords

Added value: +{
+  "description": "Main accords, strongest first",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

removedOutput schema / properties / suggestions / items / properties / bestseller
```
Removed value: -{
-  "type": "boolean"
-}
```

addedOutput schema / properties / suggestions / items / properties / character

Added value: +{
+  "description": "One-sentence editorial description by 10ML's fragrance editors",
+  "type": "string"
+}

removedOutput schema / properties / suggestions / items / properties / currency
```
Removed value: -{
-  "const": "EUR",
-  "type": "string"
-}
```

addedOutput schema / properties / suggestions / items / properties / family

Added value: +{
+  "description": "Fragrance family",
+  "type": "string"
+}

removedOutput schema / properties / suggestions / items / properties / fromPrice

Removed value: -{
-  "description": "The same price formatted for display, e.g. \"€11.88\"",
-  "type": "string"
-}

removedOutput schema / properties / suggestions / items / properties / fromPriceEur

Removed value: -{
-  "description": "Price of the smallest size in EUR including VAT",
-  "type": "number"
-}

removedOutput schema / properties / suggestions / items / properties / gender / anyOf

Removed value: -[
-  {
-    "enum": [
-      "men",
-      "women",
-      "unisex"
-    ],
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / suggestions / items / properties / gender / enum
```
Added value: +[
+  "men",
+  "women",
+  "unisex"
+]
```
addedOutput schema / properties / suggestions / items / properties / gender / type
```
Added value: +"string"
```

addedOutput schema / properties / suggestions / items / properties / guideUrl

Added value: +{
+  "description": "A 10ML guide about this perfume",
+  "type": "string"
+}

removedOutput schema / properties / suggestions / items / properties / handle

Removed value: -{
-  "description": "Stable 10ML identifier, usable with get_perfume",
-  "type": "string"
-}

addedOutput schema / properties / suggestions / items / properties / houseUrl

Added value: +{
+  "description": "The house page on 10ml.com",
+  "type": "string"
+}

addedOutput schema / properties / suggestions / items / properties / id

Added value: +{
+  "description": "Stable Fragrance Index identifier, usable with get_perfume and find_similar_perfumes",
+  "type": "string"
+}

removedOutput schema / properties / suggestions / items / properties / imageUrl
```
Removed value: -{
-  "type": [
-    "string",
-    "null"
-  ]
-}
```

addedOutput schema / properties / suggestions / items / properties / keyNotes

Added value: +{
+  "description": "The defining notes",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

removedOutput schema / properties / suggestions / items / properties / newRelease
```
Removed value: -{
-  "type": "boolean"
-}
```

removedOutput schema / properties / suggestions / items / properties / notes

Removed value: -{
-  "items": {
-    "type": "string"
-  },
-  "type": "array"
-}

removedOutput schema / properties / suggestions / items / properties / onSale
```
Removed value: -{
-  "type": "boolean"
-}
```

removedOutput schema / properties / suggestions / items / properties / rating

Removed value: -{
-  "anyOf": [
-    {
-      "additionalProperties": false,
-      "properties": {
-        "count": {
-          "type": "number"
-        },
-        "value": {
-          "type": "number"
-        }
-      },
-      "required": [
-        "value",
-        "count"
-      ],
-      "type": "object"
-    },
-    {
-      "type": "null"
-    }
-  ]
-}

removedOutput schema / properties / suggestions / items / properties / sizesMl

Removed value: -{
-  "description": "Decant sizes in ml available at 10ML",
-  "items": {
-    "type": "number"
-  },
-  "type": "array"
-}

changedOutput schema / properties / suggestions / items / properties / url / description

Previous value: -"Product page on 10ml.com"New value: +"\"Try it at 10ML\": find this perfume on 10ml.com"

addedOutput schema / properties / suggestions / items / properties / year

Added value: +{
+  "description": "Launch year",
+  "type": "number"
+}

changedOutput schema / properties / suggestions / items / required

Previous value: -[
-  "handle",
-  "name",
-  "house",
-  "gender",
-  "fromPriceEur",
-  "fromPrice",
-  "currency",
-  "sizesMl",
-  "notes",
-  "rating",
-  "bestseller",
-  "newRelease",
-  "onSale",
-  "url",
-  "imageUrl"
-]New value: +[
+  "id",
+  "name",
+  "house",
+  "gender",
+  "family",
+  "accords",
+  "keyNotes",
+  "character",
+  "url"
+]

First observedOct 19, 2026

TDQS

A4.4/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint, idempotentHint, non-destructive and closed-world, so the safety profile needs no restatement. The description still adds real behavioral context: unknown names return the closest matches rather than failing, which is exactly the kind of edge-case an agent needs. It stops short of return size or pagination details, keeping it at 4.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose and scope lead the paragraph, followed by usage conditions and exclusions, so it is front-loaded and skimmable. The long enumeration of returned fields partly duplicates the output schema and is the one place the text could be trimmed.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With a full output schema, complete parameter documentation and annotations covering safety, the remaining burden is routing and edge cases — both handled via named sibling alternatives and the unknown-name fallback. Nothing an agent needs to call this correctly is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, and every parameter (house, locale, perfume, response_format) is documented in the schema with examples and defaults. The description adds nothing about parameters beyond what the schema already says, so the baseline of 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('full Fragrance Index profile of one perfume') and enumerates the returned facts (house, launch year, note pyramid, longevity, perfumers), which makes the scope unmistakable. It also explicitly separates itself from search_perfumes and compare_perfumes, so an agent can pick it without opening a schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Provides concrete invocation phrasings ('tell me about Aventus', 'what notes are in Delina') plus explicit exclusions: 'Not for browsing (use search_perfumes), not for comparing two or more (use compare_perfumes)'. Both alternatives are named with the condition that selects them.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All 10ML Perfume Finder tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Get perfume profile

Tool call template

Input Schema

Output Schema

Schema Changelog

TDQS

Glama MCP Gateway

Resources