Fragrance & Perfume MCP (Noteboxd)
Fragrance & perfume MCP: search fragrances, notes, accords, brands, perfumers, reviews & charts.
| Endpoint | https://mcp.noteboxd.com/mcp (streamable-http) |
|---|---|
| Registry version | 0.1.4 |
| Now | 27 tools · grade C (69) · pin ts_fd76fbc1741fbcf5496a573857ad4063 · protocol 2025-06-18 |
| First / last listed | 2026-11-09 02:04 UTC / 2026-11-09 02:04 UTC |
| Grade over time | 2026-11-09: C (69), 27 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: noteboxd_open search trending fragrance_similar charts_list chart_get notes_list ai_recommend ai_wear_today ai_collection fragrance_search fragrance_get fragrance_get_reviews fragrance_get_wearing_stats brand_get perfumer_get note_explore fragrance_compare fragrance_review_digest user_get_cabinet user_get_wishlist user_get_collections user_get_reviews user_get_wearing_history user_taste_public user_taste_summary user_taste_compare
noteboxd_open | Open the Noteboxd app UI in ChatGPT. Call with no arguments to show the home screen (trending fragrances), with `query` to run a fragrance search inside the app, or with `fragrance` (slug or UUID) to show a fragrance profile. The app renders the returned result; keep the chat reply to one short line. params: fragrance, query, context* |
search | Universal search across all Noteboxd entities — fragrances, brands, notes, perfumers, and collections — in a single call. Best for quick lookups and vague queries.
Examples:
- "Jacques Polge" → returns the perfumer
- "oud" → returns the note, plus top oud fragrances
- "Bleu" → returns Bleu de Chanel, Bleu de Dior, etc.
See also: `fragrance_search` for advanced fragrance-only filtering (by note, params: query*, response_format, context* |
trending | What's trending on Noteboxd right now — top search queries, highest-rated fragrances, and most popular notes. No parameters needed.
See also: `charts_list` for full ranking leaderboards · `fragrance_search` to explore specific categories. params: response_format, context* |
fragrance_similar | Find fragrances with similar accord profiles to a given fragrance. Returns ranked alternatives based on shared accords and character.
See also: `fragrance_get` for the source fragrance's full profile · `fragrance_search` with note/accord filters for manual exploration. params: id*, response_format, context* |
charts_list | List all available Noteboxd chart rankings (e.g. top-rated, trending, top by brand). Returns chart names and summary stats.
See also: `chart_get` with a chart slug to see the full leaderboard · `trending` for a quick snapshot of what's hot. params: response_format, context* |
chart_get | Get a specific chart leaderboard by slug (e.g. 'top-rated', 'trending', 'top-rated-brand-chanel'). Returns ranked fragrances with scores and movement.
See also: `charts_list` to see all available charts · `fragrance_get` for the full profile of any fragrance on the chart. params: slug*, response_format, context* |
notes_list | Browse fragrance notes — filter by family (e.g. 'woody', 'floral', 'citrus') and sort by popularity or name. Returns note names, families, colours, and fragrance counts.
See also: `note_explore` for a single note's full profile and top fragrances · `fragrance_search` with the `note` filter to find fragrances featuring a specific note. params: sort, family, limit, response_format, context* |
ai_recommend | Get personalized fragrance recommendations based on your taste profile. Optional natural-language prompt to guide results (e.g. 'something fresh for summer'). Requires Pro.
See also: `ai_wear_today` for what to wear right now · `user_get_cabinet` for your collection. params: prompt, limit, response_format, context* |
ai_wear_today | What should I wear today? Picks from your owned cabinet (CURRENT status only) based on optional prompt/weather. Returns nothing if your cabinet is empty. Requires Pro.
See also: `ai_recommend` for discovery beyond your cabinet · `user_get_cabinet` for your full collection. params: prompt, weather, response_format, context* |
ai_collection | Generate a curated fragrance collection from a natural-language prompt (e.g. 'office-safe designer scents under $100', 'niche oud masterpieces'). Returns 5–25 grounded picks with rationale. Requires Pro.
See also: `ai_recommend` for personalized picks · `fragrance_search` for manual filtering. params: prompt*, size, response_format, context* |
fragrance_search | Search and filter the Noteboxd fragrance encyclopedia. Requires a query or at least one filter — the full catalogue cannot be listed.
Tip: The `q` parameter searches fragrance names OR brand names independently. For best results with a known brand, use the `brand` slug filter instead of including the brand name in `q`.
Examples:
- "Find woody fragrances above 8/10" → accord='woody' + minScore=8
params: query, brand, note, accord, concentration, gender, minScore, sort, page, limit, response_format, context* |
fragrance_get | Get the full profile for a single fragrance by UUID or slug (e.g. 'tom-ford/oud-wood'). Returns notes pyramid, accords, FOTW classification, perfumer, community score, and more.
See also: `fragrance_similar` for fragrances with similar accord profiles · `fragrance_get_reviews` for community reviews · `fragrance_get_wearing_stats` for when people wear it. params: id, slug, response_format, context* |
fragrance_get_reviews | Get paginated community reviews for a fragrance. Sort by helpfulness, recency, or score.
See also: `fragrance_get` for the fragrance's full profile · `fragrance_get_wearing_stats` for aggregate wearing data. params: id*, sort, cursor, limit, response_format, context* |
fragrance_get_wearing_stats | Community wearing counts for a fragrance. Free tier sees the last 30 days; Pro also sees today and the last 7 days.
See also: `fragrance_get` for full profile · `fragrance_similar` for alternatives with similar profiles. params: id*, response_format, context* |
brand_get | Get a brand profile (name, country, founded, description) and its top fragrances. Use the brand slug, e.g. 'maison-francis-kurkdjian'.
See also: `fragrance_search` with the `brand` filter to get the full paginated catalogue for this brand · `perfumer_get` if the brand has a known house perfumer. params: slug*, response_format, context* |
perfumer_get | Get a perfumer's profile (bio, country, house affiliation) and their top fragrances by community score.
See also: `fragrance_search` to find more fragrances by this perfumer · `brand_get` if you want the brand they work for. params: slug*, response_format, context* |
note_explore | Get a note's profile (family, description, origin, extraction method) and top fragrances featuring it, sorted by community score. Use the note slug, e.g. 'oud', 'bergamot', 'iris'.
See also: `notes_list` to browse all notes by family/popularity · `fragrance_search` with the `note` filter to find fragrances featuring this note. params: note*, response_format, context* |
fragrance_compare | Compare two fragrances head-to-head — shared vs. distinct notes/accords/families, community and critic scores, audience, and an AI-written synthesis (shared character, differences, who each suits). Public, cached 7 days per pair.
See also: `fragrance_get` for full profiles · `fragrance_similar` for alternatives. params: fragrance_a*, fragrance_b*, response_format, context* |
fragrance_review_digest | Get a concise AI-generated digest summarizing a fragrance's community reviews — key themes, consensus, and standout opinions. Public, cached per fragrance.
See also: `fragrance_get_reviews` for individual reviews · `fragrance_get` for full profile. params: id*, response_format, context* |
user_get_cabinet | Get your fragrance cabinet — fragrances you own, have tried, or finished. Free for any signed-in account.
See also: `fragrance_get` for full details on any fragrance in your cabinet · `fragrance_similar` to find alternatives to your favourites · `user_get_wishlist` for fragrances you want to try. params: status, sort, cursor, limit, response_format, context* |
user_get_wishlist | Get your fragrance wishlist. Free for any signed-in account.
See also: `fragrance_get` for full details on any wishlist fragrance · `user_get_cabinet` for fragrances you already own. params: cursor, limit, response_format, context* |
user_get_collections | Get your collections (fragrance lists). Optionally pass a collectionId to see its items. Free for any signed-in account.
See also: `fragrance_get` for full details on any fragrance in a collection. params: collectionId, response_format, context* |
user_get_reviews | Get reviews you've written, or reviews you found helpful. Free for any signed-in account.
See also: `fragrance_get_reviews` for community reviews on a specific fragrance. params: kind, cursor, limit, response_format, context* |
user_get_wearing_history | Get your wearing check-in history over time. Free for any signed-in account.
See also: `fragrance_get_wearing_stats` for aggregate community wearing data on a specific fragrance. params: cursor, limit, response_format, context* |
user_taste_public | Get a user's public taste profile — their top notes, accords, and families derived from their collection and reviews. No LLM call, deterministic.
See also: `user_taste_compare` for compatibility between two users. params: username*, response_format, context* |
user_taste_summary | Get your AI-generated taste profile summary — a natural-language description of your fragrance preferences based on your cabinet, reviews, and likes. Requires Pro.
See also: `user_taste_public` for the deterministic breakdown · `user_taste_compare` for compatibility. params: response_format, context* |
user_taste_compare | Compare your taste with another user — compatibility score, shared and divergent notes/accords/families, and an optional AI overview. Free for any signed-in account; the AI overview needs Pro and is left out otherwise.
See also: `user_taste_public` for a user's top preferences · `user_taste_summary` for your own summary. params: target_user_id*, with_overview, response_format, context* |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.