Scento Perfume API (MCP server)
Free perfume & fragrance API and MCP server: notes, families, similar scents, 1,400+ perfumes.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http scento-perfume-api-mcp-server 'https://www.scento.com/mcp'{
"mcpServers": {
"scento-perfume-api-mcp-server": {
"type": "http",
"url": "https://www.scento.com/mcp"
}
}
}scento-perfume-apiclaude mcp add scento-perfume-api-mcp-server -- npx -y scento-perfume-api@1.0.0{
"mcpServers": {
"scento-perfume-api-mcp-server": {
"command": "npx",
"args": [
"-y",
"scento-perfume-api@1.0.0"
]
}
}
}scento-perfume-apiclaude mcp add scento-perfume-api-mcp-server -- uvx scento-perfume-api==1.0.0{
"mcpServers": {
"scento-perfume-api-mcp-server": {
"command": "uvx",
"args": [
"scento-perfume-api==1.0.0"
]
}
}
}Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
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/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
| 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.
Questions fréquentes
Qu'est-ce que Scento Perfume API (MCP server) ?
Free perfume & fragrance API and MCP server: notes, families, similar scents, 1,400+ perfumes.
Comment installer Scento Perfume API (MCP server) ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http scento-perfume-api-mcp-server 'https://www.scento.com/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour Scento Perfume API (MCP server) ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
Scento Perfume API (MCP server) est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient Scento Perfume API (MCP server) ?
Il est publié par Scento-com. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.