# Scento Perfume API (MCP server): free fragrance API, no key [Verified owner] [Health: Active]

**Category:** 🧠 Knowledge & Memory  
**Repository:** https://www.scento.com/mcp  
**npm Downloads (last month):** 435  
**Views:** 9  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/scento-perfume-compendium

## Description
Free perfume API and perfume MCP server: 1,500+ perfumes, 160+ houses, 400+ raw materials with verified notes pyramids, scent families and similar scents. 12 tools, REST + MCP + OpenAPI, 10 languages, no API key. Every pyramid is traced to the house or an authorized retailer. Connect Claude, ChatGPT or Cursor to https://www.scento.com/mcp, or call the REST fragrance API directly. Fragrance API by Scento.

## Tools
Capabilities this server exposes over MCP:

- **perfume-search** — Use this when the user asks to find a perfume, fragrance, cologne or scent by name, house, note or mood, or when a name is uncertain (synonyms: perfume, fragrance, cologne, eau de parfum, scent, brand, notes, smells like). Returns matching perfumes, houses and raw materials with house, Scento family and a scento.com link in the user's language, ten per page. Call this first when a name is ambiguous. Don't use for a perfume's full notes (use perfume-portrait), similar scents (scent-neighbours) or articles (journal-search).
- **perfume-portrait** — Use this when the user asks what a specific perfume, fragrance or cologne smells like, what its notes or pyramid (top, heart, base) are, its family, perfumer, year or concentration (eau de parfum, eau de toilette), or when to wear it (synonyms: notes of, what's in it, how does it smell). Returns the verified note pyramid, Scento family and subfamily, character, seasons and hours, signature materials and the scento.com page in the user's language. Don't use to find similar perfumes (use scent-neighbours), compare perfumes (perfume-contrast) or search by mood (perfume-search).
- **scent-neighbours** — Use this when the user asks for perfumes similar to, like or in the same style as a given perfume, fragrance or cologne, or what else to try if they love it (synonyms: similar to, smells like, more like, if I like X). Returns the perfumes that share the most notes and structure with it, with the shared materials named, one line on how each differs and scento.com links in the user's language. Don't use for one perfume's own notes (perfume-portrait), a side-by-side of named perfumes (perfume-contrast) or a whole collection (wardrobe-composer).
- **perfume-contrast** — Use this when the user asks to compare, contrast or choose between two to four named perfumes, fragrances or colognes (synonyms: versus, vs, difference between, which one). Returns the perfumes side by side on house, Scento family, top, heart and base notes, shared materials, character, seasons, hours, year and concentration, with scento.com links in the user's language. Don't use to find new perfumes (scent-neighbours or perfume-search) or to explain a single perfume (perfume-portrait).
- **note-portrait** — Use this when the user asks what a note or raw material smells like or is (for example vetiver, oud, vanilla, iris, ambroxan, bergamot), whether it is natural or synthetic, or what it pairs with (synonyms: what does X smell like, ingredient, note). Returns how it smells, its family, natural or synthetic, pairings and perfumes that show it, with the scento.com page in the user's language. Don't use to find perfumes containing notes (use material-match) or to define a perfumery term such as sillage (perfumery-lexicon).
- **material-match** — Use this when the user wants perfumes, fragrances or colognes that contain specific notes or raw materials, optionally in the top, heart or base (synonyms: with notes of, built on, smells of, containing; for example vanilla and tobacco in the base). Returns the perfumes that have every material given, with house, where each sits in the pyramid and scento.com links in the user's language. Don't use to explain one material (note-portrait), to find perfumes like a named perfume (scent-neighbours) or for a mood or occasion (occasion-edit).
- **house-portrait** — Use this when the user asks about a perfume house, brand or maison (for example Creed, Le Labo, Amouage): where it is from, when it was founded, its style and its signature perfumes. Returns country, founding year, style, signature perfumes with their families and the scento.com house page in the user's language. Don't use for one perfume (use perfume-portrait) or to list perfumes with a given note (material-match). If the house name is uncertain, call perfume-search with kind "house" first.
- **family-map** — Use this when the user asks how fragrances are grouped or what a scent family is (for example woody, floral, amber, fresh, citrus), or wants the exemplar perfumes of one family (synonyms: scent families, fragrance categories, olfactive families). Returns Scento's own family system: the whole tree, or one family with its definition, subfamilies, exemplar perfumes and neighbouring families, with the scento.com guide. Don't use for one perfume's family (perfume-portrait), a perfumery term (perfumery-lexicon) or an occasion (occasion-edit).
- **occasion-edit** — Use this when the user asks which perfume, fragrance or cologne to wear for one occasion, season or climate: wedding, office, date night, night out, weekend, everyday, gym or sport (workout), summer days, cold weather, first impressions, long-lasting or under-the-radar. Returns a short edit of perfumes with a line on why each fits and a scento.com link for each, in the user's language. The occasion is a fixed list, so pick the nearest value; omit gender_lean unless the user states one. For several occasions call it once per occasion. Don't use for a collection built around perfumes the user already loves (wardrobe-composer) or for similar scents (scent-neighbours).
- **wardrobe-composer** — Use this when the user wants a small fragrance wardrobe or collection (three to five perfumes for different moments) built around perfumes or notes they already love, or asks what to add next (synonyms: signature scents, collection, rotation, what else should I own). Returns roles such as daytime, evening and warm weather, each with a perfume, its house, why it fits and a scento.com link in the user's language. Don't use for a single occasion (occasion-edit) or the neighbours of one perfume (scent-neighbours).
- **perfumery-lexicon** — Use this when the user asks what a perfume or fragrance term means: sillage, projection, longevity, drydown, top, heart and base notes, accord, chypre, fougère, gourmand, oud, layering, eau de parfum versus eau de toilette (EDP vs EDT), concentration, flanker or niche versus designer. Returns a plain-language meaning, example perfumes and related terms, with the matching scento.com guide in the user's language. Don't use for a specific note (use note-portrait) or a specific perfume (perfume-portrait).
- **journal-search** — Use this when the user wants articles, guides or background reading on a perfume, fragrance, cologne, house, note or topic (for example layering, vetiver, how to make a scent last). Returns matching Scento journal articles with title, one-line summary and scento.com link in the user's language. Use it to give the reader something to read on. Don't use for a perfume's notes (perfume-portrait), a house profile (house-portrait) or a term's meaning (perfumery-lexicon).

## Claude Desktop Quick Installation
Install path inferred — verify against the README before running it. Uses `npx` (confidence: medium):

```json
"mcpServers": {
  "scento-perfume-api-mcp-server-free-fragrance-api-no-key": {
    "command": "npx",
    "args": ["-y","scento-perfume-api"]
  }
}
```

## Documentation

## What Scento Perfume API (MCP server): free fragrance API, no key does

Scento exposes fragrance knowledge through an MCP server, a REST API, and an OpenAPI interface. The catalog covers more than 1,500 perfumes, over 160 perfume houses, and more than 400 raw materials. Results can be returned in 10 languages and include links to relevant pages on scento.com.

The fragrance records include verified note pyramids attributed to a perfume house or an authorized retailer. Depending on the request, responses can also include scent families, subfamilies, fragrance character, seasons, wearing hours, perfumers, release years, concentrations, signature materials, and related perfumes.

## How it works

Agents select one of 12 focused tools according to the user’s intent:

- `perfume-search` finds perfumes, houses, and raw materials by name, house, note, or mood. It is also the first step when a name is uncertain.
- `perfume-portrait` returns a perfume’s verified top, heart, and base notes, family, character, usage context, and other profile details.
- `scent-neighbours` finds perfumes with similar notes and structure, explaining shared materials and differences.
- `perfume-contrast` compares two to four named perfumes across notes, families, character, usage, year, and concentration.
- `note-portrait` explains a raw material, including its smell, family, natural or synthetic status, pairings, and perfumes that feature it.
- `material-match` finds perfumes containing every requested material and shows each material’s position in the pyramid.
- `house-portrait` describes a perfume house’s origin, founding year, style, and signature perfumes.
- `family-map` explains Scento’s fragrance-family tree and can return subfamilies, examples, and neighbouring families.
- `occasion-edit` recommends perfumes for a specified occasion, season, or climate.
- `wardrobe-composer` builds a three-to-five-perfume collection around scents or materials the user already likes.
- `perfumery-lexicon` defines fragrance terms and supplies examples and related concepts.
- `journal-search` finds matching Scento articles and guides.

## Setup and configuration

No API key is required. An MCP client can connect to `https://www.scento.com/mcp`; the service can also be called through its REST API or used via OpenAPI. The listed connection options make it suitable for agents that consume remote MCP services as well as applications making direct HTTP-based fragrance queries.

## Tools and capabilities

The tools separate lookup, interpretation, recommendation, and editorial search into distinct operations. This helps an agent choose a perfume profile for a single scent, a neighbour search for alternatives, a contrast tool for named comparisons, or a material search for ingredient-driven discovery. Many results include a Scento link in the user’s language, allowing the agent to point users to a source page.

The data is useful for both factual questions and guided selection. For example, an agent can explain what vetiver smells like, identify perfumes containing vanilla and tobacco in the base, suggest scents for cold weather, or assemble a small rotation from perfumes the user already enjoys.

## Limitations and notes

Tool choice matters because the operations are intentionally scoped. Use `perfume-portrait` for one perfume’s notes, `scent-neighbours` for alternatives, `perfume-contrast` for side-by-side comparisons, and `journal-search` for background reading. Occasion requests use a fixed set of occasion values, and a separate call is intended for each of several occasions. The catalog’s note pyramids are presented as verified against a house or authorized retailer.

_Full upstream README: https://allmcps.com/mcp/scento-perfume-compendium/readme_