Integration

10ML Perfume Finder integration

Search the 10ML Fragrance Index, a perfume reference curated by the fragrance editors of the 10ML decant shop: 6,000+ perfumes and 249 houses with note pyramids, accords, families, seasons and occasions. Look up one perfume, find perfumes that smell like another (from a name or from notes and accords), list the editors' alternatives to famous perfumes, explain a note, browse houses and find 10ML guides. All routes are read-only GET requests; answers carry links to 10ml.com and ask to be cited as the 10ML Fragrance Index. No credential is needed: the API is free, with fair-use rate limiting.

Connect 10ML Perfume Finder How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in 10ML Perfume Finder.Built from the 8 10ML Perfume Finder tools below, on the connection you add once.

What you can do with 10ML Perfume Finder

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Each badge shows the default agent permission of an endpoint (allowed: an agent calls it without asking; ask first: you are asked before an agent calls it, when the agent or chat asks permission for sensitive actions; never: no agent may call it), which every user can change endpoint by endpoint in their credential settings.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Perfume, 3 operations

find_similar_perfumesFind similar perfumesGETAgents: ask firstFinds perfumes that smell like a given one: pass perfume (name or id) or, for a perfume outside the index, notes and accords. Each result says how close it is and what it shares; steer moves the search fresher, sweeter, darker or lighter.
get_perfumeGet perfumeGETAgents: ask firstReturns one perfume's profile by name (optionally with house) or index id: house, year, family, accords, key notes, the editors' character line, similar perfumes and alternatives; format=detailed adds the pyramid and longevity.
search_perfumesSearch perfumesGETAgents: ask firstSearches the 10ML Fragrance Index (6,000+ perfumes) by free text or filters: house, notes to include or exclude, accords, family, gender, season, occasion, style, iconic. Page with limit and next_cursor; format=detailed adds the pyramid.

House, 2 operations

get_houseGet houseGETAgents: ask firstReturns one perfume house's profile by name or nickname (YSL, MFK, PDM): country, founding year, type, style, what it is known for and its signature perfumes in the index.
list_housesList housesGETAgents: ask firstLists the perfume houses in the 10ML Fragrance Index with country, type, founding year, perfumes profiled and what each is known for. Filter by type, country or part of a name; page with limit and next_cursor.

Guide, 1 operation

search_guidesSearch guidesGETAgents: ask firstSearches 10ML's perfume guides (how-tos, rankings, dupe guides, notes and houses explained) by topic and type; each result has a title, topics and a link to read it on 10ml.com. Leave q out to browse.

Note, 1 operation

explain_noteExplain noteGETAgents: ask firstExplains one fragrance note (about 285, in many spellings and languages): what it smells like, its family, mood and origin, notes it pairs with, similar notes and famous perfumes where it leads.

Perfume alternative, 1 operation

find_perfume_alternativesFind perfume alternativesGETAgents: ask firstLists the editors' alternatives (dupes) to a famous perfume from other houses, each with how close it is and why, plus the 10ML guide that compares them. perfume is required; about 100 iconic originals are covered.

Use 10ML Perfume Finder from Claude Code, Cursor or Codex

Connect 10ML Perfume Finder in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its 10ML Perfume Finder operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect 10ML Perfume Finder

Create your workspace
Sign up free. Nothing to install.
Connect 10ML Perfume Finder once
10ML Perfume Finder needs no credential, so its tools work immediately.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.