10ML Fragrance Index README

10ML Perfume Finder (perfume MCP server)

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: contact@10ml.com

Free, read-only, no sign-in. One remote endpoint, nothing to install:

Code

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

Transport: Streamable HTTP. Authentication: none. Version 2.3.3.

What you can ask

"What smells like Baccarat Rouge 540, and what is a good alternative from another house?"
"A fresh summer office scent for men, and why each one fits."
"Explain ambroxan and which perfumes lead with it."
"How would I layer vanilla and citrus?"
"A gift for a woman who loves Delina."
"Compare Dior Sauvage and Tom Ford Ombre Leather."
"Like Sauvage, but fresher."
"Which guide explains how to make a perfume last longer?"

Tools (15, all read-only)

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.

Prompts

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.

Resources

tenml://families, tenml://glossary, tenml://notes, tenml://houses, tenml://about, and the template tenml://perfume/{id}.

REST API for agents without MCP

The same answers over plain HTTP, described by an OpenAPI 3.1 file and an llms.txt:

Code

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=de

Install

Nothing 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):

config.json

{
  "mcpServers": {
    "perfume-finder": {
      "command": "npx",
      "args": ["-y", "@10ml/perfume-finder-mcp"]
    }
  }
}

Goose (~/.config/goose/config.yaml):

yaml

extensions:
  perfume-finder:
    name: 10ML Fragrance Index
    type: stdio
    cmd: npx
    args: ["-y", "@10ml/perfume-finder-mcp"]
    enabled: true
    timeout: 300

Every client's snippet and one-click links are on mcp.10ml.com.

Connect

Claude (claude.ai and the desktop app)

Available in Claude's connectors directory. Or Settings → Connectors → Add custom connector → paste https://mcp.10ml.com/mcp.

Claude Code

Terminal

claude mcp add --transport http perfume-finder https://mcp.10ml.com/mcp

Or commit the .mcp.json from this repository to your project.

ChatGPT (developer mode)

Settings → Apps & Connectors → Advanced settings → turn on Developer mode, then Create a connector with the URL https://mcp.10ml.com/mcp and no authentication.

Cursor

Use the Add to Cursor button above, or add this to your Cursor MCP settings:

config.json

{
  "mcpServers": {
    "perfume-finder": { "url": "https://mcp.10ml.com/mcp" }
  }
}

VS Code (GitHub Copilot agent mode)

Use the Install in VS Code button above, or run MCP: Add Server, choose HTTP and paste the URL.

config.json

{
  "servers": {
    "perfume-finder": { "type": "http", "url": "https://mcp.10ml.com/mcp" }
  }
}

Windsurf

config.json

{
  "mcpServers": {
    "perfume-finder": { "serverUrl": "https://mcp.10ml.com/mcp" }
  }
}

Cline

MCP Servers → Remote Servers → name perfume-finder, URL https://mcp.10ml.com/mcp, or:

config.json

{
  "mcpServers": {
    "perfume-finder": { "type": "streamableHttp", "url": "https://mcp.10ml.com/mcp", "disabled": false }
  }
}

Gemini CLI

bash

gemini extensions install https://github.com/10ml-com/perfume-finder-mcp

Any other MCP client

Point 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).

About 10ML

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".

Privacy and terms

No account, no cookies, no tracking in the service. Read the privacy page and the terms. Questions: contact@10ml.com.