Skip to main content

Troubleshooting MCP

Having trouble connecting or using ScentSell's MCP tools? Here are solutions to common issues.

"Premium required" error​

Problem: Your AI client returns an error saying Premium is required.

Solution: MCP access requires an active ScentSell Premium subscription. Go to scentsell.com.au/subscribe to upgrade or start a free trial.

"Invalid token" or "Unauthorised" error​

Problem: The tool call fails with an authentication error.

Solution:

  1. In your AI client, go to MCP settings and remove the ScentSell server.
  2. Re-add it with the same server URL.
  3. Go through the OAuth flow again to get a fresh token.

"No matching fragrance" error​

Problem: You ask the AI to log a wear but it says it can't find the fragrance.

Solution:

  1. Check the fragrance is in your collection. Use get_my_collection or open the ScentSell app.
  2. If it's not there, add it first: "Add [fragrance name] to my collection".
  3. Try the log wear command again.

The AI doesn't seem to have my ScentSell tools​

Problem: You've added the MCP server but the AI isn't using ScentSell tools.

Solutions:

  • Restart your AI client after adding the server. Claude Desktop requires a restart.
  • Ensure the server URL is entered exactly: https://mcp.scentsell.com.au/api/mcp
  • Try explicitly asking: "Use your ScentSell tools to list my collection"

A tool still shows an old schema​

Problem: Your AI client says a tool is missing a field that ScentSell has already shipped, for example update_wear_log.rating.

Why it happens: Some AI clients cache MCP tool schemas for a chat session, or until the connector is refreshed.

Solutions:

  • Start a fresh chat.
  • Disconnect and reconnect the ScentSell MCP connector.
  • Restart the AI client if it is a desktop app.
  • Ask the client to inspect the live tool schema again before calling the tool.

Can MCP save share cards into my Photos app?​

Problem: You want an AI client to save a ScentSell share-card PNG directly into iPhone Photos or Android Photos.

Answer: MCP cannot silently write files into your device photo library. Phones require you to approve this through the native share sheet or browser save flow.

Best flow:

  1. Ask the AI client to log the wear or compliment.
  2. Open the returned ScentSell share-card link, or open the item in ScentSell.
  3. Tap Share card.
  4. Choose Save Image, Messages, Instagram, or another app from the phone's share sheet.

OAuth flow fails or browser doesn't open​

Problem: The authorisation browser window doesn't open or errors out.

Solutions:

  • Ensure your browser is set as the default browser on your system.
  • Try opening the authorisation URL manually in a browser.
  • Check you're signed in to ScentSell at scentsell.com.au.

Rate limit error (HTTP 429)​

Problem: Tool calls return a 429 error.

Solution: ScentSell MCP is rate-limited to 100 calls per minute per user. If you're hitting this limit, slow down. The response includes a retry_after_ms field — wait that long before retrying.

This limit is rarely hit with normal usage. It's designed to prevent runaway automated scripts.

Still stuck?​

Contact support@scentsell.com.au with:

  • Your AI client name and version
  • The exact error message
  • What you were trying to do

Next steps: