# 10ML Perfume Finder MCP server > Search perfumes, notes, houses, similar scents, alternatives and layering ideas from the 10ML Fragrance Index. - Listing: https://mcp.tc/i/10ml-perfume-finder - Connect: use the server's own URL `https://mcp.10ml.com/mcp` (no sign-in); clients connect to it directly. The listing link is a page, not an MCP endpoint. - Type: remote (Streamable HTTP) - Auth: none - Category: [Utilities](https://mcp.tc/c/utilities) - Vendor: 10ML - Homepage: ## About Connects to the 10ML Fragrance Index, a read-only catalog of about 6,000 perfumes, 285 notes, 249 houses and 164 guides curated by 10ML's fragrance editors. You can search by description, get note pyramids and accords, compare perfumes, find similar scents or alternatives from other houses, get gift and occasion picks, and look up perfume terms. Runs as a hosted Streamable HTTP endpoint at https://mcp.10ml.com/mcp. No sign-in or API key is needed. A local stdio package is also available through npx or uvx. Tools accept a locale for links in ten languages. ## What it can do - Search perfumes by notes, accords, family, season, occasion or style - Get full perfume profiles with note pyramids - Compare two to four perfumes side by side - Find similar perfumes or editorial alternatives from other houses - Recommend perfumes from likes, dislikes and notes - Suggest gifts and perfumes for an occasion - Explain notes and perfume vocabulary - Suggest layering combinations ## Tools (15) - `search_perfumes`: Search perfumes by name, house, notes, accords, family, audience, season, occasion or style. (read-only) - `get_perfume`: Full profile of one perfume with notes, accords, similar perfumes and alternatives. (read-only) - `compare_perfumes`: Compare 2 to 4 perfumes: shared notes, differences and overall closeness. (read-only) - `find_similar_perfumes`: Find perfumes that smell like one you like, optionally steered fresher or sweeter. (read-only) - `find_perfume_alternatives`: Editors' alternatives (dupes) to famous perfumes from other houses. (read-only) - `recommend_perfumes`: Personal picks from loved and disliked perfumes and notes, with reasons. (read-only) - `perfumes_by_note`: List perfumes built around a note, most prominent first. (read-only) - `explain_note`: Explain a fragrance note: scent, family, pairings and famous perfumes. (read-only) - `get_house`: Profile of a perfume house with style and signature perfumes. (read-only) - `list_houses`: Browse perfume houses filtered by type, country or name. (read-only) - `explain_perfume_term`: Explain perfume vocabulary and fragrance families. (read-only) - `suggest_layering`: Layering ideas from notes or perfumes, with spraying tips. (read-only) - `pick_for_occasion`: Perfume picks for a season, occasion, audience or style. (read-only) - `find_gift`: Perfume gift ideas based on the recipient and their tastes. (read-only) - `search_guides`: Find 10ML perfume guides to read or cite. (read-only) ## Example prompts - "What smells like Baccarat Rouge 540, and what is a good alternative from another house?" - "Suggest a fresh summer office scent for men." - "Compare Dior Sauvage and Tom Ford Ombre Leather." - "How would I layer vanilla and citrus?" ## Install ### Claude Code 1. Run this in a terminal, in your project folder: ```bash claude mcp add --transport http 10ml-perfume-finder https://mcp.10ml.com/mcp ``` 2. Start Claude Code and type `/mcp`. **10ml-perfume-finder** should show as connected. Add `--scope user` to make it available in every project, not just this one. ### Claude Desktop 1. Open **Customize → Connectors**, click **+ Add**, then **Add custom connector**. 2. Name it **10ML Perfume Finder** and paste this URL: ```url https://mcp.10ml.com/mcp ``` 3. Click **Add**. Its tools appear in the chat’s tools menu. Claude Desktop’s JSON config file only starts local servers. Remote servers go through Connectors, and connectors you add on claude.ai show up here too. ### claude.ai 1. Open the connector form on claude.ai. This button fills in the name and URL for you: [Add to claude.ai]() (opens connector settings) 2. Check that the URL reads `https://mcp.10ml.com/mcp` and click **Add**. 3. Turn it on in a chat from the tools menu. Free plans allow one custom connector. On Team and Enterprise plans an owner adds it under **Organization settings → Connectors**. ### ChatGPT 1. On chatgpt.com, open **Settings → Security and login** and turn on **Developer mode**. 2. Go to `chatgpt.com/plugins` and click **+** to create an app for a remote MCP server. 3. Paste `https://mcp.10ml.com/mcp` as the server URL and choose **No authentication**. Developer mode is available on the web for Plus, Pro, Business, Enterprise and Education accounts. ### Cursor [Add to Cursor]() (opens Cursor) Or add it by hand to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (this project): `mcp.json`: ```json { "mcpServers": { "10ml-perfume-finder": { "url": "https://mcp.10ml.com/mcp" } } } ``` ### VS Code [Install in VS Code]() (opens VS Code) Or from a terminal: ```bash code --add-mcp '{"name":"10ml-perfume-finder","type":"http","url":"https://mcp.10ml.com/mcp"}' ``` Or commit it to the repo in `.vscode/mcp.json`: `.vscode/mcp.json`: ```json { "servers": { "10ml-perfume-finder": { "type": "http", "url": "https://mcp.10ml.com/mcp" } } } ``` ### Devin Desktop 1. Add it to `~/.config/devin/mcp_config.json` (macOS and Linux) or `%APPDATA%\devin\mcp_config.json` (Windows): `mcp_config.json`: ```json { "mcpServers": { "10ml-perfume-finder": { "serverUrl": "https://mcp.10ml.com/mcp" } } } ``` 2. Refresh the MCP server list in Cascade. Devin Desktop is the new name for Windsurf. It reads `serverUrl` (or `url`) for remote servers. ### Codex ```bash codex mcp add 10ml-perfume-finder --url https://mcp.10ml.com/mcp ``` Or edit `~/.codex/config.toml` directly: `config.toml`: ```toml [mcp_servers.10ml-perfume-finder] url = "https://mcp.10ml.com/mcp" ``` ### Gemini CLI ```bash gemini mcp add --transport http 10ml-perfume-finder https://mcp.10ml.com/mcp ``` This adds it to the current project. Add `-s user` to use it everywhere. ### Any client Most clients accept this shape. Some name the URL field differently: `serverUrl` in Devin Desktop, `httpUrl` in Gemini CLI’s settings file. ```json { "mcpServers": { "10ml-perfume-finder": { "type": "http", "url": "https://mcp.10ml.com/mcp" } } } ``` Zed puts servers under `context_servers` in its settings. Cline needs `"type": "streamableHttp"`, or it assumes SSE. Client only starts local servers? Bridge it with `npx -y mcp-remote https://mcp.10ml.com/mcp`. ## Recent changes - 2026-10-22 16:42 UTC: 15 tools changed. Source: automatic check. Changed: compare\_perfumes, explain\_note, explain\_perfume\_term, find\_gift, find\_perfume\_alternatives, find\_similar\_perfumes, get\_house, get\_perfume, list\_houses, perfumes\_by\_note, pick\_for\_occasion, recommend\_perfumes, search\_guides, search\_perfumes, suggest\_layering. - 2026-10-22 01:39 UTC: New version 2.5.1 (was 2.5.0), reported by the server. Source: automatic check. - 2026-10-22 01:39 UTC: 15 tools changed. Source: automatic check. Changed: compare\_perfumes, explain\_note, explain\_perfume\_term, find\_gift, find\_perfume\_alternatives, find\_similar\_perfumes, get\_house, get\_perfume, list\_houses, perfumes\_by\_note, pick\_for\_occasion, recommend\_perfumes, search\_guides, search\_perfumes, suggest\_layering. - 2026-10-21 13:27 UTC: Tracking started: 15 tools read. Source: automatic check. More on the History tab, with descriptions before and after for the newest entries: https://mcp.tc/i/10ml-perfume-finder#history (Atom feed: https://mcp.tc/i/10ml-perfume-finder/history.xml). It records what mcp.tc's anonymous checks saw, every 3 hours where the tool list can be read without sign-in; it is not a security review. ## Details - Server version: 2.5.3 - MCP protocol version: 2025-11-25 - Last checked: 2026-10-24 (reachable) - Listed: 2026-10-21 - Updated: 2026-10-21 --- Source: https://mcp.tc/i/10ml-perfume-finder (mcp.tc is an independent directory, not affiliated with this server's publisher). Corrections: https://mcp.tc/report