Servers Playground How we check Add a server Log in

10ML Perfume Finder

Working · 1.9 s

com.10ml/perfume-finderv2.5.3 Domain verified

Free perfume MCP server and fragrance API: 6,000+ perfumes, note pyramids, accords, similar scents.

Commerce

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.10ml.com/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

compare_perfumes Read-only

Compare 2 to 4 perfumes or colognes side by side: notes they share, notes only one has, accords, family, audience, launch year, longevity and projection, plus plain-language differences ('A is fresher, B is sweeter and lasts longer') and how close they are overall. Use when someone is choosing between named fragrances or asks how two differ ('Sauvage vs Bleu', 'Delina or Layton', 'Aventus or Layton for summer'). Not for finding perfumes like one (use find_similar_perfumes) and not for one perfume's details (use get_perfume).

perfumesarray, required

2 to 4 perfumes, each a name with optional house or an id. Example: ["Dior Sauvage","Tom Ford Ombre Leather"]

localestring

Language of the 10ml.com links and labels.

response_formatstring

concise (default) or detailed (adds pyramid, seasons, occasions, longevity).

10ML Perfume Finder MCP server | mcptry

Tools (15)

compare_perfumes

read-only

Argument	Type	Description
locale	string	Language of the 10ml.com links and labels.
perfumes*	array	2 to 4 perfumes, each a name with optional house or an id. Example: ["Dior Sauvage","Tom Ford Ombre Leather"]
response_format	string	concise (default) or detailed (adds pyramid, seasons, occasions, longevity).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "perfumes"
  ],
  "properties": {
    "locale": {
      "enum": [
        "en",
        "de",
        "fr",
        "es",
        "it",
        "ro",
        "el",
        "hu",
        "cs",
        "pl",
        "nl",
        "pt",
        "sv",
        "da",
        "fi",
        "bg",
        "hr"
      ],
      "type": "string",
      "default": "en",
      "description": "Language of the 10ml.com links and labels."
    },
    "perfumes": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 120
      },
      "maxItems": 4,
      "minItems": 2,
      "description": "2 to 4 perfumes, each a name with optional house or an id. Example: [\"Dior Sauvage\",\"Tom Ford Ombre Leather\"]"
    },
    "response_format": {
      "enum": [
        "concise",
        "detailed"
      ],
      "type": "string",
      "default": "concise",
      "description": "concise (default) or detailed (adds pyramid, seasons, occasions, longevity)."
    }
  }
}

explain_note

Explain a fragrance note or perfume ingredient: what it smells like, its family and mood, where it comes from, which notes it pairs with, similar notes, famous perfumes where it leads and a link to the 10ML note page or guide when one exists. Covers about 285 notes in many spellings and languages. Use for 'what does ambroxan smell like', 'what is oud', 'what goes with bergamot', 'is iso e super a note'. Not for listing every perfume with the note (use perfumes_by_note) and not for general terms like EDP or sillage (use explain_perfume_term).

read-only

Argument	Type	Description
note*	string	The note. Examples: "ambroxan", "oud", "sandalwood", "Bergamotte"
locale	string	Language of the 10ml.com links and labels.
response_format	string	concise (default) or detailed (adds pyramid, seasons, occasions, longevity).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "note"
  ],
  "properties": {
    "note": {
      "type": "string",
      "maxLength": 60,
      "minLength": 1,
      "description": "The note. Examples: \"ambroxan\", \"oud\", \"sandalwood\", \"Bergamotte\""
    },
    "locale": {
      "enum": [
        "en",
        "de",
        "fr",
        "es",
        "it",
        "ro",
        "el",
        "hu",
        "cs",
        "pl",
        "nl",
        "pt",
        "sv",
        "da",
        "fi",
        "bg",
        "hr"
      ],
      "type": "string",
      "default": "en",
      "description": "Language of the 10ml.com links and labels."
    },
    "response_format": {
      "enum": [
        "concise",
        "detailed"
      ],
      "type": "string",
      "default": "concise",
      "description": "concise (default) or detailed (adds pyramid, seasons, occasions, longevity)."
    }
  }
}

explain_perfume_term

Explain perfume vocabulary and fragrance families: concentrations (eau de cologne, eau de toilette, eau de parfum, extrait, elixir), sillage, projection, longevity, dry down, accord, top/heart/base notes, flanker, maceration, layering, niche vs designer, plus the 23 fragrance families (chypre, fougere, gourmand, oriental / amber...) with their key notes and example perfumes. Use for 'what is the difference between EDT and EDP', 'what is a chypre', 'what does sillage mean'. Leave term empty to list everything covered. Not for individual notes (use explain_note).

read-only

