scentrev-mcp logoscentrev-mcp

Perfume MCP guide

Perfume MCP server for AI coding agents

Searching for perfume MCP, fragrance MCP server, or Model Context Protocol perfume data? You are in the right place. scentrev-mcp is a free perfume MCP with 14 tools so LLM agents can recommend, compare, and explain fragrances with real community metrics - not hallucinated note lists.

What is a perfume MCP?

MCP (Model Context Protocol) is an open standard that lets AI assistants call external tools. A perfume MCP exposes fragrance search, profiles, and wear metrics as those tools. Instead of asking an LLM to invent notes for Creed Aventus, your agent calls get_fragrance_profile and gets normalized longevity, sillage, accords, and confidence counts.

scentrev-mcp is built for that job: India's first dedicated perfume MCP, covering 126,000+ fragrances over MCP and a matching fragrance API.

Why agents need a dedicated fragrance MCP

General web search returns inconsistent perfume descriptions. A fragrance MCP returns normalized JSON: star ratings on a 0-5 scale, wear performance buckets, season scores, accords with percentages, and “reminds me of” links backed by thousands of votes. That is what makes automated perfume assistants trustworthy.

  • Structured wear metrics

    Longevity, sillage, projection, season fit, and time-of-day scores with confidence categories - not scraped marketing copy.

  • Discovery and blending

    Filter by notes and accords, sort by rating or engagement, blend note pyramids from multiple reference fragrances, or compare side-by-side.

  • Agent-native perfume MCP

    Install in Cursor or Claude Desktop with a Bearer token. Tools return ratio-safe JSON capped at 10 rows so agents cannot mine the full catalog.

  • REST fragrance API fallback

    Every MCP tool maps to a PostgREST RPC on the same backend if you prefer HTTP from your own stack.

14 perfume MCP tools included

Search the catalog, apply advanced filters, fetch full profiles, list accords, find similar scents, compare fragrances, browse brands, and blend note pyramids from reference perfumes.

  • search_fragrances - Free-text search across the catalog
  • search_fragrances_filtered - Filter by brand, season, notes, discovery sort
  • search_by_references - Blend note pyramids from 2+ reference scents
  • list_brands - Browse brands with fragrance counts
  • resolve_slug - Resolve informal names to slugs
  • compare_fragrances - Side-by-side wear and value metrics
  • get_fragrance_profile - Every metric for one fragrance
  • get_wear_summary - When and where it shines
  • get_identity - Gender lean and character
  • get_performance - Longevity and sillage scores
  • get_appreciation - Community sentiment and love score
  • get_reminds_of - Closest-smelling alternatives
  • get_note_pyramid - Top, heart, and base notes
  • get_accords - Dominant accords, weighted

How to install this perfume MCP (under 2 minutes)

  1. Create a free API key. Sign in and generate a frag_live_… key. No credit card.
  2. Add the perfume MCP config. Paste https://api.scentrev.com/mcp/ into Cursor or Claude Desktop with Authorization: Bearer ….
  3. Ask your agent about perfume. Restart the client, then follow the perfume MCP docs for tool examples.

Open perfume MCP documentation

Perfume MCP FAQ

Common questions about perfume MCP servers, fragrance APIs, and connecting scentrev-mcp to your agent.

What is MCP and do I need it?
MCP (Model Context Protocol) is an open standard that lets AI assistants call external tools. Drop our config into Cursor or Claude Desktop and your agent can query fragrance data directly. No MCP client? Use the same key against the REST endpoints.
Where does the data come from?
Community fragrance knowledge - votes on longevity, sillage, seasonality, and sentiment - normalized into 0-1 scores with an n_records confidence count. Star ratings come from a 0-5 average (score × 5 for stars, not × 10). We never expose raw vote dumps, only stable, structured metrics.
How much does it cost?
It's free during the current period - no credit card, no quotas. Fair-use rate limiting applies to keep the service healthy for everyone.
How do I authenticate?
Generate one key in the dashboard and pass it as a bearer token. The same key works for MCP and REST. Generating a new key revokes the previous one.
Which clients are supported?
Any MCP-compatible client - Claude Desktop, Cursor, Cline, Windsurf, and LangChain among them. Anything that speaks HTTP can use the REST endpoints.
What is a perfume MCP server?
A perfume MCP server exposes structured fragrance data as Model Context Protocol tools so AI agents can call it directly. scentrev-mcp is India's first such server: instead of scraping fragrance sites, your agent queries normalized longevity, sillage, seasonality, accords, and community scores for 126,000+ perfumes through a single endpoint.
How do I connect scentrev-mcp to Cursor or Claude Desktop?
Add an mcpServers block pointing at the MCP endpoint with your bearer key, then restart the client - the fragrance tools appear automatically. The docs page has copy-paste config for Cursor and Claude Desktop, with your active API key injected when you're signed in.
How many fragrances and brands are in the database?
126,000+ fragrances across 7,500+ brands, including Lattafa, Creed, and most mainstream and niche houses. Every fragrance carries normalized 0-1 scores with an n_records confidence count.
What fragrance data does the API return?
Longevity, sillage, projection, seasonality, occasion fit, gender lean, dominant accords, full top/heart/base note pyramids, similar fragrances, and community appreciation - all normalized to stable 0-1 scores, plus 0-5 star averages.
Can I use the fragrance API without an MCP client?
Yes. Every MCP tool has a matching REST endpoint. Use the same bearer key with curl, JavaScript, Python, or any HTTP client - no MCP client required.
Is there a perfume MCP for Cursor?
Yes. scentrev-mcp is a perfume MCP for Cursor: paste one mcpServers block with your Bearer key, restart Cursor, and the fragrance tools appear. The Cursor perfume MCP setup page has the exact JSON.
What is the best fragrance API for developers?
If you need structured longevity, sillage, notes, and filters — not HTML from a review site — use a perfume database API like scentrev-mcp. It is the same catalog as the perfume MCP, exposed over REST with a free key.
Can ChatGPT use a perfume MCP or perfume API?
If your ChatGPT setup supports MCP servers, point it at the scentrev-mcp endpoint with a Bearer key. If it only speaks HTTPS, call the perfume API (REST) from an action or backend. Same fragrance data either way.
Do you offer a fragrance MCP as well as a perfume MCP?
Yes. scentrev-mcp is both a fragrance MCP and a perfume MCP — one server, one key. Fragrance MCP is the industry wording; perfume MCP is the same catalog. Start at the fragrance MCP page if that is the phrase you searched.
How is a fragrance MCP different from browsing Fragrantica?
A website is for humans. A fragrance MCP is for agents: stable JSON, capped result sets, normalized 0-1 scores, and no scraping. scentrev-mcp does not replace reading reviews; it gives models numbers they can filter on.

Related pages