
Scento Perfume API (MCP server): free perfume & fragrance API over Scento's verified perfume
Scento Perfume API (MCP server): free perfume & fragrance API over Scento's verified perfume database. Notes, families, similar scents. No key.
·
Scento Perfume API is a free perfume API and perfume MCP server for developers, AI agents and fragrance apps. One endpoint gives you Scento's verified perfume database: 1,500+ perfumes from 160+ houses and 400+ raw materials, each with a full notes pyramid (top, heart and base notes), scent family, occasion and similar-scent links. Every pyramid is traced to the house or an authorized retailer, so the notes you return are the notes on the bottle, not scraped guesses.
Connect it as a remote MCP server at https://www.scento.com/mcp (works in Claude, ChatGPT, Cursor, VS Code and any MCP client) or call the REST fragrance API at https://www.scento.com/api/perfume/v1 with the OpenAPI spec at https://www.scento.com/api/perfume/v1/openapi.json. No API key, no sign-up, no rate-limit tiers to buy: it is free.
12 tools cover the real jobs: perfume-search, perfume-portrait, scent-neighbours, perfume-contrast, note-portrait, material-match, house-portrait, family-map, occasion-edit, wardrobe-composer, perfumery-lexicon, journal-search. Search a perfume by name or by notes, get a perfume notes API response with pyramid and family, find similar scents, contrast two perfumes, look up a fragrance ingredient (raw material) and match it to the perfumes that use it, map a scent family, build an occasion edit or a wardrobe, and read the perfumery lexicon.
Why it beats other perfume APIs: free with no key, MCP and REST and OpenAPI in one service, a notes database and a fragrance ingredients database in the same place, answers in 10 languages (English, German, French, Spanish, Italian, Romanian, Polish, Czech, Hungarian, Greek), and sourcing you can trust. Built and maintained by Scento, the perfume atelier. Docs: https://www.scento.com/developers
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,500+ designer and niche perfumes, 400+ raw materials, 160+ 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
| Client | How |
|---|---|
| Claude (web, desktop, mobile) | Settings, Connectors, Add custom connector. Paste https://www.scento.com/mcp. |
| ChatGPT | Settings, Connectors, create a connector in developer mode. Server URL https://www.scento.com/mcp, authentication none. |
| Cursor | Add to ~/.cursor/mcp.json: {"mcpServers":{"scento-perfume-api":{"url":"https://www.scento.com/mcp"}}} |
| VS Code | Add to .vscode/mcp.json: {"servers":{"scento-perfume-api":{"type":"http","url":"https://www.scento.com/mcp"}}} |
| Claude Code | claude mcp add --transport http scento-perfume-api https://www.scento.com/mcp |
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 <url> (or SCENTO_PERFUME_API_ENDPOINT). The same bridge is also published as perfume-mcp-server and perfume-database on npm and PyPI.
| Tool | What it does |
|---|---|
perfume-search | Find perfumes, houses and raw materials by name, house, note or mood word. |
perfume-portrait | The full portrait of one perfume: pyramid, Scento family, character and when it wears best. |
scent-neighbours | Perfumes that share the most structure with a given one, with the shared materials named. |
perfume-contrast | Set two to four perfumes side by side on family, pyramid, character and season. |
note-portrait | What a note or raw material is, where it comes from and how it reads on skin. |
material-match | Perfumes that contain every material given, optionally in one tier of the pyramid. |
house-portrait | A perfume house: origin, founding year, style and its signature perfumes. |
family-map | Scento's own fragrance-family system, or one family with its subfamilies and exemplars. |
occasion-edit | A short edit of perfumes for an occasion, season or climate, with a line on each. |
wardrobe-composer | Three to five perfumes that cover different moments, built around what the person already loves. |
perfumery-lexicon | Plain-language meaning of a perfumery term such as sillage, chypre, fougère or EDP versus EDT. |
journal-search | Scento journal articles on a perfume, house, material or topic. |
Pass lang (de, fr, es, it, ro, el, hu, cs, pl) to receive scento.com links in that language.
The same answers are available as a perfume API over plain HTTP.
Three raw JSON-RPC calls are in examples/.
npm/: the Node stdio bridge, published as scento-perfume-api on npmpypi/: the Python stdio bridge, published as scento-perfume-api on PyPIserver.json: metadata for the Official MCP Registry (com.scento/perfume-api)MIT for the bridge code in this repository. The perfume database content is served from scento.com under its terms.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/perfume-mcp-server to learn what the "Perfume Mcp Server" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
npx -y scento-perfume-api # Node 18+uvx scento-perfume-api # Python 3.9+| Name | What it does |
|---|---|
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 |
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 |
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 li |
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 b |
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 (syno |
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, containi |
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, |
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 famili |
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 d |
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 (synonym |
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 |
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 S |
| Name | What it does |
|---|---|
find-signature-scent | Build a short, sourced list of perfumes to try from the perfumes or notes someone loves and what they avoid. |
compare-perfumes | Compare two to four perfumes side by side and recommend one for a stated use. |
| Name | What it does |
|---|---|
fragrance-families | Every Scento fragrance family with its definition, subfamilies and how many perfumes in the database lead with it. Use it to explain how perfume is grouped before calling family-map or perfume-portrai |
perfume-houses | Every perfume house in the database with its country, founding year, style (designer, heritage, niche, Arabian or artisan), number of perfumes and its scento.com page when it has one. Use it to resolv |
Read live from the server on November 15, 2026.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/perfume-mcp-server)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "perfume-mcp-server" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.