10ML Fragrance Index

Get perfume profile

get_perfume

Read-onlyIdempotent

The full Fragrance Index profile of one perfume: house, launch year, audience, family, accords, note pyramid, best seasons and occasions, longevity and projection, perfumers, 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'). Not for browsing (use search_perfumes), not for comparing two or more (use compare_perfumes). Unknown names return the closest matches.

Input Schema

TableJSON 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. Perfume, house and note names stay as they are.	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 note pyramid, seasons, occasions, longevity, projection).	concise

Output Schema

TableJSON Schema

Name	Required	Description
`exact`	Yes	False when this is a closest-match guess
`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.

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 readOnly/idempotent/non-destructive/openWorld=false, so the safety profile is covered. The description adds genuinely new behavior: unknown names return the closest matches (fuzzy fallback), plus the presence of editorial alternatives and related 10ML links only 'when they exist'. It does not discuss rate limits or partial-result caveats, so not a 5.

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?

Front-loads the payload, then usage, then exclusions, then the edge case in a logical order with zero filler. The long enumeration of returned fields is the only costly part and partially duplicates the output schema, keeping it short of a 5.

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?

An output schema exists, so return values need no prose explanation; the description nonetheless sets expectations about optional sections (editorial alternatives, 10ML guides) and covers the main risk an agent faces, an unrecognized perfume name. Complete for a single-record lookup tool.

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%, so the schema already documents 'house' disambiguation, 'locale' link language, id-or-name input, and the concise/detailed enum. The description's field list maps loosely onto the concise/detailed split but adds no syntax, format, or default guidance beyond the schema, so baseline 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?

Opens with a specific verb+resource ('The full Fragrance Index profile of one perfume') and enumerates the concrete payload fields, so the agent knows exactly what comes back. It explicitly names the siblings it is not (search_perfumes, compare_perfumes), making it distinguishable without opening schemas.

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?

Gives an explicit trigger condition ('use when you know which perfume is meant'), two concrete user-phrasing examples, and two named exclusions with the alternative to use instead (browsing -> search_perfumes, comparing -> compare_perfumes). Nothing about routing is left to inference.

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

All 10ML Fragrance Index 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.