Developersv1Stable slugs, CC BY-NC 4.0

Sniffbot API & MCP

The same Oracle brain behind the Sniffbot app, exposed two ways: MCP for agents (Claude, ChatGPT, Gemini, Cursor) and REST for servers. One source of truth — the Scent-Australia fragrance index.

Connect via MCP

Claude Desktop, Claude Code, Cursor:

claude mcp add sniffbot https://sniffbot.ai/api/mcp

ChatGPT / any MCP-speaking client:

{
  "name": "sniffbot",
  "url": "https://sniffbot.ai/api/mcp",
  "transport": "http"
}

Auth & API keys

MCP uses OAuth 2.1 + PKCE; REST uses bearer API keys issued from your settings page.

# REST
curl https://api.sniffbot.ai/v1/perfumes/noir-brut-xxi \
  -H "Authorization: Bearer sk_live_…"

REST endpoints

Method	Path	Purpose
GET	/v1/perfumes/:slug	Full perfume record
GET	/v1/brands	Paginated brand list
GET	/v1/brands/:slug/perfumes	Perfumes from a brand
GET	/v1/notes	All notes + counts
GET	/v1/notes/:slug/perfumes	Perfumes featuring a note
POST	/v1/match	Natural-language match
POST	/v1/ask	Oracle answer (Premium)
GET	/v1/dupes/:slug	Closest alternatives

POST /v1/match

curl https://api.sniffbot.ai/v1/match \
  -H "Authorization: Bearer sk_live_…" \
  -d '{"query":"warm, smoky, winter office"}'

llms.txt

LLM crawlers should start at /llms.txt. Stable slugs, citation-friendly, CC BY-NC 4.0.

Rate limits

Free: 60 REST req/min, no Oracle
Premium: 600 REST req/min, 50 Oracle calls/day
Enterprise: contact us