{
  "markdown": "# Noteboxd Fragrance & Perfume MCP\n\nA [Model Context Protocol](https://modelcontextprotocol.io) server (and API) for **fragrance and\nperfume** data. Connect Claude, ChatGPT, Cursor, or any MCP client to the\n[Noteboxd](https://www.noteboxd.com) fragrance encyclopedia: fragrances, notes, accords, brands,\nperfumers, community reviews, and charts.\n\n[![npm version](https://img.shields.io/npm/v/@noteboxd/mcp?color=2b54d4)](https://www.npmjs.com/package/@noteboxd/mcp)\n[![license](https://img.shields.io/npm/l/@noteboxd/mcp?color=2b54d4)](./LICENSE)\n\nOnce connected, you can ask things like:\n\n- \"I own Oud Wood and Aventus. What else should I try for cold-weather formal wear?\"\n- \"Compare Bleu de Chanel and Dior Sauvage.\"\n- \"What are reviewers saying about Baccarat Rouge 540?\"\n\nThe assistant answers from Noteboxd's data instead of guessing.\n\n## Quickstart\n\n1. Create an API key at [developers.noteboxd.com](https://developers.noteboxd.com). The free tier is 50 calls/day and needs no card.\n2. Add the server to your MCP client (see below).\n3. Ask your assistant about fragrance.\n\n```bash\nNOTEBOXD_API_KEY=nb_live_your_key npx -y @noteboxd/mcp\n```\n\n## Install\n\nEvery client uses the same command (`npx -y @noteboxd/mcp`) with your key in `NOTEBOXD_API_KEY`.\n\n### Claude Desktop / Claude Code\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"noteboxd\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@noteboxd/mcp\"],\n      \"env\": { \"NOTEBOXD_API_KEY\": \"nb_live_your_key\" }\n    }\n  }\n}\n```\n\n### Cursor\n\n[![Add to Cursor](https://img.shields.io/badge/Add%20to-Cursor-000000)](cursor://anysphere.cursor-deeplink/mcp/install?name=noteboxd&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBub3RlYm94ZC9tY3AiXSwiZW52Ijp7Ik5PVEVCT1hEX0FQSV9LRVkiOiJuYl9saXZlX1lPVVJfS0VZIn19)\n\nThen set your real key. Or add the JSON block above to `~/.cursor/mcp.json`.\n\n### VS Code\n\n```json\n{\n  \"servers\": {\n    \"noteboxd\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@noteboxd/mcp\"],\n      \"env\": { \"NOTEBOXD_API_KEY\": \"nb_live_your_key\" }\n    }\n  }\n}\n```\n\n### Hosted alternative\n\nNoteboxd also runs a hosted MCP server at `https://mcp.noteboxd.com/mcp` (Streamable HTTP, with\nOAuth sign-in) if you would rather not run anything locally. This package is the local,\nopen-source option.\n\n## Tools\n\nAll tools are read-only and return JSON. Each call is authenticated with your key and counts\nagainst your Noteboxd developer plan (the free tier covers 50 calls/day).\n\n### Search and discovery\n| Tool | Description |\n| --- | --- |\n| `search` | Search across fragrances, brands, notes, perfumers, collections |\n| `search_fragrances` | Filter fragrances by query, brand, note, family, or price range |\n| `trending` | Trending searches and most-worn fragrances |\n| `list_charts`, `get_chart` | Chart rankings and leaderboards |\n\n### Fragrances\n| Tool | Description |\n| --- | --- |\n| `get_fragrance` | Full profile: notes, accords, perfumer, community score |\n| `get_fragrance_reviews` | Paginated community reviews |\n| `get_similar_fragrances` | Fragrances with a similar accord profile |\n| `get_wearing_stats` | Wearing counts over recent windows |\n| `compare_fragrances` | Two fragrances compared side by side |\n| `get_review_digest` | Short summary of a fragrance's reviews |\n| `batch_get_fragrances` | Up to 50 fragrances by id in one call |\n| `enrich_fragrance` | Profile plus notes, accords, reviews, and similar in one call |\n\n### Brands, perfumers, notes\n| Tool | Description |\n| --- | --- |\n| `get_brand`, `list_brand_fragrances` | Brand profile and catalogue |\n| `get_perfumer` | Perfumer profile and top creations |\n| `list_notes`, `get_note` | Browse notes and single-note profiles |\n| `list_accords` | List accord families |\n\n## Configuration\n\n| Variable | Required | Description |\n| --- | --- | --- |\n| `NOTEBOXD_API_KEY` | yes | Your `nb_live_` key from [developers.noteboxd.com](https://developers.noteboxd.com) |\n| `NOTEBOXD_API_BASE_URL` | no | Override the API origin (default `https://api.noteboxd.com`) |\n\nYou can also pass the key with `--api-key nb_live_...`.\n\n## How it works\n\nThis is a thin local server. It speaks MCP to your client over stdio and forwards each tool call\nto `api.noteboxd.com/v1` using your key. It stores no data and holds no credentials beyond the key\nyou provide.\n\n```\nAI client  --stdio-->  noteboxd-mcp  --HTTPS + your key-->  api.noteboxd.com/v1\n```\n\n## Examples\n\nSee [`examples/`](./examples) for runnable code: curl, TypeScript, and Python.\n\n## Pricing\n\nThe server is free and open source. API usage follows your Noteboxd developer plan: a free tier\n(50 calls/day), then pay-as-you-go per call. Most reads are $0.01; the AI tools cost a few cents.\nSee [developers.noteboxd.com/#pricing](https://developers.noteboxd.com/#pricing).\n\n## License\n\n[MIT](./LICENSE)\n",
  "bytes": 4807,
  "sha": "d64908fc7abf5e11c9d721d684767cb37a3c43a5ec2f446a45faadd545267601",
  "repo_slug": "noteboxd/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_noteboxd_mcp_6ed4a362/readme"
}