Argument	Type	Description
term	string	A term or family. Examples: "EDP", "sillage", "chypre", "dry down", "fougere". Omit to list all terms.
limit	integer	Results per page.
cursor	string	next_cursor from the previous page.
locale	string	Language of the 10ml.com links and labels.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "term": {
      "type": "string",
      "maxLength": 60,
      "description": "A term or family. Examples: \"EDP\", \"sillage\", \"chypre\", \"dry down\", \"fougere\". Omit to list all terms."
    },
    "limit": {
      "type": "integer",
      "default": 12,
      "maximum": 60,
      "minimum": 1,
      "description": "Results per page."
    },
    "cursor": {
      "type": "string",
      "maxLength": 64,
      "description": "next_cursor from the previous page."
    },
    "locale": {
      "enum": [
        "en",
        "de",
        "fr",
        "es",
        "it",
        "ro",
        "el",
        "hu",
        "cs",
        "pl",
        "nl",
        "pt",
        "sv",
        "da",
        "fi",
        "bg",
        "hr"
      ],
      "type": "string",
      "default": "en",
      "description": "Language of the 10ml.com links and labels."
    }
  }
}

find_gift

Perfume and fragrance gift ideas from who the gift is for: recipient (him, her or anyone), relationship, age range, perfumes or notes they already love, style, occasion and how adventurous to be. Each pick comes with the reason it suits them. Use for 'gift for a woman who loves Delina', 'something safe for my dad' or 'a bold present for a friend'. Not for personal taste recommendations (use recommend_perfumes) and not for classics lists (use search_perfumes with iconic true).

read-only

Argument	Type	Description
limit	integer	Results per page.
loves	array	Perfumes they already wear or love, e.g. ["Delina"]
style	array	Up to 3 style words for the scent they like, e.g. ["fresh", "woody"].
cursor	string	next_cursor from the previous page.
locale	string	Language of the 10ml.com links and labels.
boldness	string	safe: crowd-pleasing classics; adventurous: distinctive niche picks
occasion	string	When they would wear it most, e.g. "office"
age_range	string

find_perfume_alternatives

The editors' alternatives (dupes) to a famous perfume or cologne, from other houses: for each, why it is close and how close (very close, similar vibe, same spirit), plus the 10ML guide that compares them. Covers about 100 iconic originals such as Creed Aventus, Baccarat Rouge 540, Delina, Sauvage, Black Opium or Santal 33. For other fragrances in the index the closest options from different houses are computed from notes and accords. Use for 'dupe of X', 'alternative to X', 'what smells like X from another house'. Not for general similarity inside the index (use find_similar_perfumes) and not for free-text discovery (use search_perfumes).

read-only

Argument	Type	Description
house	string	House of the original when the name is ambiguous, e.g. "Parfums de Marly"
limit	integer	Results per page.
cursor	string	next_cursor from the previous page.
locale	string	Language of the 10ml.com links and labels.
perfume*	string	The famous perfume to find alternatives for. Examples: "Creed Aventus", "Baccarat Rouge 540", "Delina"
closeness	string	Only alternatives at this closeness

Input schema (JSON)

find_similar_perfumes

Find perfumes and colognes that smell like one the person already likes, ranked by shared notes, accords and style, each saying exactly what it shares and how close it is (very close, similar vibe, same spirit). Works from a perfume in the index (name and house, or id) OR from free notes/accords for any other fragrance. Steer the result: fresher, sweeter, darker, lighter, longer_lasting or more_projection. Use for 'something like Baccarat Rouge 540', 'smells like Sauvage but fresher' or 'a scent with saffron and cedar'. Not for editorial dupes of a famous perfume from other houses (use find_perfume_alternatives) and not for free-text discovery (use search_perfumes).

read-only

Argument	Type	Description
house	string	House of the perfume when the name alone is ambiguous, e.g. "Maison Francis Kurkdjian"
limit	integer	Results per page.
notes	array	Known notes of the starting perfume, for perfumes outside the index. Example: ["jasmine","saffron","ambergris","cedar"]
steer	string	Move away from the starting point in one direction: fresher, sweeter, darker, lighter, longer_lasting (needs a perfume in the index) or more_projection (same).
cursor	string	next_cursor from the previous page.
gender	string	Only return perfumes for this audience (men and women include unisex)

get_house

Profile of a perfume house or fragrance brand: country, founded year, style (designer, niche, Middle Eastern, indie), what it is known for, its signature perfumes in the index and a link to explore it at 10ML. Understands nicknames (YSL, MFK, PDM, Paco Rabanne). Use for 'tell me about Creed', 'what is Amouage known for' or 'best Dior perfumes'. Not for browsing all houses (use list_houses) and not for one perfume (use get_perfume).

read-only

