Perfume
FreeNot checkedFree perfume MCP server and perfume API: 1,500+ perfumes, 160+ houses, 400+ raw materials with verified notes pyramids, scent families and similar scents. 12 to
About
Free perfume MCP server and perfume API: 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. Works in Claude, ChatGPT and Cursor. By Scento.
README
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
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.
Installing Perfume
This server has no published package — it is built from source. Open the repository and follow its README.
▸ github.com/Scento-com/perfume-mcp-serverFAQ
Is Perfume MCP free?
Yes, Perfume MCP is free — one-click install via Unyly at no cost.
Does Perfume need an API key?
No, Perfume runs without API keys or environment variables.
Is Perfume hosted or self-hosted?
Self-hosted: the server runs locally on your machine via the install command above.
How do I install Perfume in Claude Desktop, Claude Code or Cursor?
Open Perfume on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
Postgres
Query your database in natural language
by Anthropicwenb1n-dev/SmartDB_MCP
Connect to multiple databases at once (MySQL, PostgreSQL, SQL Server, MariaDB, Dameng, Oracle) for operations, health analysis and SQL optimization.
by wenb1n-devPostgres Server
This server enables interaction with PostgreSQL databases through the Model Context Protocol, optimized for the AWS Bedrock AgentCore Runtime. It provides tools
by madhurprashPostgreSQL
Read-only database access with schema inspection.
by modelcontextprotocolRedis
Interact with Redis key-value stores.
by modelcontextprotocolSQLite
Database interaction and business intelligence capabilities.
by modelcontextprotocolmxcp
Open-source framework for building enterprise-grade MCP servers using just YAML, SQL, and Python, with built-in auth, monitoring, ETL and policy enforcement.
by raw-labsjulien040/anyquery
Query apps with SQL from a single local-first binary; also connects to PostgreSQL, MySQL and SQLite-compatible databases.
by julien040drakonkat/wizzy-mcp-tmdb
Search and retrieve movie, TV show and person information from The Movie Database (TMDB) API.
by drakonkatlongevity-genie/opengenes-mcp
Query the OpenGenes database for aging and longevity research.
by longevity-genieCompare Perfume with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All data MCPs
