10ML Perfume Finder

공식

10ML 향수 인덱스를 갖춘 무료 공개 MCP 서버입니다. 유명 향수, 노트 피라미드, 어코드 및 향 계열을 조회하고, 상징적인 향수의 유사 향과 대체 향을 찾고, 노트와 하우스를 탐색하며, 10ML의 향 가이드 링크와 함께 전문가의 향수 안내를 받을 수 있습니다.

10ml.com에서 보기

10ML Perfume Finder MCP(으)로 무엇을 할 수 있나요?

  • 유사한 향수 찾기 — 좋아하는 향과 비슷한 냄새가 나는 향수를 요청하고, 더 상쾌하게, 더 달콤하게, 또는 더 어둡게 방향을 조정하는 옵션을 받아보세요.
  • 엄선된 대안 추천받기 — Baccarat Rouge 540의 대안처럼, 다른 하우스의 유명 향수에 대한 에디터가 고른 듀프를 요청하세요.
  • 향수 나란히 비교하기 — 공통 노트, 차이점, 그리고 더 오래 지속되는 제품을 다루는 2~4개 향수 비교를 요청하세요.
  • 향료 노트와 용어 설명 듣기 — 앰브록산 같은 노트가 어떤 냄새인지 물어보거나, EDP, 실라주, 시프레 같은 용어의 정의를 받아보세요.
  • 개인 맞춤 추천받기 — 좋아하는 것, 싫어하는 것, 피하고 싶은 것을 설명하고 각각의 이유가 담긴 향수 추천을 받아보세요.
  • 선물과 상황별 향 찾기 — 받는 사람의 취향에 맞는 선물 아이디어나 계절, 상황, 스타일에 어울리는 향수를 요청하세요.

호스팅형 MCP 서버

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

Claude Code, Codex, Cursor 등에 설치됩니다

문서

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.