Command Palette

Search for a command to run...

UnylyUnyly
Browse all

Perfume Api

FreeNot checked

Free fragrance API (REST + OpenAPI + MCP): search 1,500+ perfumes, notes pyramids, similar scents, scent families and a 400+ fragrance ingredients database. No

GitHubEmbed

About

Free fragrance API (REST + OpenAPI + MCP): search 1,500+ perfumes, notes pyramids, similar scents, scent families and a 400+ fragrance ingredients database. No API key, 10 languages, curl/Python/JavaScript examples. Perfume API by Scento.

README

Looking for a free perfume API that works with AI assistants? Scento Perfume API is a fragrance API and perfume MCP server over Scento's verified perfume database: 1,500+ perfumes, 160+ houses, 400+ raw materials, every notes pyramid traced to the house or an authorized retailer.

What you get: a perfume notes database you can query by name, note, family or occasion; a fragrance ingredients database (400+ raw materials with the perfumes that use them); similar-scent and head-to-head comparison endpoints; scent family maps; occasion edits and wardrobe building; a perfumery lexicon; and a journal search for editorial context. Twelve tools in total: perfume-search, perfume-portrait, scent-neighbours, perfume-contrast, note-portrait, material-match, house-portrait, family-map, occasion-edit, wardrobe-composer, perfumery-lexicon, journal-search.

Use it two ways. As an MCP server (remote, streamable HTTP) at https://www.scento.com/mcp, or via npx -y scento-perfume-api and uvx scento-perfume-api for stdio clients. Or as plain REST at https://www.scento.com/api/perfume/v1 with an OpenAPI document at /openapi.json. Both are free and need no API key.

Typical uses: a chatbot that recommends perfumes with real notes, a fragrance finder, a "smells like" lookup, a retailer enriching product pages with a notes pyramid, a student project, or an AI agent that needs a trustworthy perfume database API instead of guessing. Responses come in 10 languages.

Maintained by Scento. Docs and live examples: https://www.scento.com/developers

A free perfume and fragrance API from Scento, built on Scento's verified perfume database: 1,500+ designer and niche perfumes, 400+ raw materials and 160+ perfume houses, with Scento's own 14-family system. No key, no account, read-only, open CORS.

Every answer is a small JSON "folio": a quotable one-sentence lede, a detail object, the scento_page to read on, further_reading links and a cite line. The same twelve answers are available as plain REST and as an MCP server for Claude, ChatGPT, Cursor and any other MCP client.

Provenance

Every perfume and raw-material entry is traced to a saved official house or authorized-retailer source, and every answer links to the matching page on scento.com. Answers are English; lang (en de fr es it ro el hu cs pl) switches the language of the scento.com links and labels.

Quickstart

curl

curl -s "https://www.scento.com/api/perfume/v1/search?q=oud"
curl -s "https://www.scento.com/api/perfume/v1/perfumes/aventus-creed"
curl -s "https://www.scento.com/api/perfume/v1/materials/bergamot"

Python (requests)

import requests

r = requests.get("https://www.scento.com/api/perfume/v1/perfumes/aventus-creed", timeout=20)
r.raise_for_status()
answer = r.json()
print(answer["lede"])
print(answer["detail"]["pyramid"])      # {"top": [...], "heart": [...], "base": [...]}
print(answer["scento_page"]["url"])

JavaScript (fetch, Node 18+ or the browser)

const res = await fetch("https://www.scento.com/api/perfume/v1/perfumes/aventus-creed");
const answer = await res.json();
console.log(answer.lede, answer.detail.pyramid, answer.scento_page.url);

MCP

Add the remote server to any MCP client that supports streamable HTTP:

{
  "mcpServers": {
    "scento-perfume-api": { "type": "http", "url": "https://www.scento.com/mcp" }
  }
}

For clients that only speak stdio, a small local bridge is published to npm and PyPI (source: Scento-com/perfume-mcp-server):

npx -y scento-perfume-api        # Node
uvx scento-perfume-api           # Python

The twelve tools are read-only: perfume-search, perfume-portrait, scent-neighbours, perfume-contrast, note-portrait, material-match, house-portrait, family-map, occasion-edit, wardrobe-composer, perfumery-lexicon, journal-search. See examples/curl/mcp-tools-list.sh and examples/curl/mcp-call.sh, which calls perfume-portrait with one POST and no session.

Endpoints

All are GET under https://www.scento.com/api/perfume/v1. Every endpoint takes an optional lang; list endpoints return an opaque continuation value to fetch the next part.

Endpoint Parameters Returns MCP tool
/search q, kind (perfume, house, material, any) Matching perfumes, houses and materials perfume-search
/perfumes q Perfume search perfume-search
/perfumes/{perfume} slug, e.g. aventus-creed Perfume portrait: house, family, note pyramid (or a flat note list), character, seasons perfume-portrait
/perfumes/{perfume}/neighbours same_house Perfumes with a similar structure scent-neighbours
/contrast perfumes (comma-separated slugs) Side-by-side comparison perfume-contrast
/materials/{material} slug, e.g. bergamot Raw material portrait note-portrait
/materials/match materials (comma-separated), tier, family Perfumes built on the given materials material-match
/houses/{house} slug, e.g. dior Perfume house portrait house-portrait
/families and /families/{family} family slug (optional) Scento's 14-family map family-map
/edits/{occasion} occasion, e.g. office, date-night; gender_lean An edit of perfumes for an occasion occasion-edit
/wardrobe loves, avoid, size A composed fragrance wardrobe wardrobe-composer
/lexicon/{term} term, e.g. sillage Perfumery term explained perfumery-lexicon
/journal q Search the Scento journal journal-search

The full schema is in the OpenAPI document.

Examples

Runnable scripts live in examples/: python/ (requests), javascript/ (Node 18+, no dependencies) and curl/. The Python and JavaScript folders hold the same four scripts (search, portrait, contrast, material), each with a small shared helper. Output below is real, captured on 21 Oct 2026 and trimmed.

$ python examples/python/search.py oud
132 entries in Scento's verified perfume database match “oud”; showing 1–10.
- material Oud  (Oud)  https://www.scento.com/note/oud
- perfume  Oud Wood  (Tom Ford)  https://www.scento.com/perfumes/oud-wood-tom-ford
- perfume  Oud for Greatness  (Initio Parfums Prives)  https://www.scento.com/perfumes/initio-parfums-prives-oud-for-greatness
$ python examples/python/portrait.py aventus-creed
Aventus by Creed (2010, Erwin Creed and Jean-Christophe Hérault) belongs to Scento’s Orchard Fruit family: bergamot, blackcurrant, apple and pineapple open onto juniper, birch, patchouli and jasmine, settling on musk, oakmoss, ambergris and vanilla.
Page: https://www.scento.com/perfumes/aventus-creed
Cite: Scento Perfume API, scento.com
top   Bergamot, Blackcurrant, Apple, Pineapple
heart Juniper, Birch, Patchouli, Jasmine
base  Musk, Oakmoss, Ambergris, Vanilla
$ node examples/javascript/contrast.mjs aventus-creed baccarat-rouge-540-maison-francis-kurkdjian
Aventus and Baccarat Rouge 540 share jasmine and ambergris, but part ways on family.
house    Creed | Maison Francis Kurkdjian
family   Orchard Fruit / Wood & Root | Wood & Root / White Bloom
top      Bergamot, Blackcurrant, Apple, Pineapple | Jasmine, Saffron
heart    Juniper, Birch, Patchouli, Jasmine | Cedarwood
$ node examples/javascript/material.mjs bergamot
Bergamot is a natural material from the citrus family: sparkling peel of a green-gold citrus, juicy and slightly floral, with a bitter edge that keeps it elegant.
Page: https://www.scento.com/note/bergamot
Cite: Scento Perfume API, scento.com

Terms and license

The code in this repository is MIT. The perfume content returned by the API is Scento's and is covered by the Scento terms; please keep the cite line when you show an answer. Questions: [email protected].

See also the curated awesome-perfume-apis list.

from github.com/Scento-com/perfume-api

Installing Perfume Api

This server has no published package — it is built from source. Open the repository and follow its README.

▸ github.com/Scento-com/perfume-api

FAQ

Is Perfume Api MCP free?

Yes, Perfume Api MCP is free — one-click install via Unyly at no cost.

Does Perfume Api need an API key?

No, Perfume Api runs without API keys or environment variables.

Is Perfume Api hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install Perfume Api in Claude Desktop, Claude Code or Cursor?

Open Perfume Api on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Compare Perfume Api with

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All data MCPs