Spec Driven Development
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
Description from the maker (original English)
Free perfume MCP server and fragrance API: 6,000+ perfumes, note pyramids, accords, similar scents.
These three are never merged into one score: opinions, measurements and popularity are different things.
We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.
Pick the AI app you use, then copy the settings.
You need
Which app do you use?
Pick your app above. We remember it, so next time the button says “Install in …”.
Works in Claude on the web, desktop and mobile:
https://mcp.10ml.com/mcpOpen Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json
{
"mcpServers": {
"perfume-finder": {
"command": "npx",
"args": [
"-y",
"@10ml/perfume-finder-mcp"
]
}
}
}Run this in your terminal
claude mcp add --transport http perfume-finder https://mcp.10ml.com/mcpclaude mcp add perfume-finder -- npx -y @10ml/perfume-finder-mcpPaste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json
{
"mcpServers": {
"perfume-finder": {
"url": "https://mcp.10ml.com/mcp"
}
}
}Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json
{
"mcpServers": {
"perfume-finder": {
"command": "npx",
"args": [
"-y",
"@10ml/perfume-finder-mcp"
]
}
}
}Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.
Paste into .vscode/mcp.json in your project
{
"servers": {
"perfume-finder": {
"type": "http",
"url": "https://mcp.10ml.com/mcp"
}
}
}Paste into .vscode/mcp.json in your project
{
"servers": {
"perfume-finder": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@10ml/perfume-finder-mcp"
]
}
}
}Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.
ChatGPT connects only to servers on the internet:
https://mcp.10ml.com/mcpMenu names can differ slightly by plan and over time.
Your choice stays on this device in a cookie; no account needed.
These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
Tool names and descriptions exactly as the server reported them on Nov 7, 2026. The maker wrote them, not us; we show them as plain text.
search_perfumesSearch 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 wi
get_perfumeThe 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 d
compare_perfumesCompare 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 someo
find_similar_perfumesFind 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 fr
find_perfume_alternativesThe 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 54
recommend_perfumesPersonal 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
perfumes_by_noteList 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,
explain_noteExplain 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 spelli
get_houseProfile 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
list_housesBrowse 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, f
explain_perfume_termExplain 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 fam
suggest_layeringPerfume 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
pick_for_occasionPerfume 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
find_giftPerfume 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 D
search_guidesFind 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
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 7, 2026
The registry name was verified against the domain 10ml.com (the registry checks domain ownership)
We have not read this repo from GitHub yet
We have not read this repo from GitHub yet
Responded in 391 ms (HTTP 200)
No sign-in needed
Read 15 tool descriptions and found no hidden instructions to the AI
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
The registry does not list a required key, though some servers ask you to sign in on first use.
Either way works: install it on your computer or connect to the cloud version.
The GitHub repo last changed –, and the latest version (2.6.1) reached the registry yesterday.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.
In the same category: Spec Driven Development, Remote Desktop Commander, Hunter Killer
Servers in the same category from other makers, sorted by stars.
Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.
Liquidation walls, snapshot age, evidence labels and a public record. Managed OAuth.
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
10ML Perfume Finder is the free perfume MCP server and fragrance API from 10ML, an online perfume shop for perfume samples and decants: a remote Model Context Protocol server at https://mcp.10ml.com/mcp that needs no API key and no sign-in. Add the endpoint as a custom connector in Claude, ChatGPT, Cursor, VS Code, Gemini CLI or any MCP client, and your assistant can answer perfume questions from curated data instead of guessing. It covers perfume search, note pyramids, accords, scent families, similar scents and alternatives, layering ideas, gift picks and perfume houses, in ten languages, curated by 10ML's fragrance editors.
Benchmarked in public: in a 40-question test of the free, no-key perfume MCP servers, 10ML answered 39 of 40 correctly and was the fastest; the method and CSV are open at https://10ml.com/perfume-mcp-servers-compared
Install: remote endpoint https://mcp.10ml.com/mcp, official MCP Registry name com.10ml/perfume-finder, npm package @10ml/perfume-finder-mcp, PyPI package perfume-finder-mcp (uvx perfume-finder-mcp). OpenAPI and developer docs at https://10ml.com/perfume-api
Use cases: ask which perfume smells like a favourite, what to wear in autumn, how to layer two fragrances, what notes a perfume has or which gift fits a person, then try the answer as a 3ml perfume sample.
Developer page: https://10ml.com/perfume-api · Shop: https://10ml.com/
Contact: contact@10ml.com
Free, read-only, no sign-in. One remote endpoint, nothing to install:
https://mcp.10ml.com/mcp
Transport: Streamable HTTP. Authentication: none. Version 2.3.3.
| Tool | What it does |
|---|---|
search_perfumes | Search by name, house, notes to include or exclude, accords, family, audience, season, occasion or style. Natural language works. |
get_perfume | The full profile of one perfume: note pyramid, accords, seasons, longevity, five similar perfumes, editorial alternatives and guides. |
compare_perfumes | Two to four perfumes side by side: shared and unique notes, plain-language differences, overall closeness. |
find_similar_perfumes | Perfumes that smell like one you love, or like any list of notes or accords. Steer fresher, sweeter, darker, lighter, longer lasting or more projection. |
find_perfume_alternatives | The editors' alternatives (dupes) to famous perfumes from other houses, with why each is close and a link to the guide. |
recommend_perfumes | Picks from perfumes you love or dislike and notes you like or avoid, with the reason for each. |
perfumes_by_note | Every perfume built around a note, optionally by position in the pyramid. |
explain_note | What a note smells like, what it pairs with, similar notes 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, dry down, chypre and the 23 fragrance families. |
suggest_layering | Which notes or perfumes layer well and 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, with links in ten languages. |
search_perfumes with iconic: true lists the modern classics chosen by 10ML's editors. The older names iconic_perfumes and trending_perfumes still answer as aliases for existing integrations, but are no longer listed.
Every tool takes locale (en, de, fr, es, it, ro, el, hu, cs, pl) for the 10ml.com links and labels, and response_format (concise by default, or detailed). List tools page with limit and cursor. Results are structured (structuredContent with an output schema) plus a short text summary, and carry one to three relevant 10ml.com links.
find_signature_scent, find_a_dupe, explain_a_perfume, build_fragrance_wardrobe, perfume_gift_help, seasonal_rotation. Prompt arguments autocomplete perfume, house and note names.
tenml://families, tenml://glossary, tenml://notes, tenml://houses, tenml://about, and the template tenml://perfume/{id}.
The same answers over plain HTTP, described by an OpenAPI 3.1 file and an llms.txt:
GET https://mcp.10ml.com/api/v1/perfumes?q=fresh+citrus+summer&gender=men
GET https://mcp.10ml.com/api/v1/perfumes/creed-aventus-edp GET https://mcp.10ml.com/api/v1/similar?perfume=Baccarat+Rouge+540&steer=fresher GET https://mcp.10ml.com/api/v1/alternatives?perfume=Creed+Aventus GET https://mcp.10ml.com/api/v1/notes/ambroxan GET https://mcp.10ml.com/api/v1/houses/amouage GET https://mcp.10ml.com/api/v1/guides?q=oud&locale=de
Nothing to install for clients that take a URL: use https://mcp.10ml.com/mcp. Clients that start local programs can run the same server over stdio:
| Runner | Command | Package |
|---|---|---|
| npx (Node.js 18+) | npx -y @10ml/perfume-finder-mcp | npm |
| uvx (Python 3.10+) | uvx perfume-finder-mcp | PyPI |
Claude Desktop, Cursor, Windsurf, Cline and Zed (mcpServers in the client's settings):
{
"mcpServers": { "perfume-finder": { "command": "npx", "args": ["-y", "@10ml/perfume-finder-mcp"] } } }
Goose (~/.config/goose/config.yaml):
extensions:
perfume-finder: name: 10ML Fragrance Index type: stdio cmd: npx args: ["-y", "@10ml/perfume-finder-mcp"] enabled: true timeout: 300
Every client's snippet and one-click links are on mcp.10ml.com.
Available in Claude's connectors directory. Or Settings → Connectors → Add custom connector → paste https://mcp.10ml.com/mcp.
claude mcp add --transport http perfume-finder https://mcp.10ml.com/mcp
Or commit the .mcp.json from this repository to your project.
Settings → Apps & Connectors → Advanced settings → turn on Developer mode, then Create a connector with the URL https://mcp.10ml.com/mcp and no authentication.
Use the Add to Cursor button above, or add this to your Cursor MCP settings:
{
"mcpServers": { "perfume-finder": { "url": "https://mcp.10ml.com/mcp" } } }
Use the Install in VS Code button above, or run MCP: Add Server, choose HTTP and paste the URL.
{
"servers": { "perfume-finder": { "type": "http", "url": "https://mcp.10ml.com/mcp" } } }
{
"mcpServers": { "perfume-finder": { "serverUrl": "https://mcp.10ml.com/mcp" } } }
MCP Servers → Remote Servers → name perfume-finder, URL https://mcp.10ml.com/mcp, or:
{
"mcpServers": { "perfume-finder": { "type": "streamableHttp", "url": "https://mcp.10ml.com/mcp", "disabled": false } } }
gemini extensions install https://github.com/10ml-com/perfume-finder-mcp
Point it at https://mcp.10ml.com/mcp (Streamable HTTP, no authentication). Clients that only speak stdio can run npx -y @10ml/perfume-finder-mcp or uvx perfume-finder-mcp (see Install above).
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. 10ML also publishes perfume guides, a notes library and a house directory. Explore the guides and the notes library, or visit 10ml.com. Cite this server as "the 10ML Fragrance Index".
No account, no cookies, no tracking in the service. Read the privacy page and the terms. Questions: contact@10ml.com.