scentrev-mcp

npx add-mcp 'https://api.scentrev.com/mcp/'

Documentação do MCP de Perfumes

22 ferramentas MCP de perfumes que transformam conhecimento comunitário sobre fragrâncias em dados limpos e estruturados. Pergunte em português simples - seu agente cuida do resto.

Você pergunta · seu agente chama a API

"Melhor perfume modo beast-mode de inverno da Lattafa?"

Sem SQL, sem slugs para decorar. Pergunte em linguagem natural. Cada ferramenta abaixo inclui exemplos prontos para copiar nesse caso de uso exato.

Experimente as ferramentas ao vivo no Playground

Usuários autenticados podem executar qualquer uma das 22 ferramentas MCP pelo painel — sem precisar de Cursor ou Claude. Visitantes podem navegar pelos prompts de receitas e entrar para testar ao vivo.

Folha de referência de categorias

Rótulos de filtro exatos para search_fragrances_filtered e ferramentas de blend: longevidade, rastro (sillage), avaliação, apreciação, ordenação por discovery e mais.

Abrir pontuação e categorias

01

Gere uma chave

Entre com Google, GitHub ou e-mail, depois crie uma chave na página API Keys. Uma chave ativa por conta.

02

Adicione a configuração

Cole o bloco OAuth (somente URL) no Cursor, Claude ou VS Code e aproveite o prompt do navegador. Ou cole uma chave bearer. Chamadas REST usam a chave.

03

Pergunte à vontade

Digite uma pergunta em linguagem natural. Seu agente escolhe a ferramenta certa e retorna dados estruturados de longevidade, rastro, notas e sentimento.

O que você pode perguntar

Três fluxos comuns. Escolha uma ferramenta na barra lateral para mais exemplos ligados àquele endpoint.

Descobrir

search_fragrances → search_fragrances_filtered

• "Encontre Creed Aventus."
• "Melhores perfumes de escritório para o verão com rastro moderado."
• "Joias escondidas da Lattafa com longevidade forte."

Analisar uma fragrância

get_fragrance_profile · get_performance · get_appreciation

• "Perfil completo do Creed Aventus."
• "O Layton é marcante ou discreto?"
• "As pessoas amam o Club de Nuit Intense?"

Comparar e misturar

get_reminds_of · search_by_references

• "O que tem cheiro parecido com Aventus, mas mais barato?"
• "Misturar Aventus com Oud Wood."
• "Alternativas ao Lost Cherry."

Conecte-se com OAuth

Aponte o cliente para https://api.scentrev.com/mcp/ sem chave de API. Ele abre a página de consentimento, você entra e o cliente armazena um token.

Cursor, Claude Desktop e VS Code podem entrar via OAuth. Use isso quando não quiser colar uma chave frag_live_. Chamadas REST ainda precisam de uma chave de API.

1. 1Adicione o servidor apenas com a URL. Não cole uma chave de API.
2. 2Salve e recarregue o cliente. Ele abre uma janela do navegador para você entrar.
3. 3Entre com Google, GitHub ou e-mail e escolha Permitir.
4. 4As ferramentas de fragrância aparecem no cliente. Revogue-as depois em Configurações.

Cursor / Claude / VS Code

{
  "mcpServers": {
    "scentrev-mcp": {
      "url": "https://api.scentrev.com/mcp/"
    }
  }
}

Depois de permitir o acesso, o aplicativo aparece em Configurações → Aplicativos conectados.

Ou conecte-se com uma chave de API

A mesma chave bearer funciona para MCP e para chamadas REST diretas em https://api.scentrev.com.

Cursor / Claude Desktop · mcp.json

{
  "mcpServers": {
    "scentrev-mcp": {
      "url": "https://api.scentrev.com/mcp/",
      "headers": {
        "Authorization": "Bearer frag_live_YOUR_KEY"
      }
    }
  }
}

Gere a chave pelo painel depois de entrar. Criar uma nova chave revoga a anterior.

Instale no Smithery

Conecte-se pelo Smithery com sua chave de API. Mesmo endpoint upstream e mesmas ferramentas de uma configuração MCP direta.

Listado no PeerPush

Encontre scentrev-mcp no PeerPush e deixe uma avaliação se o MCP de perfumes for útil no seu stack.

Regras de saída

Quatro invariantes que toda resposta segue, para você confiar no formato dos dados sobre os quais está construindo.

Somente proporções

Curtidas, não curtidas, JSON de votos e médias de estrelas de 0 a 5 nunca são expostos. Você recebe pontuações normalizadas. A avaliação por estrelas é de 0 a 5 - converta com pontuação × 5, nunca × 10.

n_records, não confiança

Cada métrica traz n_records - quantos votos da comunidade a moldaram. Acima de 500 é um sinal forte; abaixo de 100 são dados fracos.

0-1 em tudo

Todas as métricas de uso são normalizadas para 0-1 com um rótulo de categoria. A única exceção: porcentagens de acordes variam de 0 a 100.

Avaliação vs. resenhas

A avaliação por estrelas usa n_records (votos de avaliação) em uma escala de 0 a 5. reviews_count é quantas resenhas escritas existem - um número separado, não uma pontuação de /5 ou /10.

Um objeto de métrica típico

Pontuação, categoria, contagem de votos e como ler o eixo - sempre.

{
  "score": 0.62,
  "category": "moderate",
  "n_records": 1240,
  "scale": "0 = X, 1 = Y"
}

Pronto para construir? Obtenha sua chave de API