Serveur MCP

Perfume Picks

io.github.bguillow-rgb/perfume-picks
Commerce et retail Public et accessible MCP 2026-07-28

Ce que fait ce MCP

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.
Lecture seule Idempotent
Schéma d’entrée
{'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'.
Lecture seule Idempotent
Schéma d’entrée
{'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.
Lecture seule Idempotent
Schéma d’entrée
{'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'.
Lecture seule Idempotent
Schéma d’entrée
{'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.
Lecture seule Idempotent
Schéma d’entrée
{'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.
Lecture seule Idempotent
Schéma d’entrée
{'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.
Lecture seule Idempotent
Schéma d’entrée
{'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.
Lecture seule Idempotent
Schéma d’entrée
{'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}
Ajouté
what_to_wear_tonight
17 September 2026 12:40
Ajouté
trending_fragrances
17 September 2026 12:40
Ajouté
compare_fragrances
17 September 2026 12:40
Ajouté
get_recommendations
17 September 2026 12:40
Ajouté
find_similar
17 September 2026 12:40
Ajouté
find_dupes
17 September 2026 12:40
Ajouté
get_fragrance
17 September 2026 12:40
Ajouté
search_fragrances
17 September 2026 12:40