MCP server

10ML Perfume Finder Official

com.10ml/perfume-finder

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Free perfume MCP server and fragrance API: 6,000+ perfumes, note pyramids, accords, similar scents.

Working at last checkVerified publisher: 10ml.comAbout 7,911 tokens per request once connected15 tools

Website Source

https://mcp.10ml.com/mcp

At a glance

Type: MCP server
Publisher: 10ml.com (verified by the MCP Registry)
Status: Working at last check
Tools: 15
Token cost: About 7,911 tokens per request
Sets up in: Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok
Last checked: 26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to Cursor Add to VS Code VS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.perfume-finder]
url = "https://mcp.10ml.com/mcp"

Gemini CLI

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

Cursor

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

VS Code

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

Antigravity

agy mcp add perfume-finder https://mcp.10ml.com/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"perfume-finder","server_url":"https://mcp.10ml.com/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"perfume-finder","server_url":"https://mcp.10ml.com/mcp"}

Tools

compare_perfumes ~356 tokens
Compare 2 to 4 perfumes or colognes side by side: notes they share, notes only one has, accords, family, audience, launch year, longevity and projection, plus plain-language differences ('A is fresher, B is sweeter and lasts longer') and how close they are overall. Use when someone is choosing betwe
explain_note ~336 tokens
Explain a fragrance note or perfume ingredient: what it smells like, its family and mood, where it comes from, which notes it pairs with, similar notes, famous perfumes where it leads and a link to the 10ML note page or guide when one exists. Covers about 285 notes in many spellings and languages. U
explain_perfume_term ~349 tokens
Explain perfume vocabulary and fragrance families: concentrations (eau de cologne, eau de toilette, eau de parfum, extrait, elixir), sillage, projection, longevity, dry down, accord, top/heart/base notes, flanker, maceration, layering, niche vs designer, plus the 23 fragrance families (chypre, fouge
find_gift ~736 tokens
Perfume and fragrance gift ideas from who the gift is for: recipient (him, her or anyone), relationship, age range, perfumes or notes they already love, style, occasion and how adventurous to be. Each pick comes with the reason it suits them. Use for 'gift for a woman who loves Delina', 'something s
find_perfume_alternatives ~456 tokens
The editors' alternatives (dupes) to a famous perfume or cologne, from other houses: for each, why it is close and how close (very close, similar vibe, same spirit), plus the 10ML guide that compares them. Covers about 100 iconic originals such as Creed Aventus, Baccarat Rouge 540, Delina, Sauvage,
find_similar_perfumes ~759 tokens
Find perfumes and colognes that smell like one the person already likes, ranked by shared notes, accords and style, each saying exactly what it shares and how close it is (very close, similar vibe, same spirit). Works from a perfume in the index (name and house, or id) OR from free notes/accords for
get_house ~308 tokens
Profile of a perfume house or fragrance brand: country, founded year, style (designer, niche, Middle Eastern, indie), what it is known for, its signature perfumes in the index and a link to explore it at 10ML. Understands nicknames (YSL, MFK, PDM, Paco Rabanne). Use for 'tell me about Creed', 'what
get_perfume ~437 tokens
The full Fragrance Index profile of one perfume, cologne or fragrance: house, launch year, audience, concentration, family, accords, note pyramid (top, heart and base notes), best seasons and occasions, longevity, projection and perfumers (full profiles), the editors' character description, five sim
list_houses ~371 tokens
Browse the perfume houses and fragrance brands in the 10ML Fragrance Index with country, type (designer, niche, middle-eastern, indie, celebrity), perfumes profiled and what each is known for. Filter by type, country or a name fragment. Use when someone wants to explore brands, find niche or Middle
perfumes_by_note ~591 tokens
List the perfumes and colognes in the 10ML Fragrance Index built around a note or ingredient (vanilla, oud, bergamot, tonka bean, jasmine, patchouli, leather, sandalwood...), most prominent first, optionally only where the note sits in the top, heart or base, or for an audience, season or occasion.
pick_for_occasion ~574 tokens
Perfume and cologne picks for a moment: a season, an occasion (daytime, office, casual, evening, date night, special occasion), an audience and a style, each with the reason it fits. Use for 'a fresh summer office scent for men', 'date night perfume for her' or 'what fragrance to wear to a winter we
recommend_perfumes ~803 tokens
Personal perfume and cologne recommendations from taste: fragrances they love or dislike, notes they like or avoid, plus gender, season, occasion, style and family. Every pick says why (shared notes with a loved perfume, a liked note, fits the season). Use when someone says what they enjoy or avoid
search_guides ~400 tokens
Find 10ML's perfume and fragrance guides to read or cite: how-tos (where to spray, finding a signature scent, making perfume last), notes explained, house guides, lists, and alternatives guides that compare famous perfumes with similar ones from other houses. Returns title, type and a link per local
search_perfumes ~999 tokens
Search the 10ML Fragrance Index for perfumes, colognes and fragrances (eau de parfum, eau de toilette, extrait) by name, house, notes, accords, family, audience, season, occasion or style. Natural language works: 'fresh citrus summer cologne for men' or 'warm vanilla scent for winter' is understood.
suggest_layering ~436 tokens
Perfume and fragrance layering ideas: which notes or perfumes combine well, what the combination smells like, how to spray (order, amount) and when it suits. Works from two notes ('vanilla and citrus'), one note (what it layers with), one perfume (partners from the index) or two perfumes (does this

Related MCP servers

Perfume Picks
Search the Perfume Picks fragrance database: 10,000+ scents with notes, dupes, and wear data.
Fragrance & Perfume MCP (Noteboxd)
Fragrance & perfume MCP: search fragrances, notes, accords, brands, perfumers, reviews & charts.
Parfica Fragrances
Fragrance encyclopedia: note pyramids, accords, perfumers and dupes (parfica.com).
Scento Perfume API (MCP server)
Free perfume & fragrance API and MCP server: notes, families, similar scents, 1,400+ perfumes.
10ML Perfume Finder
Free perfume API and MCP server, no API key
PerfuMate
Perfumery materials, IFRA Category 4, EU allergens, and your formulas and shelf via OAuth.
Scento Perfume API
Scento Perfume API and MCP server for fragrance notes
ScentVerdict
Fragrance catalogue with verdicts, similarity scores, scent profiles, drydowns and local prices.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/com.10ml/perfume-finder.svg)](https://aptlynx.net/servers/com.10ml/perfume-finder)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents