10ML Perfume Finder

What is 10ML Perfume Finder

10ML Perfume Finder is a free perfume MCP server and fragrance API that provides AI assistants like Claude, ChatGPT, and others with expert perfume knowledge. Curated by 10ML's fragrance editors, it offers detailed information on perfume notes, accords, families, houses, similar scents, alternatives, layering, and guides. The service is read-only and requires no sign-in.

How to use 10ML Perfume Finder

To connect the perfume MCP server (Streamable HTTP, no authentication, version 2.2.0):

• Claude: Available in Claude's connectors directory, or go to Settings > Connectors > Add custom connector and paste the URL. Alternatively, use the command: claude mcp add --transport http perfume-finder https://mcp.10ml.com/mcp
• ChatGPT: Go to Settings > Apps & Connectors > Advanced, turn on Developer mode, then click Create and paste the URL.
• Cursor: One-click install via the provided button, or add the URL to ~/.cursor/mcp.json.
• VS Code: One-click install, or run MCP: Add Server and choose HTTP.
• Windsurf: Add to ~/.codeium/windsurf/mcp_config.json with the configuration: { "mcpServers": { "perfume-finder": { "serverUrl": "https://mcp.10ml.com/mcp" } } }
• Cline: In MCP Servers, Configure, add to cline_mcp_settings.json: { "mcpServers": { "perfume-finder": { "url": "https://mcp.10ml.com/mcp", "type": "streamableHttp" } } }
• Command line: Run as a local stdio server using npm (npx -y @10ml/perfume-finder-mcp) or PyPI (uvx perfume-finder-mcp).

Once connected, you can ask natural language questions and the assistant will automatically select the appropriate tool.

Features of 10ML Perfume Finder

• 15 read-only tools covering perfume search, comparison, recommendations, note explanations, house information, layering suggestions, occasion picks, gift ideas, and guide search.
• 6 prompts, resources, and completions to enhance AI interactions.
• Extensive database: 4,604 perfumes profiled, 285 notes explained, 249 houses, and 164 guides in 10 languages.
• Every answer links to matching 10ML guides or note pages in ten languages.
• Plain HTTP API also available for non-MCP use, with OpenAPI 3.1 description, llms.txt, and server card.
• Free and open: No sign-in required, read-only access.

Use Cases of 10ML Perfume Finder

• Find perfumes similar to a favorite scent (e.g., "What smells like Baccarat Rouge 540?").
• Get alternatives from other houses for popular fragrances.
• Discover a fresh summer office scent for men with reasons.
• Learn about specific notes like ambroxan and which perfumes feature them.
• Get layering advice (e.g., how to layer vanilla and citrus).
• Find gift ideas for someone who loves a particular perfume (e.g., Delina).
• Compare two or more perfumes side by side (e.g., Dior Sauvage vs. Tom Ford Ombre Leather).
• Search perfumes by notes, accords, family, audience, season, occasion, or style.
• Explain perfume terminology (EDP, sillage, chypre, dry down) and fragrance families.
• Browse perfume houses by type or country.
• Get perfume recommendations based on likes, dislikes, and avoidances.
• Pick perfumes for specific occasions, seasons, audiences, and styles.
• Find gifts based on recipient preferences and adventure level.
• Search guides and articles in ten languages.

FAQ

Is 10ML Perfume Finder free?
Yes, it is completely free and requires no sign-in.

What AI assistants are supported?
It works with Claude, ChatGPT, Cursor, VS Code, Windsurf, Cline, and any assistant that supports MCP or HTTP APIs.

Do I need authentication?
No, the MCP server uses Streamable HTTP without authentication.

Can I use it without MCP?
Yes, the same answers are available over plain HTTP via the API endpoints.

How many perfumes are in the database?
The index includes 4,604 perfumes, 285 notes, 249 houses, and 164 guides in 10 languages.

What tools are available?
There are 15 read-only tools, including search_perfumes, get_perfume, compare_perfumes, find_similar_perfumes, find_perfume_alternatives, recommend_perfumes, perfumes_by_note, explain_note, get_house, list_houses, explain_perfume_term, suggest_layering, pick_for_occasion, find_gift, and search_guides.