Argument	Type	Description
house*	string	The house. Examples: "Creed", "YSL", "Maison Francis Kurkdjian", "Parfums de Marly"
locale	string	Language of the 10ml.com links and labels.
response_format	string	concise (default) or detailed (adds pyramid, seasons, occasions, longevity).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "house"
  ],
  "properties": {
    "house": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1,
      "description": "The house. Examples: \"Creed\", \"YSL\", \"Maison Francis Kurkdjian\", \"Parfums de Marly\""
    },
    "locale": {
      "enum": [
        "en",
        "de",
        "fr",
        "es",
        "it",
        "ro",
        "el",
        "hu",
        "cs",
        "pl",
        "nl",
        "pt",
        "sv",
        "da",
        "fi",
        "bg",
        "hr"
      ],
      "type": "string",
      "default": "en",
      "description": "Language of the 10ml.com links and labels."
    },
    "response_format": {
      "enum": [
        "concise",
        "detailed"
      ],
      "type": "string",
      "default": "concise",
      "description": "concise (default) or detailed (adds pyramid, seasons, occasions, longevity)."
    }
  }
}

get_perfume

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.

read-only

Argument	Type	Description
house	string	House, when the name alone is ambiguous. Example: "Creed"
locale	string	Language of the 10ml.com links and labels.
perfume*	string	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	string	concise (default) or detailed (adds pyramid, seasons, occasions, longevity).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "perfume"
  ],
  "properties": {
    "house": {
      "type": "string",
      "maxLength": 80,
      "description": "House, when the name alone is ambiguous. Example: \"Creed\""
    },
    "locale": {
      "enum": [
        "en",
        "de",
        "fr",
        "es",
        "it",
        "ro",
        "el",
        "hu",
        "cs",
        "pl",
        "nl",
        "pt",
        "sv",
        "da",
        "fi",
        "bg",
        "hr"
      ],
      "type": "string",
      "default": "en",
      "description": "Language of the 10ml.com links and labels."
    },
    "perfume": {
      "type": "string",
      "maxLength": 120,
      "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\"."
    },
    "response_format": {
      "enum": [
        "concise",
        "detailed"
      ],
      "type": "string",
      "default": "concise",
      "description": "concise (default) or detailed (adds pyramid, seasons, occasions, longevity)."
    }
  }
}

list_houses

Browse the perfume houses and fragrance brands in the 10ML Fragrance Index with country, type (designer, niche, middle-eastern, indie, celebrity), perfumes profiled and what each is known for. Filter by type, country or a name fragment. Use when someone wants to explore brands, find niche or Middle Eastern houses, or see which houses are covered. Not for one house's full profile (use get_house) and not for perfumes (use search_perfumes).

read-only

Argument	Type	Description
type	string	Only houses of this type
limit	integer	Results per page.
query	string	Part of a house name, e.g. "tom" or "maison"
cursor	string	next_cursor from the previous page.
locale	string	Language of the 10ml.com links and labels.
country	string	Only houses from this country, e.g. "France", "Italy", "United Arab Emirates"

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "type": {
      "enum": [
        "designer",
        "niche",
        "middle-eastern",
        "indie",
        "celebrity"
      ],
      "type": "string",
      "description": "Only houses of this type"
    },
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Results per page."
    },
    "query": {
      "type": "string",
      "maxLength": 60,
      "description": "Part of a house name, e.g. \"tom\" or \"maison\""
    },
    "cursor": {
      "type": "string",
      "maxLength": 64,
      "description": "next_cursor from the previous page."
    },
    "locale": {
      "enum": [
        "en",
        "de",
        "fr",
        "es",
        "it",
        "ro",
        "el",
        "hu",
        "cs",
        "pl",
        "nl",
        "pt",
        "sv",
        "da",
        "fi",
        "bg",
        "hr"
      ],
      "type": "string",
      "default": "en",
      "description": "Language of the 10ml.com links and labels."
    },
    "country": {
      "type": "string",
      "maxLength": 40,
      "description": "Only houses from this country, e.g. \"France\", \"Italy\", \"United Arab Emirates\""
    }
  }
}

perfumes_by_note

List the perfumes and colognes in the 10ML Fragrance Index built around a note or ingredient (vanilla, oud, bergamot, tonka bean, jasmine, patchouli, leather, sandalwood...), most prominent first, optionally only where the note sits in the top, heart or base, or for an audience, season or occasion. Spelling variants and other languages work (agarwood finds oud, Vanille finds vanilla). Use for 'perfumes with oud', 'a vanilla scent for winter' or 'bergamot-forward colognes for men'. Not for explaining what a note smells like (use explain_note) and not for several notes at once (use search_perfumes with notes_include).

read-only

Argument	Type	Description
note*	string	The note. Examples: "oud", "vanilla", "pink pepper", "Vanille"
limit	integer	Results per page.
cursor	string	next_cursor from the previous page.
gender	string	Audience the perfume is marketed to. men and women also include unisex perfumes.
locale	string	Language of the 10ml.com links and labels.
season	string	Season the perfume suits (fall is accepted in text queries as autumn).
occasion	string

pick_for_occasion

Perfume and cologne picks for a moment: a season, an occasion (daytime, office, casual, evening, date night, special occasion), an audience and a style, each with the reason it fits. Use for 'a fresh summer office scent for men', 'date night perfume for her' or 'what fragrance to wear to a winter wedding'. Give at least one of season, occasion, gender or style. Not for taste-based matching (use recommend_perfumes), not for gifts (use find_gift) and not for classics (use search_perfumes with iconic true).

read-only

Argument	Type	Description
limit	integer	Results per page.
style	array	Styles wanted, e.g. ["fresh","clean"] for summer office wear
cursor	string	next_cursor from the previous page.
gender	string	Audience the perfume is marketed to. men and women also include unisex perfumes.
locale	string	Language of the 10ml.com links and labels.
season	string	Season the perfume suits (fall is accepted in text queries as autumn).
occasion	string	Occasion the perfume suits.
response_format

recommend_perfumes

Personal perfume and cologne recommendations from taste: fragrances they love or dislike, notes they like or avoid, plus gender, season, occasion, style and family. Every pick says why (shared notes with a loved perfume, a liked note, fits the season). Use when someone says what they enjoy or avoid and wants suggestions ('I love Delina and vanilla, nothing too sweet, for winter evenings', 'my signature scent is Sauvage, what next'). Not for one-off filters without taste (use search_perfumes), not for a single occasion list (use pick_for_occasion) and not for gifts (use find_gift).

read-only

Argument	Type	Description
likes	array	Perfumes they love, e.g. ["Parfums de Marly Delina","Dior Sauvage"]
limit	integer	Results per page.
style	array	Styles wanted, e.g. ["fresh","clean"]
cursor	string	next_cursor from the previous page.
family	string	A fragrance family or word like "woody" or "citrus"
gender	string	Audience the perfume is marketed to. men and women also include unisex perfumes.
locale	string	Language of the 10ml.com links and labels.

search_guides

Find 10ML's perfume and fragrance guides to read or cite: how-tos (where to spray, finding a signature scent, making perfume last), notes explained, house guides, lists, and alternatives guides that compare famous perfumes with similar ones from other houses. Returns title, type and a link per locale. Use whenever you want a source to cite or a deeper read ('how to layer perfume', 'best oud perfumes', 'Creed Aventus dupes guide'). Not for facts about a perfume (use get_perfume) and not for note definitions (use explain_note).

read-only

Argument	Type	Description
type	string	how-to, list (rankings/comparisons), alternatives (dupes guides), note (a note explained), house (a house mapped)
limit	integer	Results per page.
query	string	What the guide is about. Examples: "how to make perfume last", "oud", "Creed Aventus dupes", "gift". Omit to browse.
cursor	string	next_cursor from the previous page.
locale	string	Language of the 10ml.com links and labels.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "type": {
      "enum": [
        "how-to",
        "list",
        "alternatives",
        "note",
        "house"
      ],
      "type": "string",
      "description": "how-to, list (rankings/comparisons), alternatives (dupes guides), note (a note explained), house (a house mapped)"
    },
    "limit": {
      "type": "integer",
      "default": 8,
      "maximum": 20,
      "minimum": 1,
      "description": "Results per page."
    },
    "query": {
      "type": "string",
      "maxLength": 120,
      "description": "What the guide is about. Examples: \"how to make perfume last\", \"oud\", \"Creed Aventus dupes\", \"gift\". Omit to browse."
    },
    "cursor": {
      "type": "string",
      "maxLength": 64,
      "description": "next_cursor from the previous page."
    },
    "locale": {
      "enum": [
        "en",
        "de",
        "fr",
        "es",
        "it",
        "ro",
        "el",
        "hu",
        "cs",
        "pl",
        "nl",
        "pt",
        "sv",
        "da",
        "fi",
        "bg",
        "hr"
      ],
      "type": "string",
      "default": "en",
      "description": "Language of the 10ml.com links and labels."
    }
  }
}

search_perfumes

Search the 10ML Fragrance Index for perfumes, colognes and fragrances (eau de parfum, eau de toilette, extrait) by name, house, notes, accords, family, audience, season, occasion or style. Natural language works: 'fresh citrus summer cologne for men' or 'warm vanilla scent for winter' is understood. Set iconic to true for only the editors' iconic, era-defining classics ('must-know perfumes for her', 'iconic winter scents'). Use when someone describes the scent they want, or names a perfume or house and you need matching fragrances. Not for the full profile of one known perfume (use get_perfume), not for 'something like X' (use find_similar_perfumes) and not for dupes or alternatives to a famous perfume (use find_perfume_alternatives). Returns ranked perfumes with house, year, family, accords, key notes, an editorial character line and 10ml.com links.

read-only

Argument	Type	Description
house	string	Only perfumes from this house. Examples: "Dior", "Maison Francis Kurkdjian", "MFK", "YSL"
limit	integer	Results per page.
query	string	Free text: a perfume name, house, notes or mood. Examples: "fresh citrus summer for men", "Tom Ford oud", "vanilla gourmand for winter"
style	string	A style word the scent should have.
cursor	string	next_cursor from the previous page.
family	string

suggest_layering

Perfume and fragrance layering ideas: which notes or perfumes combine well, what the combination smells like, how to spray (order, amount) and when it suits. Works from two notes ('vanilla and citrus'), one note (what it layers with), one perfume (partners from the index) or two perfumes (does this pair work). Editorial pairings are marked 'editors'; others are marked 'suggested' and should be tested on skin. Use for 'how do I layer vanilla', 'can I layer Delina with something', 'does Sauvage layer with Aventus'. Not for choosing a single perfume (use recommend_perfumes).

read-only

Argument	Type	Description
limit	integer	Results per page.
notes	array	One or two notes. Examples: ["vanilla","citrus"], ["oud"]
locale	string	Language of the 10ml.com links and labels.
perfumes	array	One or two perfumes. Examples: ["Parfums de Marly Delina"], ["Dior Sauvage","Creed Aventus"]
response_format	string	concise (default) or detailed (adds pyramid, seasons, occasions, longevity).

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 5,
      "maximum": 10,
      "minimum": 1,
      "description": "Results per page."
    },
    "notes": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 60
      },
      "maxItems": 2,
      "minItems": 1,
      "description": "One or two notes. Examples: [\"vanilla\",\"citrus\"], [\"oud\"]"
    },
    "locale": {
      "enum": [
        "en",
        "de",
        "fr",
        "es",
        "it",
        "ro",
        "el",
        "hu",
        "cs",
        "pl",
        "nl",
        "pt",
        "sv",
        "da",
        "fi",
        "bg",
        "hr"
      ],
      "type": "string",
      "default": "en",
      "description": "Language of the 10ml.com links and labels."
    },
    "perfumes": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 120
      },
      "maxItems": 2,
      "minItems": 1,
      "description": "One or two perfumes. Examples: [\"Parfums de Marly Delina\"], [\"Dior Sauvage\",\"Creed Aventus\"]"
    },
    "response_format": {
      "enum": [
        "concise",
        "detailed"
      ],
      "type": "string",
      "default": "concise",
      "description": "concise (default) or detailed (adds pyramid, seasons, occasions, longevity)."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "required": [
    "recipient"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 5,
      "maximum": 12,
      "minimum": 1,
      "description": "Results per page."
    },
    "loves": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 120
      },
      "maxItems": 5,
      "description": "Perfumes they already wear or love, e.g. [\"Delina\"]"
    },
    "style": {
      "type": "array",
      "items": {
        "enum": [
          "aquatic",
          "boozy",
          "clean",
          "creamy",
          "dark",
          "floral",
          "fresh",
          "citrusy",
          "fruity",
          "gourmand",
          "green",
          "leathery",
          "musky",
          "powdery",
          "sensual",
          "smoky",
          "spicy",
          "sweet",
          "woody"
        ],
        "type": "string",
        "description": "A style word the scent should have."
      },
      "maxItems": 3,
      "description": "Up to 3 style words for the scent they like, e.g. [\"fresh\", \"woody\"]."
    },
    "cursor": {
      "type": "string",
      "maxLength": 64,
      "description": "next_cursor from the previous page."
    },
    "locale": {
      "enum": [
        "en",
        "de",
        "fr",
        "es",
        "it",
        "ro",
        "el",
        "hu",
        "cs",
        "pl",
        "nl",
        "pt",
        "sv",
        "da",
        "fi",
        "bg",
        "hr"
      ],
      "type": "string",
      "default": "en",
      "description": "Language of the 10ml.com links and labels."
    },
    "boldness": {
      "enum": [
        "safe",
        "adventurous"
      ],
      "type": "string",
      "default": "safe",
      "description": "safe: crowd-pleasing classics; adventurous: distinctive niche picks"
    },
    "occasion": {
      "enum": [
        "daytime",
        "office",
        "casual",
        "evening",
        "date night",
        "special occasion"
      ],
      "type": "string",
      "description": "When they would wear it most, e.g. \"office\""
    },
    "age_range": {
      "enum": [
        "teen",
        "20s",
        "30s-40s",
        "50plus"
      ],
      "type": "string",
      "description": "Age range of the recipient"
    },
    "recipient": {
      "enum": [
        "him",
        "her",
        "anyone"
      ],
      "type": "string",
      "description": "Who the gift is for: him (men and unisex), her (women and unisex) or anyone (unisex-friendly)"
    },
    "liked_notes": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 60
      },
      "maxItems": 6,
      "description": "Notes they like, e.g. [\"vanilla\",\"bergamot\"]"
    },
    "relationship": {
      "type": "string",
      "maxLength": 40,
      "description": "Example: \"partner\", \"dad\", \"colleague\", \"friend\""
    },
    "response_format": {
      "enum": [
        "concise",
        "detailed"
      ],
      "type": "string",
      "default": "concise",
      "description": "concise (default) or detailed (adds pyramid, seasons, occasions, longevity)."
    }
  }
}

{
  "type": "object",
  "required": [
    "perfume"
  ],
  "properties": {
    "house": {
      "type": "string",
      "maxLength": 80,
      "description": "House of the original when the name is ambiguous, e.g. \"Parfums de Marly\""
    },
    "limit": {
      "type": "integer",
      "default": 6,
      "maximum": 10,
      "minimum": 1,
      "description": "Results per page."
    },
    "cursor": {
      "type": "string",
      "maxLength": 64,
      "description": "next_cursor from the previous page."
    },
    "locale": {
      "enum": [
        "en",
        "de",
        "fr",
        "es",
        "it",
        "ro",
        "el",
        "hu",
        "cs",
        "pl",
        "nl",
        "pt",
        "sv",
        "da",
        "fi",
        "bg",
        "hr"
      ],
      "type": "string",
      "default": "en",
      "description": "Language of the 10ml.com links and labels."
    },
    "perfume": {
      "type": "string",
      "maxLength": 120,
      "description": "The famous perfume to find alternatives for. Examples: \"Creed Aventus\", \"Baccarat Rouge 540\", \"Delina\""
    },
    "closeness": {
      "enum": [
        "very close",
        "similar vibe",
        "same spirit"
      ],
      "type": "string",
      "description": "Only alternatives at this closeness"
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "house": {
      "type": "string",
      "maxLength": 80,
      "description": "House of the perfume when the name alone is ambiguous, e.g. \"Maison Francis Kurkdjian\""
    },
    "limit": {
      "type": "integer",
      "default": 8,
      "maximum": 15,
      "minimum": 1,
      "description": "Results per page."
    },
    "notes": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 60
      },
      "maxItems": 30,
      "description": "Known notes of the starting perfume, for perfumes outside the index. Example: [\"jasmine\",\"saffron\",\"ambergris\",\"cedar\"]"
    },
    "steer": {
      "enum": [
        "fresher",
        "sweeter",
        "darker",
        "lighter",
        "longer_lasting",
        "more_projection"
      ],
      "type": "string",
      "description": "Move away from the starting point in one direction: fresher, sweeter, darker, lighter, longer_lasting (needs a perfume in the index) or more_projection (same)."
    },
    "cursor": {
      "type": "string",
      "maxLength": 64,
      "description": "next_cursor from the previous page."
    },
    "gender": {
      "enum": [
        "men",
        "women",
        "unisex"
      ],
      "type": "string",
      "description": "Only return perfumes for this audience (men and women include unisex)"
    },
    "locale": {
      "enum": [
        "en",
        "de",
        "fr",
        "es",
        "it",
        "ro",
        "el",
        "hu",
        "cs",
        "pl",
        "nl",
        "pt",
        "sv",
        "da",
        "fi",
        "bg",
        "hr"
      ],
      "type": "string",
      "default": "en",
      "description": "Language of the 10ml.com links and labels."
    },
    "accords": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 40
      },
      "maxItems": 6,
      "description": "Known accords of the starting perfume. Example: [\"amber\",\"woody\",\"sweet\"]"
    },
    "perfume": {
      "type": "string",
      "maxLength": 120,
      "description": "A perfume by name, optionally with its house, e.g. \"Baccarat Rouge 540\", \"Dior Sauvage\", \"Delina\". Or pass an id from another tool."
    },
    "response_format": {
      "enum": [
        "concise",
        "detailed"
      ],
      "type": "string",
      "default": "concise",
      "description": "concise (default) or detailed (adds pyramid, seasons, occasions, longevity)."
    },
    "other_houses_only": {
      "type": "boolean",
      "default": false,
      "description": "True to leave out perfumes from the same house as the starting perfume"
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "required": [
    "note"
  ],
  "properties": {
    "note": {
      "type": "string",
      "maxLength": 60,
      "minLength": 1,
      "description": "The note. Examples: \"oud\", \"vanilla\", \"pink pepper\", \"Vanille\""
    },
    "limit": {
      "type": "integer",
      "default": 8,
      "maximum": 20,
      "minimum": 1,
      "description": "Results per page."
    },
    "cursor": {
      "type": "string",
      "maxLength": 64,
      "description": "next_cursor from the previous page."
    },
    "gender": {
      "enum": [
        "men",
        "women",
        "unisex"
      ],
      "type": "string",
      "description": "Audience the perfume is marketed to. men and women also include unisex perfumes."
    },
    "locale": {
      "enum": [
        "en",
        "de",
        "fr",
        "es",
        "it",
        "ro",
        "el",
        "hu",
        "cs",
        "pl",
        "nl",
        "pt",
        "sv",
        "da",
        "fi",
        "bg",
        "hr"
      ],
      "type": "string",
      "default": "en",
      "description": "Language of the 10ml.com links and labels."
    },
    "season": {
      "enum": [
        "spring",
        "summer",
        "autumn",
        "winter"
      ],
      "type": "string",
      "description": "Season the perfume suits (fall is accepted in text queries as autumn)."
    },
    "occasion": {
      "enum": [
        "daytime",
        "office",
        "casual",
        "evening",
        "date night",
        "special occasion"
      ],
      "type": "string",
      "description": "Occasion the perfume suits."
    },
    "position": {
      "enum": [
        "any",
        "top",
        "heart",
        "base"
      ],
      "type": "string",
      "default": "any",
      "description": "Where the note sits in the pyramid: top, heart, base or any"
    },
    "response_format": {
      "enum": [
        "concise",
        "detailed"
      ],
      "type": "string",
      "default": "concise",
      "description": "concise (default) or detailed (adds pyramid, seasons, occasions, longevity)."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 6,
      "maximum": 15,
      "minimum": 1,
      "description": "Results per page."
    },
    "style": {
      "type": "array",
      "items": {
        "enum": [
          "aquatic",
          "boozy",
          "clean",
          "creamy",
          "dark",
          "floral",
          "fresh",
          "citrusy",
          "fruity",
          "gourmand",
          "green",
          "leathery",
          "musky",
          "powdery",
          "sensual",
          "smoky",
          "spicy",
          "sweet",
          "woody"
        ],
        "type": "string",
        "description": "A style word the scent should have."
      },
      "maxItems": 3,
      "description": "Styles wanted, e.g. [\"fresh\",\"clean\"] for summer office wear"
    },
    "cursor": {
      "type": "string",
      "maxLength": 64,
      "description": "next_cursor from the previous page."
    },
    "gender": {
      "enum": [
        "men",
        "women",
        "unisex"
      ],
      "type": "string",
      "description": "Audience the perfume is marketed to. men and women also include unisex perfumes."
    },
    "locale": {
      "enum": [
        "en",
        "de",
        "fr",
        "es",
        "it",
        "ro",
        "el",
        "hu",
        "cs",
        "pl",
        "nl",
        "pt",
        "sv",
        "da",
        "fi",
        "bg",
        "hr"
      ],
      "type": "string",
      "default": "en",
      "description": "Language of the 10ml.com links and labels."
    },
    "season": {
      "enum": [
        "spring",
        "summer",
        "autumn",
        "winter"
      ],
      "type": "string",
      "description": "Season the perfume suits (fall is accepted in text queries as autumn)."
    },
    "occasion": {
      "enum": [
        "daytime",
        "office",
        "casual",
        "evening",
        "date night",
        "special occasion"
      ],
      "type": "string",
      "description": "Occasion the perfume suits."
    },
    "response_format": {
      "enum": [
        "concise",
        "detailed"
      ],
      "type": "string",
      "default": "concise",
      "description": "concise (default) or detailed (adds pyramid, seasons, occasions, longevity)."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "likes": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 120
      },
      "maxItems": 6,
      "description": "Perfumes they love, e.g. [\"Parfums de Marly Delina\",\"Dior Sauvage\"]"
    },
    "limit": {
      "type": "integer",
      "default": 6,
      "maximum": 15,
      "minimum": 1,
      "description": "Results per page."
    },
    "style": {
      "type": "array",
      "items": {
        "enum": [
          "aquatic",
          "boozy",
          "clean",
          "creamy",
          "dark",
          "floral",
          "fresh",
          "citrusy",
          "fruity",
          "gourmand",
          "green",
          "leathery",
          "musky",
          "powdery",
          "sensual",
          "smoky",
          "spicy",
          "sweet",
          "woody"
        ],
        "type": "string",
        "description": "A style word the scent should have."
      },
      "maxItems": 4,
      "description": "Styles wanted, e.g. [\"fresh\",\"clean\"]"
    },
    "cursor": {
      "type": "string",
      "maxLength": 64,
      "description": "next_cursor from the previous page."
    },
    "family": {
      "type": "string",
      "maxLength": 40,
      "description": "A fragrance family or word like \"woody\" or \"citrus\""
    },
    "gender": {
      "enum": [
        "men",
        "women",
        "unisex"
      ],
      "type": "string",
      "description": "Audience the perfume is marketed to. men and women also include unisex perfumes."
    },
    "locale": {
      "enum": [
        "en",
        "de",
        "fr",
        "es",
        "it",
        "ro",
        "el",
        "hu",
        "cs",
        "pl",
        "nl",
        "pt",
        "sv",
        "da",
        "fi",
        "bg",
        "hr"
      ],
      "type": "string",
      "default": "en",
      "description": "Language of the 10ml.com links and labels."
    },
    "season": {
      "enum": [
        "spring",
        "summer",
        "autumn",
        "winter"
      ],
      "type": "string",
      "description": "Season the perfume suits (fall is accepted in text queries as autumn)."
    },
    "dislikes": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 120
      },
      "maxItems": 6,
      "description": "Perfumes they dislike; similar ones are pushed down"
    },
    "occasion": {
      "enum": [
        "daytime",
        "office",
        "casual",
        "evening",
        "date night",
        "special occasion"
      ],
      "type": "string",
      "description": "Occasion the perfume suits."
    },
    "liked_notes": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 60
      },
      "maxItems": 8,
      "description": "Notes they enjoy, e.g. [\"vanilla\",\"bergamot\"]"
    },
    "avoided_notes": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 60
      },
      "maxItems": 8,
      "description": "Notes to exclude entirely, e.g. [\"patchouli\",\"oud\"]"
    },
    "response_format": {
      "enum": [
        "concise",
        "detailed"
      ],
      "type": "string",
      "default": "concise",
      "description": "concise (default) or detailed (adds pyramid, seasons, occasions, longevity)."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "house": {
      "type": "string",
      "maxLength": 80,
      "description": "Only perfumes from this house. Examples: \"Dior\", \"Maison Francis Kurkdjian\", \"MFK\", \"YSL\""
    },
    "limit": {
      "type": "integer",
      "default": 8,
      "maximum": 20,
      "minimum": 1,
      "description": "Results per page."
    },
    "query": {
      "type": "string",
      "maxLength": 200,
      "description": "Free text: a perfume name, house, notes or mood. Examples: \"fresh citrus summer for men\", \"Tom Ford oud\", \"vanilla gourmand for winter\""
    },
    "style": {
      "enum": [
        "aquatic",
        "boozy",
        "clean",
        "creamy",
        "dark",
        "floral",
        "fresh",
        "citrusy",
        "fruity",
        "gourmand",
        "green",
        "leathery",
        "musky",
        "powdery",
        "sensual",
        "smoky",
        "spicy",
        "sweet",
        "woody"
      ],
      "type": "string",
      "description": "A style word the scent should have."
    },
    "cursor": {
      "type": "string",
      "maxLength": 64,
      "description": "next_cursor from the previous page."
    },
    "family": {
      "type": "string",
      "maxLength": 40,
      "description": "Fragrance family. Examples: \"chypre\", \"fougere\", \"gourmand\", \"amber\", \"citrus\". Leave term empty in explain_perfume_term to list every family."
    },
    "gender": {
      "enum": [
        "men",
        "women",
        "unisex"
      ],
      "type": "string",
      "description": "Audience the perfume is marketed to. men and women also include unisex perfumes."
    },
    "iconic": {
      "type": "boolean",
      "description": "true = only the editors' iconic, era-defining classics (works with every other filter, and without a query)"
    },
    "locale": {
      "enum": [
        "en",
        "de",
        "fr",
        "es",
        "it",
        "ro",
        "el",
        "hu",
        "cs",
        "pl",
        "nl",
        "pt",
        "sv",
        "da",
        "fi",
        "bg",
        "hr"
      ],
      "type": "string",
      "default": "en",
      "description": "Language of the 10ml.com links and labels."
    },
    "season": {
      "enum": [
        "spring",
        "summer",
        "autumn",
        "winter"
      ],
      "type": "string",
      "description": "Season the perfume suits (fall is accepted in text queries as autumn)."
    },
    "accords": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 40
      },
      "maxItems": 6,
      "description": "Accords that must be present. Examples: [\"woody\",\"sweet\"], [\"fresh\",\"aquatic\"]"
    },
    "occasion": {
      "enum": [
        "daytime",
        "office",
        "casual",
        "evening",
        "date night",
        "special occasion"
      ],
      "type": "string",
      "description": "Occasion the perfume suits."
    },
    "notes_exclude": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 60
      },
      "maxItems": 8,
      "description": "None of these notes may be present. Example: [\"patchouli\"]"
    },
    "notes_include": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 60
      },
      "maxItems": 8,
      "description": "Every listed note must be present. Examples: [\"oud\",\"sandalwood\"], [\"vanilla\"]"
    },
    "response_format": {
      "enum": [
        "concise",
        "detailed"
      ],
      "type": "string",
      "default": "concise",
      "description": "concise (default) or detailed (adds pyramid, seasons, occasions, longevity)."
    }
  }
}