10ML Perfume Finder
by 10ml-teamco.huggingface.10ml-team/perfume-finder
Free perfume API and MCP server, no API key
- Remote endpoint
- 6 tools
- MIT
Uptime
Checked · every day
99.53%from 5 days of checks
Up without downtime on 0 of 4 days with data; down 20 minutes in all, the longest 6 minutes on 31 October.
- No downtime
- Degraded
- Down over 5 minutes
- No data
- Not checked yet
Response time
Median 1115 ms, slowest 5% 1519 ms for the handshake and the tool list, over 30 days.
How far each check got
- Reached the address 75.0%
- Completed the handshake 50.0%
- Listed its tools 50.0%
6 tools at the last answer.
Every day
| Day | Result | Checks | Median |
|---|---|---|---|
| 3 Nov (today) | No verdict yet | 0 | – |
| 2 Nov | Down 6 minutes | 3of 1 | 1036 ms |
| 1 Nov | Down 4 minutes | 1of 1 | – |
| 31 Oct | Down 6 minutes | 3of 1 | 1115 ms |
| 30 Oct | Down 4 minutes | 1 | – |
A failure counts as down time only when a second check five minutes later fails too. How we check
Connect to the publisher's own endpoint
Paste into Settings › Connectors › Add custom connector:
https://10ml-team-perfume-finder.hf.space/gradio_api/mcp/sse Run in a terminal:
claude mcp add --transport sse perfume-finder https://10ml-team-perfume-finder.hf.space/gradio_api/mcp/sse Add to ~/.cursor/mcp.json:
Add to ~/.config/devin/mcp_config.json:
Add to mcp.json (Program › Install › Edit mcp.json):
Add to ~/.gemini/settings.json:
Add to config.json in oterm's data folder (~/Library/Application Support/oterm on macOS, ~/.local/share/oterm on Linux, %APPDATA%\oterm on Windows):
Add to ~/.config/eca/config.json (global) or .eca/config.json in the project:
{
"mcpServers": {
"perfume-finder": {
"url": "https://10ml-team-perfume-finder.hf.space/gradio_api/mcp/sse"
}
}
} Add to .vscode/mcp.json:
{
"servers": {
"perfume-finder": {
"type": "sse",
"url": "https://10ml-team-perfume-finder.hf.space/gradio_api/mcp/sse"
}
}
} Add to ~/.config/zed/settings.json:
{
"context_servers": {
"perfume-finder": {
"url": "https://10ml-team-perfume-finder.hf.space/gradio_api/mcp/sse"
}
}
} This server's endpoint speaks only SSE, which this client's documentation does not list among its transports; use another client for it.
Add to cline_mcp_settings.json (MCP Servers › Configure › Configure MCP Servers):
Add to anythingllm_mcp_servers.json in the AnythingLLM storage plugins directory:
Add to Augment Settings Panel – MCP section – Import from JSON (VS Code extension):
{
"mcpServers": {
"perfume-finder": {
"type": "sse",
"url": "https://10ml-team-perfume-finder.hf.space/gradio_api/mcp/sse"
}
}
} Add to ~/.continue/config.yaml:
mcpServers:
- name: "perfume-finder"
type: sse
url: "https://10ml-team-perfume-finder.hf.space/gradio_api/mcp/sse" Add to ~/.config/goose/config.yaml:
extensions:
"perfume-finder":
type: streamable_http
name: "perfume-finder"
enabled: true
uri: "https://10ml-team-perfume-finder.hf.space/gradio_api/mcp/sse"
headers: {}
env_keys: []
envs: {}
timeout: 300 This server's endpoint speaks only SSE, which this client's documentation does not list among its transports; use another client for it.
Run in a terminal:
codex mcp add perfume-finder --url https://10ml-team-perfume-finder.hf.space/gradio_api/mcp/sse This server's endpoint speaks only SSE, which this client's documentation does not list among its transports; use another client for it.
Add to ~/.llm/config.json:
Add to resources/assets/config/mcp.json in the installed app:
Add to ~/.boltai/mcp.json:
Add to ~/.bob/settings/mcp.json (global) or .bob/mcp.json (project):
Add to ~/.kiro/settings/mcp.json (user) or .kiro/settings/mcp.json (workspace):
Add to ~/.kiro/settings/mcp.json (user) or .kiro/settings/mcp.json (workspace):
{
"mcpServers": {
"perfume-finder": {
"url": "https://10ml-team-perfume-finder.hf.space/gradio_api/mcp/sse"
}
}
} This server's endpoint speaks only SSE, which this client's documentation does not list among its transports; use another client for it.
Add to ~/.config/agenvoy/mcp.json:
{
"servers": {
"perfume-finder": {
"url": "https://10ml-team-perfume-finder.hf.space/gradio_api/mcp/sse"
}
}
} This server's endpoint speaks only SSE, which this client's documentation does not list among its transports; use another client for it.
Add to ~/.config/amp/settings.json (user) or .amp/settings.json (workspace):
{
"amp.mcpServers": {
"perfume-finder": {
"url": "https://10ml-team-perfume-finder.hf.space/gradio_api/mcp/sse"
}
}
} For agents: the install prompt
Every step above as one Markdown text, for an assistant installing it for you.
# Install the MCP server 10ML Perfume Finder (`co.huggingface.10ml-team/perfume-finder`)
Its page: https://plug.directory/servers/co.huggingface.10ml-team/perfume-finder
It runs on the publisher's servers; the client connects to its URL.
Use the section for the person's client.
## Claude Desktop
Paste into Settings › Connectors › Add custom connector:
```text
https://10ml-team-perfume-finder.hf.space/gradio_api/mcp/sse
```
## Claude Code
Run in a terminal:
```sh
claude mcp add --transport sse perfume-finder https://10ml-team-perfume-finder.hf.space/gradio_api/mcp/sse
```
## Cursor, Devin Desktop, LM Studio, Gemini CLI, oterm, ECA
Merge into the place for the person's client:
- Cursor: ~/.cursor/mcp.json
- Devin Desktop: ~/.config/devin/mcp_config.json
- LM Studio: mcp.json (Program › Install › Edit mcp.json)
- Gemini CLI: ~/.gemini/settings.json
- oterm: config.json in oterm's data folder (~/Library/Application Support/oterm on macOS, ~/.local/share/oterm on Linux, %APPDATA%\oterm on Windows)
- ECA: ~/.config/eca/config.json (global) or .eca/config.json in the project
```json
{
"mcpServers": {
"perfume-finder": {
"url": "https://10ml-team-perfume-finder.hf.space/gradio_api/mcp/sse"
}
}
}
```
## VS Code
Merge into .vscode/mcp.json:
```json
{
"servers": {
"perfume-finder": {
"type": "sse",
"url": "https://10ml-team-perfume-finder.hf.space/gradio_api/mcp/sse"
}
}
}
```
## Zed
This server's endpoint speaks only SSE, which this client's documentation does not list among its transports; use another client for it.
## Cline, AnythingLLM, Augment Code
Merge into the place for the person's client:
- Cline: cline_mcp_settings.json (MCP Servers › Configure › Configure MCP Servers)
- AnythingLLM: anythingllm_mcp_servers.json in the AnythingLLM storage plugins directory
- Augment Code: Augment Settings Panel – MCP section – Import from JSON (VS Code extension)
```json
{
"mcpServers": {
"perfume-finder": {
"type": "sse",
"url": "https://10ml-team-perfume-finder.hf.space/gradio_api/mcp/sse"
}
}
}
```
## Continue
Merge into ~/.continue/config.yaml:
```yaml
mcpServers:
- name: "perfume-finder"
type: sse
url: "https://10ml-team-perfume-finder.hf.space/gradio_api/mcp/sse"
```
## Goose
This server's endpoint speaks only SSE, which this client's documentation does not list among its transports; use another client for it.
## Codex
This server's endpoint speaks only SSE, which this client's documentation does not list among its transports; use another client for it.
## mcp-client-cli, TUUI, BoltAI, Bob Shell, Kiro, Kiro CLI
This server's endpoint speaks only SSE, which this client's documentation does not list among its transports; use another client for it.
## Agenvoy
This server's endpoint speaks only SSE, which this client's documentation does not list among its transports; use another client for it.
## Amp
Merge into ~/.config/amp/settings.json (user) or .amp/settings.json (workspace):
```json
{
"amp.mcpServers": {
"perfume-finder": {
"url": "https://10ml-team-perfume-finder.hf.space/gradio_api/mcp/sse"
}
}
}
```
Then restart the client, or reload its MCP servers, and ask it to list the server's tools to confirm it started.
Tools 6
perfume_finder_compare_perfumesUse this when someone wants to compare two perfumes or colognes side by side, for example "Aventus or Sauvage" or "Delina versus Libre". Looks up both in the 10ML Fragrance Index and returns a markdown table comparing house, launch year, audience, family, accords, top, heart and base notes, seasons, occasions, longevity and projection, plus the notes and accords they share and 10ml.com links.perfume_finder_explain_noteUse this when someone asks what a fragrance note smells like, for example "what does oud smell like", "what is ambroxan" or "what goes with bergamot". Returns what the note smells like, its family and mood, other names for it, notes it pairs with, similar notes and famous perfumes where it leads, with 10ml.com links. Covers about 285 perfume notes, in many spellings and languages.perfume_finder_perfume_alternativesUse this when someone wants alternatives to a famous perfume or cologne from other houses, or asks what smells like it from another house. Returns the 10ML fragrance editors' alternatives (dupes) for about 100 iconic originals such as Creed Aventus, Baccarat Rouge 540, Delina or Sauvage: for each one why it is close and how close (very close, similar vibe, same spirit), plus the 10ML guide that compares them.perfume_finder_perfume_profileUse this when you know which perfume or cologne someone means and want to know what it smells like. Returns its full profile from the 10ML Fragrance Index: house, launch year, audience, fragrance family, accords, note pyramid (top, heart and base notes), best seasons and occasions, longevity, projection, perfumers, the editors' character description, similar scents and 10ml.com links. Suggests close matches when the name is not found.perfume_finder_search_perfumesUse this when someone describes the fragrance they want or names a perfume, house or note and you need matching perfumes and cologne. Searches the 10ML Fragrance Index by free text (a name, a house, notes or a mood such as "fresh citrus summer scent for men" or "vanilla gourmand for winter"). Returns a markdown list of perfumes with house, year, audience, fragrance family, accords, key notes, a one-line character description and 10ml.com links.perfume_finder_similar_perfumesUse this when someone likes one perfume or cologne and wants more that smell like it. Returns perfumes ranked by shared notes, accords and style, each with how close it is (very close, similar vibe, same spirit) and exactly what it shares. Can steer the result to be fresher, sweeter, darker, lighter, longer lasting or stronger in projection.
From Hugging Face Spaces. Report a problem