Scento Perfume API (MCP server): Perfume API, Fragrance API and Perfume MCP Server
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/developersClaude: 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
| 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.
Twelve perfume and fragrance tools
| 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.
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
Three raw JSON-RPC calls are in examples/.
Repository layout
npm/: the Node stdio bridge, published asscento-perfume-apion npmpypi/: the Python stdio bridge, published asscento-perfume-apion PyPIserver.json: metadata for the Official MCP Registry (com.scento/perfume-api)
Licence
MIT for the bridge code in this repository. The perfume database content is served from scento.com under its terms.
