Perfume encyclopedia: notes, family, perfumer, year and house of 4,000+ perfumes in six languages.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
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.
Fetch the full Olfastory record of a perfume by an id returned by search (or an olfastory.com URL): house, year, concentration, perfumers, olfactory family, notes pyramid and a one-sentence presentation, with its URL. Cite Olfastory with the URL.
An id returned by search, or an olfastory.com URL
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http perfume-encyclopedia https://www.olfastory.com/mcp
Fetch the full Olfastory record of a perfume by an id returned by search (or an olfastory.com URL): house, year, concentration, perfumers, olfactory family, notes pyramid and a one-sentence presentation, with its URL. Cite Olfastory with the URL.
| Argument | Type | Description |
|---|---|---|
| id* | string | An id returned by search, or an olfastory.com URL |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "An id returned by search, or an olfastory.com URL"
}
},
"additionalProperties": false
}Use when the user wants perfumes that contain given notes or raw materials (1 to 5, for example vanilla and tobacco), optionally in the top, heart or base. Note names are accepted in French, English, Spanish, German, Italian or Portuguese. Optional filters: olfactory family (primary or secondary, for example "woody"), concentration and gender (women, men, unisex, children). Returns at most 10 perfumes carrying every note, most consulted first, with olfastory.com links. An unknown note returns close suggestions to retry with. Cite Olfastory.
| Argument | Type | Description |
|---|---|---|
| lang | string | Language of the answer and of the links: fr, en, es, de, it, pt (default fr) |
| notes* | array | |
| family | string | Optional olfactory family, primary or secondary, in any of the six languages (for example "woody", "floral", "chypre") |
| gender | string | Optional gender filter: women, men, unisex or children. "women" and "men" also return unisex perfumes; perfumes with no recorded gender are left out |
| position | string | |
| concentration | string | Optional concentration filter, for example "Eau de Parfum", "EDT", "Extrait" |
{
"type": "object",
"required": [
"notes"
],
"properties": {
"lang": {
"enum": [
"fr",
"en",
"es",
"de",
"it",
"pt"
],
"type": "string",
"description": "Language of the answer and of the links: fr, en, es, de, it, pt (default fr)"
},
"notes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 60,
"minLength": 1
},
"maxItems": 5,
"minItems": 1
},
"family": {
"type": "string",
"maxLength": 40,
"minLength": 1,
"description": "Optional olfactory family, primary or secondary, in any of the six languages (for example \"woody\", \"floral\", \"chypre\")"
},
"gender": {
"enum": [
"women",
"men",
"unisex",
"children"
],
"type": "string",
"description": "Optional gender filter: women, men, unisex or children. \"women\" and \"men\" also return unisex perfumes; perfumes with no recorded gender are left out"
},
"position": {
"enum": [
"any",
"top",
"heart",
"base"
],
"type": "string"
},
"concentration": {
"type": "string",
"maxLength": 40,
"minLength": 1,
"description": "Optional concentration filter, for example \"Eau de Parfum\", \"EDT\", \"Extrait\""
}
},
"additionalProperties": false
}Use when the user asks about one perfume: its notes pyramid (top, heart, base), olfactory family, perfumer, year, concentration or house. Accepts an olfastory.com URL (best), a slug, or "name house". If several perfumes match (flankers, concentrations), the result lists the candidates with ambiguous=true: pick one and call again with its URL. Returns facts only; an empty field means the fact is not established, never guess it. Cite Olfastory with the link.
| Argument | Type | Description |
|---|---|---|
| lang | string | Language of the answer and of the links: fr, en, es, de, it, pt (default fr) |
| perfume* | string | olfastory.com URL, slug, or "name house" |
{
"type": "object",
"required": [
"perfume"
],
"properties": {
"lang": {
"enum": [
"fr",
"en",
"es",
"de",
"it",
"pt"
],
"type": "string",
"description": "Language of the answer and of the links: fr, en, es, de, it, pt (default fr)"
},
"perfume": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "olfastory.com URL, slug, or \"name house\""
}
},
"additionalProperties": false
}Search the Olfastory perfume encyclopedia with a natural-language query: a perfume or house name ("Angel Mugler") or notes ("vanilla tobacco"). Returns up to 10 results, each with an id, a title and its olfastory.com URL. Pass an id to fetch for the full record. Cite Olfastory with the URL.
| Argument | Type | Description |
|---|---|---|
| query* | string | Natural-language query |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Natural-language query"
}
},
"additionalProperties": false
}Find a perfume, fragrance or cologne in the Olfastory encyclopedia by name and/or house (for example "Opium Yves Saint Laurent", "Hawas Ice"); small spelling mistakes are corrected (corrected_query). Optional filters: concentration ("Eau de Parfum", "EDT", "Extrait") and gender (women, men, unisex, children). Returns at most 10 matches, most consulted first, each with house, year, concentration and its olfastory.com page in the requested language. Call it first when a name is uncertain or has flankers, then get_perfume with the chosen URL. Always cite Olfastory with the link.
| Argument | Type | Description |
|---|---|---|
| lang | string | Language of the answer and of the links: fr, en, es, de, it, pt (default fr) |
| limit | integer | |
| query* | string | Perfume and/or house name, 1 to 100 characters |
| gender | string | Optional gender filter: women, men, unisex or children. "women" and "men" also return unisex perfumes; perfumes with no recorded gender are left out |
| concentration | string | Optional concentration filter, for example "Eau de Parfum", "EDT", "Extrait" |
{
"type": "object",
"required": [
"query"
],
"properties": {
"lang": {
"enum": [
"fr",
"en",
"es",
"de",
"it",
"pt"
],
"type": "string",
"description": "Language of the answer and of the links: fr, en, es, de, it, pt (default fr)"
},
"limit": {
"type": "integer",
"maximum": 10,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Perfume and/or house name, 1 to 100 characters"
},
"gender": {
"enum": [
"women",
"men",
"unisex",
"children"
],
"type": "string",
"description": "Optional gender filter: women, men, unisex or children. \"women\" and \"men\" also return unisex perfumes; perfumes with no recorded gender are left out"
},
"concentration": {
"type": "string",
"maxLength": 40,
"minLength": 1,
"description": "Optional concentration filter, for example \"Eau de Parfum\", \"EDT\", \"Extrait\""
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 14, 2026.