10ML Perfume Finder

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:

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)

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:

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:

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

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:

{

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

{

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

Windsurf

{

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

Cline

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 CLI

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.