Skip to main content

MCP tools reference

ScentSell MCP lets your AI assistant work with your fragrance life. You can talk normally. The AI chooses the tool.

There are two surfaces:

  • MCP app tools: cabinet, wear logging, shelves, wishlist, share cards, marketplace, profile, offers.
  • SniffBot Oracle tools: fragrance reasoning, catalogue search, memory, taste profile, wear recommendations, layering, safety checks.

The live SniffBot registry currently has 65 enabled tools. Some AI clients cache schemas; if a tool looks stale, start a new chat or reconnect the MCP server.

Best prompts by job​

Build my cabinet​

Add Gris Charnel Extrait 100ml, about 80 percent full, to my cabinet.

Paste this list into my cabinet: Hacivat, Ani X, Wulong Cha X.

Useful tools: add_to_collection, bulk_add_to_cabinet, get_my_collection, list_unconfirmed_cabinet_items, confirm_cabinet_item.

Log what I wore​

I wore Corfu this morning, 3 sprays, casual, rating 7.75.

Show me today’s wears.

Useful tools: log_wear, get_today_wear, get_wear_history, update_wear_log, delete_wear_log.

What gets saved: fragrance, time, timezone-derived time of day, occasion, weather, sprays, rating, notes, layers.

Track compliments​

Someone complimented Corfu this morning. They said I smelled fresh and clean.

Add a compliment to today’s Corfu wear. Source was partner.

Useful tools: add_compliment, get_wear_history, get_today_wear.

What gets saved: compliment source, quote, fragrance, optional wear link, and a SniffBot memory fact.

Ask what to wear​

What should I wear today?

SniffBot should check weather, cabinet, wear history, taste profile, recent rotation, ratings, and compliments. If your plan is vague, it should ask one short follow-up: indoors/outdoors, skin-scent/noticeable, clean/loud.

Useful tools: ask_sniffbot, get_current_weather, get_taste_profile, get_wear_history, get_user_collection.

Layer fragrances​

What can I layer with Corfu to make it cleaner but still noticeable?

Score Corfu with Wulong Cha for a humid indoor day.

Useful tools: score_layering_combo, verify_layering_combo, get_layering_rules, get_my_collection, ask_sniffbot.

score_layering_combo returns a score out of 100, reasons, warnings, spray plan, and application order.

Create shelves​

Create a clean office-safe shelf and add Corfu, Wulong Cha, and Reflection Man.

Reorder my date night shelf and put Gris Charnel first.

Useful tools: create_wall, add_to_wall, remove_from_wall, rename_wall, reorder_wall, delete_wall, get_walls, get_wall.

Share cards​

Give me a share card for my compliment on Corfu.

Make a portrait share card for my summer shelf.

Make a shareable list of my most complimented bottles.

Useful tools: get_cabinet_highlights, get_house_lists, get_au_house_spotlights, get_share_card_png, create_share_link, log_share_event, log_share_landing.

Track what I want next​

Add BDK Gris Charnel Extrait to my wish list.

Show my marketplace watch list.

Useful tools: get_wishlist, add_to_wishlist, remove_from_wishlist, update_wishlist_priority, get_listing_watchlist.

Wish list means fragrance targets you want to buy next. Watch list means specific marketplace listings you have hearted.

MCP can return a card link. Saving the PNG into Photos requires the ScentSell app/browser native share sheet. MCP cannot silently write to your phone’s Photos app.

Clean up my data​

Audit my cabinet for duplicates and missing concentrations.

Merge these duplicate cabinet rows.

Useful tools: audit_my_cabinet, set_cabinet_concentration, merge_cabinet_duplicates, fix_catalogue_slug, get_cabinet_items_by_id.

Remember my taste​

Remember I hate syrupy vanilla.

My partner likes clean musks but hates smoky oud.

Useful tools: add_remembered_fact, forget_fact, recall_facts, add_partner_preference, recommend_gift_for_partner.

Tool groups​

Collection​

  • get_my_collection: read your cabinet.
  • get_cabinet_highlights: read story-ready cabinet lists: top rated, most worn this year, most complimented, and newest.
  • get_house_lists: read house-level social lists like "Houses I really love" and "Houses I want more of".
  • get_au_house_spotlights: read Australian niche/indie house spotlight lists and direct share-card URLs.
  • add_to_collection: add one bottle, decant, sample, or travel spray.
  • remove_from_collection: soft-remove a cabinet item.
  • bulk_add_to_cabinet: add a pasted list.
  • update_collection_item: edit size, fill, notes, rating, type, or display overrides.
  • list_unconfirmed_cabinet_items: show AI-added rows that need checking.
  • confirm_cabinet_item: clear the AI-added confirmation flag.

Wish list and listing watch list​

  • get_wishlist: read personal fragrance targets you want next.
  • add_to_wishlist, remove_from_wishlist, update_wishlist_priority, set_wishlist_sampled: manage the Cabinet Wish list.
  • get_listing_watchlist: read specific marketplace listings you are watching.

Wear diary​

  • log_wear: log a wear. Ratings support decimals.
  • get_today_wear: show today in your timezone.
  • get_wear_history: read past wears with weather, rating, layers, and time of day.
  • update_wear_log: edit notes, occasion, sprays, or rating.
  • delete_wear_log: remove an accidental wear.
  • add_wear_note: append a note.
  • get_scent_of_day_data, get_weekly_recap_data, get_monthly_recap_data: data behind share cards.

Compliments​

  • add_compliment: log a compliment and optionally attach it to a wear.

Compliments become a learning signal for SniffBot. They help answer questions like “what gets me compliments?” or “what does my partner seem to like?”

SniffBot Oracle​

  • ask_sniffbot: freeform fragrance expert.
  • search_catalogue, search_catalogue_by_notes, get_fragrance_details: catalogue grounding.
  • get_taste_profile: private behaviour-derived taste profile.
  • get_current_weather: current weather for your postcode.
  • score_layering_combo, verify_layering_combo: layering advice.
  • verify_recommendation, verify_blind_buy: recommendation and buying safety checks.
  • search_knowledge_base: books, fragrance families, layering theory, AU niche docs, marketplace rules.

Shelves and wishlist​

  • get_walls, create_wall, get_wall, update_wall, rename_wall, delete_wall.
  • add_to_wall, remove_from_wall, reorder_wall, replace_wall_items.
  • get_wishlist, add_to_wishlist, remove_from_wishlist, update_wishlist_priority, set_wishlist_sampled.

Marketplace​

  • search_marketplace, get_listing_details, create_listing_draft.
  • make_offer, respond_to_offer, get_my_offers.
  • get_recently_sold, get_curated_collections.
  • set_brand_alert, get_brand_alerts, remove_brand_alert.

Safety and recovery​

  • export_cabinet_json: backup cabinet state.
  • nuke_cabinet: destructive full wipe, exact confirm phrase required.
  • restore_cabinet: restore archived cabinet rows.
  • bulk_remove_items, bulk_archive_cabinet_items, bulk_import_cabinet: bulk operations with guardrails.

What SniffBot learns from these tools​

SniffBot learns from:

  • ratings
  • wears
  • weather and time of day
  • compliments
  • shelves
  • wishlist
  • remembered preferences and dislikes
  • thumbs up/down feedback

See How SniffBot learns.

Next steps: