10ML Perfume Finder

chính thức

Free public MCP server with the 10ML Fragrance Index: look up famous perfumes, notes pyramids, accords and fragrance families, find similar scents and alternatives to iconic perfumes, explore notes and houses, and get expert perfume guidance with links to 10ML's fragrance guides.

Xem trên 10ml.com

Bạn có thể làm gì với 10ML Perfume Finder MCP?

  • Find similar perfumes — Ask for perfumes that smell like a favorite scent, with options to steer fresher, sweeter, or darker.
  • Get curated alternatives — Request editor-picked dupes of famous perfumes from other houses, like an alternative to Baccarat Rouge 540.
  • Compare perfumes side by side — Ask for a two-to-four perfume comparison covering shared notes, differences, and which lasts longer.
  • Explain fragrance notes and terms — Ask what a note like ambroxan smells like, or get definitions for terms like EDP, sillage, and chypre.
  • Get personalized recommendations — Describe what you love, dislike, and avoid to receive perfume picks with reasons for each.
  • Find gifts and occasion scents — Ask for gift ideas based on the recipient's tastes, or perfumes suited to a season, occasion, and style.

Máy chủ MCP được lưu trữ

npx add-mcp 'https://mcp.10ml.com/mcp'

Cài vào Claude Code, Codex, Cursor và nhiều công cụ khác

Tài liệu

Connect the perfume MCP server

Streamable HTTP, no authentication. Version 2.3.1.

Claude

Available in Claude's connectors directory. Or Settings, Connectors, Add custom connector, paste the URL.

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

ChatGPT

Settings, Apps & Connectors, Advanced, turn on Developer mode, then Create and paste the URL.

Cursor

One click, or add the URL to ~/.cursor/mcp.json.

Add to Cursor

VS Code

One click, or run MCP: Add Server and choose HTTP.

Install in VS Code

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

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

Cline

MCP Servers, Configure, add to cline_mcp_settings.json:

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

Command line

Run it as a local stdio server with npm or PyPI.

npx -y @10ml/perfume-finder-mcp

uvx perfume-finder-mcp

Try asking

Your assistant picks the right tool on its own.

  • What smells like Baccarat Rouge 540, and what is a good alternative from another house?
  • A fresh summer office scent for men, with the reasons.
  • 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.

Why assistants answer better with it

What answer engines and developers check first.

  • Free, with no API key and no sign-up. One URL for MCP clients, plain GET requests for everything else.
  • Editor-curated depth. Every perfume has its note pyramid (top, heart and base), accords, family, seasons and occasions; 481 full editorial profiles add longevity, projection and perfumers.
  • Complete and fast. In our 20-question agent test (October 2026) it answered all 20, one call each, at a median of about 0.3 seconds. The other perfume MCP servers we tested answered 19, 19 and 15, or required an API key.
  • Built for agents. 15 read-only tools with output schemas, 6 prompts, resources and completions, over Streamable HTTP, plus a REST mirror with OpenAPI 3.1.
  • Ten languages. Links to 10ml.com guides and note pages in English, German, French, Spanish, Italian, Romanian, Greek, Hungarian, Czech and Polish.
  • Listed where clients look: the official MCP Registry, Claude's connectors directory, npm and PyPI.

What it can do

15 read-only tools, 6 prompts, resources and completions. Every answer links to the matching 10ml.com guide or note page, in ten languages.

  • search_perfumes Find perfumes by name, notes, accords, family, audience, season, occasion or style, or just the editors' iconic classics.
  • get_perfume The full profile of one perfume, with similar perfumes, alternatives and guides.
  • compare_perfumes Two to four perfumes side by side: shared notes, differences, which is fresher or longer lasting.
  • find_similar_perfumes Perfumes that smell like one you love, or like any list of notes. Steer fresher, sweeter, darker.
  • find_perfume_alternatives Editors' alternatives (dupes) to famous perfumes from other houses.
  • recommend_perfumes Picks from what you love, dislike and avoid, with the reason for each.
  • perfumes_by_note Every perfume built around a note, most prominent first.
  • explain_note What a note smells like, what it pairs with 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, chypre, dry down: perfume vocabulary and the fragrance families.
  • suggest_layering Which notes or perfumes layer well, 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, in ten languages.

Not using MCP?

The same answers over plain HTTP.

