MCP.Market

Scento Perfume API (MCP server)

online · 100% uptime
by scento.com·com.scento/perfume-api·v1.0.0

Free perfume & fragrance API and MCP server: notes, families, similar scents, 1,400+ perfumes.

A93/100grade A
What users say
No reviews yet
Be the first
Safety scan
A93/100

full report

Adoption
Growing

0 stars170 downloads/wk

Reviews

Write one

Nobody has reviewed Scento Perfume API (MCP server) yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Scento Perfume API (MCP server) tools (12)

write = sends, deletes, buys or posts
  • family-mapFree

    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).

  • house-portraitFree

    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.

  • journal-searchFree

    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).

  • material-matchFree

    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).

  • note-portraitFree

    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).

  • occasion-editFree

    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).

  • perfume-contrastFree

    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).

  • perfume-portraitFree

    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).

  • perfume-searchFree

    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).

  • perfumery-lexiconFree

    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).

  • scent-neighboursFree

    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).

  • wardrobe-composerFree

    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).

Public scan report

scanner v0.1.10 · 2026-10-26 · same rubric, same numbers if you re-run it

no findings
  • Code scan2 source files scanned; 4 source files scanned25/25
  • Live reliabilityremote reachable in 934ms20/20
  • Tool poisoning12 tool descriptions checked15/15
  • Auth qualityopen endpoint, read-only tools10/15
  • Maintenancelast push 0 days ago15/15
  • Maintainer identitynamespace and repository owner differ; GitHub account older than a year; website matches verified namespace8/10
Overall 93/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Scento Perfume API (MCP server) compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
93/100
higher than 96% of 48,255 servers
Tools
12
the typical server has 7
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
Uptime
100%
of our recent checks; the typical remote server answers 100%
Response time
198 ms
faster than 64% of 30,031 servers
Downloads a week
170
more than 73% of 12,191 servers with a package

What its tools let an agent do: 12 read

Install Scento Perfume API (MCP server) in Claude Code, Cursor or VS Code

claude mcp add --transport http perfume-api https://www.scento.com/mcp
Add to Cursor

What the publisher says

From the Scento Perfume API (MCP server) repository's README, as published. We do not edit it. Read it on GitHub

Scento Perfume API (MCP server): Perfume API, Fragrance API and Perfume MCP Server

<!-- mcp-name: com.scento/perfume-api -->

A free perfume and fragrance API and MCP server for AI assistants, built on Scento's verified perfume database. From Scento, a perfume decant house founded in Paris in 2024.

Ask Claude, ChatGPT, Cursor or any MCP client for a perfume's notes and family, the difference between two you are torn over, similar scents built on the same structure, or what a raw material such as ambroxan smells like. The perfume database covers 1,400+ designer and niche perfumes, 400+ raw materials, 140+ houses and Scento's own fragrance-family system, and every answer is tied to a page on scento.com. No key, no account, read-only.

Remote server: https://www.scento.com/mcp (streamable HTTP, no authentication) Docs: https://www.scento.com/developers Claude: Available in Claude's connectors directory. Claude Code: /plugin marketplace add Scento-com/perfume-mcp-server, then /plugin install scento-perfume-api@scento. Gemini CLI: gemini extensions install https://github.com/Scento-com/perfume-mcp-server

Connect the perfume MCP server

Clients that only run local servers can use the stdio bridge in this repo:

npx -y scento-perfume-api     # Node 18+
uvx scento-perfume-api        # Python 3.9+

Both accept --endpoint (or SCENTOPERFUMEAPI_ENDPOINT). The same bridge is also published as perfume-mcp-server and perfume-database on npm and PyPI.

Twelve perfume and fragrance tools

Pass lang (de, fr, es, it, ro, el, hu, cs, pl) to receive scento.com links in that language.

Fragrance API (REST)

The same answers are available as a perfume API over plain HTTP.

  • API base: https://www.scento.com/api/perfume/v1
  • OpenAPI: https://www.scento.com/api/perfume/v1/openapi.json

Examples

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Scento Perfume API (MCP server): common questions

Is Scento Perfume API (MCP server) safe?
Yes, by our scan: it is graded A (93/100). Read the Scento Perfume API (MCP server) safety report
How do I install Scento Perfume API (MCP server)?
It runs remotely at www.scento.com. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
Does Scento Perfume API (MCP server) need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Scento Perfume API (MCP server) maintained?
The last commit was 9 days ago (2026-10-26). The latest release is v1.0.0.
Is Scento Perfume API (MCP server) up?
100% of our last 28 checks got an answer. We check remote servers about four times a day.
How does Scento Perfume API (MCP server) compare with other MCP servers?
safety score 93/100 (higher than 96% of 48,255 servers); tools 12 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.