Spaces:
Running
Download README.md from scento/perfume-api: direct link, hf CLI and curl.
- Browser
- Download file 2.31 kB
-
https://huggingface.co/spaces/scento/perfume-api/resolve/main/README.md
- Command line
-
hf download hf://spaces/scento/perfume-api/README.md
-
curl -L -o README.md https://huggingface.co/spaces/scento/perfume-api/resolve/main/README.md
title: 'Scento Perfume API: free perfume MCP server'
emoji: 🌿
colorFrom: yellow
colorTo: gray
sdk: static
pinned: false
license: mit
short_description: Free perfume API & MCP server, 1,500+ perfumes
tags:
- perfume
- perfume-api
- free-perfume-api
- perfume-mcp
- perfume-mcp-server
- fragrance
- fragrance-api
- perfume-notes
- perfume-database
- fragrance-ingredients
- mcp
- mcp-server
- openapi
- rest-api
- no-api-key
Scento Perfume API: free perfume API and MCP server
Perfume database API and MCP server by Scento. Free, no API key, REST + MCP + OpenAPI. Query 1,500+ perfumes across 160+ houses with full notes pyramids (top, heart, base), scent families and similar scents, plus a 400+ entry fragrance ingredients database of raw materials.
Twelve tools, one service: perfume-search, perfume-portrait, scent-neighbours, perfume-contrast, note-portrait, material-match, house-portrait, family-map, occasion-edit, wardrobe-composer, perfumery-lexicon, journal-search. Ask which perfumes smell like another, which notes a perfume contains, which perfumes use a given raw material (oud, iris, ambroxan, vetiver and more), how two fragrances differ, or what to wear for an occasion. Every answer links back to the Scento page for the perfume, house or material.
Quality over volume: each notes pyramid is traced to the house or an authorized retailer. Data is not scraped from forums or user-generated lists, so a perfume notes API call returns what the house actually publishes.
Connect: remote MCP at https://www.scento.com/mcp (Claude, ChatGPT, Cursor, VS Code, any MCP client), npm package scento-perfume-api, PyPI package scento-perfume-api, or REST at https://www.scento.com/api/perfume/v1 (OpenAPI at https://www.scento.com/api/perfume/v1/openapi.json). Responses in 10 languages. A free alternative to paid fragrance APIs for apps, bots, research and AI agents. Home: https://www.scento.com/developers
This Space is a live demo: search a perfume for its portrait, set two side by side, or look up a raw material. It runs in your browser against the public API.