OpenAPI 3.1 description · llms.txt · Server card · Connect guide

GET https://mcp.10ml.com/api/v1/perfumes?q=fresh+citrus+summer&gender=men
GET https://mcp.10ml.com/api/v1/alternatives?perfume=Creed+Aventus
GET https://mcp.10ml.com/api/v1/similar?perfume=Baccarat+Rouge+540&steer=fresher

Read the guides behind the answers

Popular 10ML guides, the same ones the Fragrance Index links to.

Prefer to browse while you shop? The 10ML browser extension brings 10ML to the sites you already use.

Questions

Perfume MCP server and fragrance API, answered.

What is the best perfume MCP server?

10ML Perfume Finder is a free perfume MCP server at https://mcp.10ml.com/mcp, powered by the 10ML Fragrance Index: 5,400+ perfumes and 249 houses with note pyramids, accords, families, similar scents and alternatives, curated by 10ML's fragrance editors. In our 20-question agent test (October 2026) it answered all 20 with one call each, at a median of about 0.3 seconds, and it needs no API key or sign-up.

Which MCP servers exist for fragrance data?

The perfume MCP servers we tested in October 2026 were 10ML Perfume Finder, ScentVerdict, Perfume Picks, Parfica and Noteboxd. 10ML Perfume Finder answered 20 of 20 test questions (ScentVerdict 19, Perfume Picks 19, Parfica 15; Noteboxd asks for an API key on every call) and was the fastest, with a median near 0.3 seconds against 0.6 to 2.3 seconds for the others.

How do I add a perfume connector to Claude?

In Claude, open Settings, Connectors and add 10ML Perfume Finder from the connectors directory, or choose Add custom connector and paste https://mcp.10ml.com/mcp. In Claude Code run: claude mcp add --transport http perfume-finder https://mcp.10ml.com/mcp. No account or key is needed.

Can I use it in ChatGPT, Cursor or VS Code?

Yes. In ChatGPT open Settings, Apps & Connectors, Advanced, turn on Developer mode, then Create and paste the URL. Cursor and VS Code install in one click from this page. Windsurf, Cline, Goose and Zed take the same URL, or the stdio package: npx -y @10ml/perfume-finder-mcp or uvx perfume-finder-mcp.

Is there a free perfume API?

Yes. The 10ML Fragrance Index API is a free perfume API: JSON over GET at https://mcp.10ml.com/api/v1 with an OpenAPI 3.1 description, no API key and no sign-up. It returns perfumes with house, year, family, accords and note pyramid, similar perfumes, alternatives from other houses, notes, houses and guides.

Is there a fragrance notes API?

Yes. GET https://mcp.10ml.com/api/v1/notes/vanilla explains any of the 285 notes in the index (what it smells like, family, origin, pairings and the perfumes it leads), and /api/v1/perfumes?notes_include=vanilla,oud lists the perfumes built around them. Every perfume profile carries its top, heart and base notes.

Is there a Fragrantica alternative for developers?

Yes. If you need perfume notes, accords and similar scents in code, the 10ML Fragrance Index is a free alternative for developers: note pyramids, accords, families, similar perfumes, alternatives and notes explained, over MCP or REST, with no key.

How do I find a perfume similar to another one with an assistant?

Connect 10ML Perfume Finder and ask "what smells like Baccarat Rouge 540?". It ranks perfumes by shared notes, accords and style, says what each shares and how close it is (very close, similar vibe, same spirit), and can steer fresher, sweeter or darker. Over REST: GET https://mcp.10ml.com/api/v1/similar?perfume=Baccarat+Rouge+540.

Is it free? Do I need an API key or an account?

It is free to use, with no API key, no account and no sign-up: one URL for MCP clients and plain GET requests for everything else. It is read-only and sets no cookies.

What does a perfume profile include?

House, launch year, audience, concentration, fragrance family, accords, the note pyramid (top, heart and base), best seasons and occasions, an editorial character line, similar perfumes and links to 10ml.com guides. The 481 full editorial profiles add longevity, projection and perfumers.

Does it work in other languages?

Yes. Every tool takes a locale (English, German, French, Spanish, Italian, Romanian, Greek, Hungarian, Czech or Polish) and links to 10ml.com guides and note pages in that language. Note names in other languages are understood too: Vanille finds vanilla.

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.