10ML Perfume Finder — Claude Code MCP server: scents and notes
Gives your agent a fragrance database of 5,400+ perfumes and 285 notes: similar scents, side-by-side comparison, occasion picks. Handy for anything scent-related.
claude mcp add --transport http perfume-finder https://mcp.10ml.com/mcpWhat 10ML Perfume Finder does
The server speaks Streamable HTTP at a single address, https://mcp.10ml.com/mcp. No sign-in, no API key, read-only. Fifteen tools sit behind it. search_perfumes matches on name, house, notes, accords and family, get_perfume returns the note pyramid plus five similar scents, and compare_perfumes lines up two to four bottles and shows which notes they share and which they do not.
Other calls cover everyday questions: find_gift builds a present from what someone likes, suggest_layering says what to spray with what, pick_for_occasion narrows by season and setting. Six prompts ship alongside, among them find_signature_scent and build_fragrance_wardrobe. Every tool takes locale for links and labels — en, de, fr, es, it, ro, el, hu, cs, pl.
Clients that launch local processes can run the same server over stdio: npx -y @10ml/perfume-finder-mcp on Node.js 18+, or uvx perfume-finder-mcp on Python 3.10+. The names iconic_perfumes and trending_perfumes still answer as aliases for older integrations, though they no longer appear in the tool list — if your setup calls them, move to search_perfumes with iconic: true.
What it helps with
- find a scent close to a favourite but fresher
- compare two perfumes by shared and unique notes
- explain what ambroxan smells like and where it leads
- pick a gift from someone's taste
- get layering ideas for vanilla and citrus
Example prompts for the agent
- Find a fresh summer office scent for men and explain why each one fits
- Compare two perfumes by their note pyramids and tell me what they share
How to install 10ML Perfume Finder
1Platform CLI: remote server
claude mcp add --transport http perfume-finder https://mcp.10ml.com/mcp2Platform CLI
claude mcp add 10ml-perfume-finder -- npx -y @10ml/perfume-finder-mcp1Platform CLI: remote server
codex mcp add 10ml-perfume-finder --url https://mcp.10ml.com/mcp2Platform CLI
codex mcp add 10ml-perfume-finder -- npx -y @10ml/perfume-finder-mcpConfig file
{
"mcpServers": {
"10ml-perfume-finder": {
"url": "https://mcp.10ml.com/mcp"
}
}
}{
"mcpServers": {
"10ml-perfume-finder": {
"command": "npx",
"args": [
"-y",
"@10ml/perfume-finder-mcp"
]
}
}
}Config file
{
"servers": {
"10ml-perfume-finder": {
"type": "http",
"url": "https://mcp.10ml.com/mcp"
}
}
}{
"servers": {
"10ml-perfume-finder": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@10ml/perfume-finder-mcp"
]
}
}
}1Platform CLI: remote server
gemini mcp add -t http 10ml-perfume-finder https://mcp.10ml.com/mcp2Platform CLI
gemini mcp add 10ml-perfume-finder npx -y @10ml/perfume-finder-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about 10ML Perfume Finder
How do I install 10ML Perfume Finder in Claude Code?
Run claude mcp add --transport http perfume-finder https://mcp.10ml.com/mcp. For a local process instead, use claude mcp add 10ml-perfume-finder -- npx -y @10ml/perfume-finder-mcp.
What does 10ML Perfume Finder do?
It hands your agent a fragrance index: search by notes and accords, full profiles, comparisons, similar scents and editorial alternatives. All fifteen tools are read-only.
Do I need an API key or an account?
No. The server is free, needs no sign-in and no authentication, and runs over Streamable HTTP. The stdio route requires Node.js 18+ or Python 3.10+.
