MCP Server

Perfume Picks

io.github.bguillow-rgb/perfume-picks
Commerce & Retail Public & reachable MCP 2026-07-28

What this MCP does

Searches and compares fragrances, identifies dupes, provides wear and note data, and recommends scents by preferences, budget, and occasion.

compare_fragrances
Side-by-side comparison: note pyramids, shared and distinct accords, longevity/sillage/compliment scores, concentration, and price difference.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['fragrance_a', 'fragrance_b'], 'properties': {'fragrance_a': {'type': 'string', 'maxLength': 200, 'description': 'First fragrance â\x80\x94 slug or name'}, 'fragrance_b': {'type': 'string', 'maxLength': 200, 'description': 'Second fragrance â\x80\x94 slug or name'}}, 'additionalProperties': False}
find_dupes
Curated dupes for a fragrance — cheaper scents documented to smell like the original, with match percentage and price comparison. The answer to 'what smells like X without the price tag'.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['fragrance'], 'properties': {'fragrance': {'type': 'string', 'maxLength': 200, 'description': 'Fragrance slug or name to find dupes for'}}, 'additionalProperties': False}
find_similar
Fragrances most similar to a given one, from Perfume Picks' precomputed similarity ranking over notes and accords.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['fragrance'], 'properties': {'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Max results (default 5)'}, 'fragrance': {'type': 'string', 'maxLength': 200, 'description': 'Fragrance slug or name'}}, 'additionalProperties': False}
get_fragrance
Detailed record for one fragrance: full note pyramid (top/heart/base), accords, concentration, community longevity/sillage/compliment scores, and MSRP. Accepts a Perfume Picks slug or a name like 'Bleu de Chanel'.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug_or_name'], 'properties': {'slug_or_name': {'type': 'string', 'maxLength': 200, 'description': 'Fragrance slug or name'}}, 'additionalProperties': False}
get_recommendations
Personalized fragrance picks from note/accord preferences (e.g. 'vanilla', 'oud', 'citrus'), a budget in USD, an occasion ('office', 'date night', 'gift', 'signature scent'), and gender presentation.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['preferences'], 'properties': {'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Max results (default 5)'}, 'budget': {'type': 'number', 'minimum': 0, 'description': 'Max MSRP in USD'}, 'gender': {'enum': ['masculine', 'feminine', 'unisex'], 'type': 'string', 'description': 'Marketed gender category of the fragrance; omit to include all'}, 'occasion': {'type': 'string', 'maxLength': 120, 'description': 'What the fragrance is for'}, 'preferences': {'type': 'array', 'items': {'type': 'string', 'maxLength': 60}, 'maxItems': 20, 'minItems': 1, 'description': "Notes or accords the wearer enjoys, e.g. ['vanilla','amber','rose']"}}, 'additionalProperties': False}
search_fragrances
Full-text search across 13,000+ fragrances in the Perfume Picks database. Filter by brand, fragrance family, gender, and MSRP (USD). Returns note pyramids, accords, and community wear scores with source attribution.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'brand': {'type': 'string', 'maxLength': 200, 'description': "Brand name filter, e.g. 'Dior'"}, 'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Max results (default 10, max 10)'}, 'query': {'type': 'string', 'maxLength': 120, 'description': 'Free-text search: fragrance or brand name'}, 'gender': {'enum': ['masculine', 'feminine', 'unisex'], 'type': 'string', 'description': 'Marketed gender category of the fragrance; omit to include all'}, 'price_max': {'type': 'number', 'minimum': 0, 'description': 'Maximum MSRP in USD'}, 'price_min': {'type': 'number', 'minimum': 0, 'description': 'Minimum MSRP in USD'}, 'fragrance_family': {'type': 'string', 'maxLength': 120, 'description': "Family filter, e.g. 'woody', 'amber', 'fresh'"}}, 'additionalProperties': False}
trending_fragrances
Fragrances Perfume Picks users are adding to their wardrobes most over the last 30 days (falls back to catalog popularity when live activity data is unavailable). The method used is labeled in the response.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Max results (default 10, max 10)'}}, 'additionalProperties': False}
what_to_wear_tonight
A fragrance suggestion for right now, based on mood, occasion (e.g. 'date', 'office tomorrow', 'night out', 'cozy evening in'), and season — scored with Perfume Picks' community compliment, office-safety, and versatility data.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'mood': {'type': 'string', 'maxLength': 120, 'description': "How you're feeling"}, 'gender': {'enum': ['masculine', 'feminine', 'unisex'], 'type': 'string', 'description': 'Marketed gender category of the fragrance; omit to include all'}, 'season': {'enum': ['winter', 'spring', 'summer', 'fall'], 'type': 'string', 'description': 'Season to weight the pick toward â\x80\x94 heavier, warmer scents in winter; fresher in summer'}, 'occasion': {'type': 'string', 'maxLength': 120, 'description': 'The setting'}}, 'additionalProperties': False}
Added
what_to_wear_tonight
Sept. 17, 2026, 12:40 p.m.
Added
trending_fragrances
Sept. 17, 2026, 12:40 p.m.
Added
compare_fragrances
Sept. 17, 2026, 12:40 p.m.
Added
get_recommendations
Sept. 17, 2026, 12:40 p.m.
Added
find_similar
Sept. 17, 2026, 12:40 p.m.
Added
find_dupes
Sept. 17, 2026, 12:40 p.m.
Added
get_fragrance
Sept. 17, 2026, 12:40 p.m.
Added
search_fragrances
Sept. 17, 2026, 12:40 p.m.