PerfuMate MCP

An MCP server that allows AI agents to check perfume formulas against IFRA regulations, look up material properties and safety limits, and manage user-specific formulas and inventory shelves via OAuth integration.

Endpoint and access

No sign-in: your client connects and lists tools immediately, with no account or key.

No sign-inEndpoint checked 2026-10-19Operated by PerfuMate

MCP endpoint (Streamable HTTP)

https://perfumate.app/mcp

Vendor documentation

What you can do with it

Check a perfume formula against IFRA Category 4 limits
Look up material scent profiles and IFRA restrictions
Read and edit user's personal perfume formulas
Manage inventory and shelf contents

Tools advertised by the last live check:

search_materials
get_material
check_formula
find_starting_formula
my_account
list_formulas
get_formula
list_versions
create_formula
edit_formula
update_formula
rename_folder
duplicate_formula
save_version
branch_version
open_version
rename_version
list_shelf
get_shelf_material
add_to_shelf
update_bottle
make_dilution
update_material
list_batches
log_batch
journal_note
list_notes
write_note
list_shopping
shopping_list
set_preferences
delete_items
confirm_delete
list_deleted
restore_deleted
undo_last_change
get_scent_profile
find_substitutes
use_substitute
rebuild_from_shelf
insert_accord
view_accord
decompose_accord
resync_accord
scale_to_concentration

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers a Streamable HTTP server. Use --scope project to write .mcp.json for the repo.

Claude Code configuration

claude mcp add --transport http perfumate-mcp https://perfumate.app/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).

Codex configuration

codex mcp add perfumate-mcp --url https://perfumate.app/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable perfumate-mcp in your MCP settings.

Cursor configuration

{
  "mcpServers": {
    "perfumate-mcp": {
      "url": "https://perfumate.app/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure). The type must be streamableHttp for a remote HTTP server.

Cline configuration

{
  "mcpServers": {
    "perfumate-mcp": {
      "type": "streamableHttp",
      "url": "https://perfumate.app/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start perfumate-mcp and inspect its tools.

VS Code configuration

{
  "servers": {
    "perfumate-mcp": {
      "type": "http",
      "url": "https://perfumate.app/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.

Gemini CLI configuration

gemini mcp add --transport http perfumate-mcp https://perfumate.app/mcp

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.

Claude Desktop configuration

{
  "mcpServers": {
    "perfumate-mcp": {
      "url": "https://perfumate.app/mcp"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.

Windsurf configuration

{
  "mcpServers": {
    "perfumate-mcp": {
      "serverUrl": "https://perfumate.app/mcp"
    }
  }
}

Ground your agent in cited data

PerfuMate MCP gives your agent tools. Koskamo gives it reviewed, cited facts to check its answers against. Add it as a second MCP server; public reads need no API key.

Connect Koskamo Browse datasets

See all 1,050

Do you run PerfuMate MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing