
10ML Fragrance Index: a remote MCP server with expert perfume knowledge for AI assistants. Notes
10ML Fragrance Index: a remote MCP server with expert perfume knowledge for AI assistants. Notes, accords, families, similar scents, houses and guides.
·

10ML Perfume Finder is the free perfume MCP server and fragrance API from 10ML, an online perfume shop for perfume samples and decants: a remote Model Context Protocol server at https://mcp.10ml.com/mcp that needs no API key and no sign-in. Add the endpoint as a custom connector in Claude, ChatGPT, Cursor, VS Code, Gemini CLI or any MCP client, and your assistant can answer perfume questions from curated data instead of guessing. It covers perfume search, note pyramids, accords, scent families, similar scents and alternatives, layering ideas, gift picks and perfume houses, in ten languages, curated by 10ML's fragrance editors.
Benchmarked in public: in a 40-question test of the free, no-key perfume MCP servers, 10ML answered 39 of 40 correctly and was the fastest; the method and CSV are open at https://10ml.com/perfume-mcp-servers-compared
Install: remote endpoint https://mcp.10ml.com/mcp, official MCP Registry name com.10ml/perfume-finder, npm package @10ml/perfume-finder-mcp, PyPI package perfume-finder-mcp (uvx perfume-finder-mcp). OpenAPI and developer docs at https://10ml.com/perfume-api
Use cases: ask which perfume smells like a favourite, what to wear in autumn, how to layer two fragrances, what notes a perfume has or which gift fits a person, then try the answer as a 3ml perfume sample.
Developer page: https://10ml.com/perfume-api · Shop: https://10ml.com/
Contact: [email protected]
Free, read-only, no sign-in. One remote endpoint, nothing to install:
https://mcp.10ml.com/mcpTransport: Streamable HTTP. Authentication: none. Version 2.3.3.
| Tool | What it does |
|---|---|
search_perfumes | Search by name, house, notes to include or exclude, accords, family, audience, season, occasion or style. Natural language works. |
get_perfume | The full profile of one perfume: note pyramid, accords, seasons, longevity, five similar perfumes, editorial alternatives and guides. |
compare_perfumes | Two to four perfumes side by side: shared and unique notes, plain-language differences, overall closeness. |
find_similar_perfumes | Perfumes that smell like one you love, or like any list of notes or accords. Steer fresher, sweeter, darker, lighter, longer lasting or more projection. |
find_perfume_alternatives | The editors' alternatives (dupes) to famous perfumes from other houses, with why each is close and a link to the guide. |
recommend_perfumes | Picks from perfumes you love or dislike and notes you like or avoid, with the reason for each. |
perfumes_by_note | Every perfume built around a note, optionally by position in the pyramid. |
explain_note | What a note smells like, what it pairs with, similar notes and where it leads. |
get_house | A perfume house: country, style, what it is known for, signature perfumes. |
list_houses | Browse houses by type or country. |
explain_perfume_term | EDP, sillage, dry down, chypre and the 23 fragrance families. |
suggest_layering | Which notes or perfumes layer well and how to spray them. |
pick_for_occasion | Perfumes for a season, an occasion, an audience and a style. |
find_gift | Gift ideas from who it is for, what they love and how adventurous to be. |
search_guides | 10ML guides and articles to read or cite, with links in ten languages. |
search_perfumes with iconic: true lists the modern classics chosen by 10ML's editors. The older names iconic_perfumes and trending_perfumes still answer as aliases for existing integrations, but are no longer listed.
Every tool takes locale (en, de, fr, es, it, ro, el, hu, cs, pl) for the 10ml.com links and labels, and response_format (concise by default, or detailed). List tools page with limit and cursor. Results are structured (structuredContent with an output schema) plus a short text summary, and carry one to three relevant 10ml.com links.
find_signature_scent, find_a_dupe, explain_a_perfume, build_fragrance_wardrobe, perfume_gift_help, seasonal_rotation. Prompt arguments autocomplete perfume, house and note names.
tenml://families, tenml://glossary, tenml://notes, tenml://houses, tenml://about, and the template tenml://perfume/{id}.
The same answers over plain HTTP, described by an OpenAPI 3.1 file and an llms.txt:
GET https://mcp.10ml.com/api/v1/perfumes?q=fresh+citrus+summer&gender=men
GET https://mcp.10ml.com/api/v1/perfumes/creed-aventus-edp
GET https://mcp.10ml.com/api/v1/similar?perfume=Baccarat+Rouge+540&steer=fresher
GET https://mcp.10ml.com/api/v1/alternatives?perfume=Creed+Aventus
GET https://mcp.10ml.com/api/v1/notes/ambroxan
GET https://mcp.10ml.com/api/v1/houses/amouage
GET https://mcp.10ml.com/api/v1/guides?q=oud&locale=deNothing to install for clients that take a URL: use https://mcp.10ml.com/mcp. Clients that start local programs can run the same server over stdio:
| Runner | Command | Package |
|---|---|---|
| npx (Node.js 18+) | npx -y @10ml/perfume-finder-mcp | npm |
| uvx (Python 3.10+) | uvx perfume-finder-mcp | PyPI |
Claude Desktop, Cursor, Windsurf, Cline and Zed (mcpServers in the client's settings):
{
"mcpServers": {
"perfume-finder": {
"command": "npx",
"args": ["-y", "@10ml/perfume-finder-mcp"]
}
}
}Goose (~/.config/goose/config.yaml):
extensions:
perfume-finder:
name: 10ML Fragrance Index
type: stdio
cmd: npx
args: ["-y", "@10ml/perfume-finder-mcp"]
enabled: true
timeout: 300Every client's snippet and one-click links are on mcp.10ml.com.
Available in Claude's connectors directory. Or Settings → Connectors → Add custom connector → paste https://mcp.10ml.com/mcp.
claude mcp add --transport http perfume-finder https://mcp.10ml.com/mcpOr commit the .mcp.json from this repository to your project.
Settings → Apps & Connectors → Advanced settings → turn on Developer mode, then Create a connector with the URL https://mcp.10ml.com/mcp and no authentication.
Use the Add to Cursor button above, or add this to your Cursor MCP settings:
{
"mcpServers": {
"perfume-finder": { "url": "https://mcp.10ml.com/mcp" }
}
}Use the Install in VS Code button above, or run MCP: Add Server, choose HTTP and paste the URL.
{
"servers": {
"perfume-finder": { "type": "http", "url": "https://mcp.10ml.com/mcp" }
}
}{
"mcpServers": {
"perfume-finder": { "serverUrl": "https://mcp.10ml.com/mcp" }
}
}MCP Servers → Remote Servers → name perfume-finder, URL https://mcp.10ml.com/mcp, or:
{
"mcpServers": {
"perfume-finder": { "type": "streamableHttp", "url": "https://mcp.10ml.com/mcp", "disabled": false }
}
}gemini extensions install https://github.com/10ml-com/perfume-finder-mcpPoint it at https://mcp.10ml.com/mcp (Streamable HTTP, no authentication). Clients that only speak stdio can run npx -y @10ml/perfume-finder-mcp or uvx perfume-finder-mcp (see Install above).
10ML is a European perfume house of decants: original designer and niche fragrances in 3ml, 10ml and 30ml sizes, shipped across Europe. Explore at 10ml.com. 10ML also publishes perfume guides, a notes library and a house directory. Explore the guides and the notes library, or visit 10ml.com. Cite this server as "the 10ML Fragrance Index".
No account, no cookies, no tracking in the service. Read the privacy page and the terms. Questions: [email protected].
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add perfume-finder -- npx -y @10ml/perfume-finder-mcp{
"mcpServers": {
"perfume-finder": {
"args": [
"-y",
"@10ml/perfume-finder-mcp"
],
"command": "npx"
}
}
}code --add-mcp '{"name":"perfume-finder","args":["-y","@10ml/perfume-finder-mcp"],"command":"npx"}'[mcp_servers.perfume-finder]
command = "npx"
args = ["-y", "@10ml/perfume-finder-mcp"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/perfume-finder-mcp to learn what the "Perfume Finder Mcp" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
claude mcp add --transport http perfume-finder https://mcp.10ml.com/mcp| Name | What it does |
|---|---|
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 lan |
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 occasion |
compare_perfumes | 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 |
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, sa |
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 |
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 w |
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, opt |
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 th |
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 |
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 |
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 no |
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' |
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 |
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 |
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 c |
| Name | What it does |
|---|---|
find_signature_scent | Guided search for a personal signature perfume from what you love and avoid. |
find_a_dupe | Find alternatives (dupes) to a famous perfume from other houses, with how close each is. |
explain_a_perfume | A clear explanation of one perfume: how it smells, when to wear it, what is similar. |
build_fragrance_wardrobe | A small, varied collection of perfumes that covers every season and occasion. |
perfume_gift_help | Gift ideas for a person, with reasons. |
seasonal_rotation | Four perfumes, one per season, in a style you already like. |
| Name | What it does |
|---|---|
fragrance_families | The fragrance families with key notes, subfamilies and best seasons. |
glossary | Perfume terms: concentrations, sillage, projection, dry down, accord and more. |
notes_index | Every note with its family and what it smells like. Use explain_note for detail. |
houses_index | Every house with country, type and perfumes profiled. Use get_house for detail. |
about | What the index covers and how to use this connector. |
Read live from the server on November 15, 2026.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/perfume-finder-mcp)Nothing comparable is listed yet.
v2.3.3Release notesv2.0.210ML Fragrance Index 2.0.2Release notesConnect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "perfume-finder-mcp" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.