Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.userintuition.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Auth errors / 401 responses

If you receive a 401 Unauthorized error, check two things:
  1. The USERINTUITION_API_KEY environment variable is set in your MCP client’s configuration.
  2. The key value begins with ui_sk_. Keys that start with anything else are not valid API keys for this server.
Keys are issued from Settings → API Keys at app.userintuition.ai. If your key is correct but you are still seeing 401s, regenerate the key from that page and update your client config.

​
Stale npx cache

npx caches packages locally. If an older version of userintuition-mcp is cached, you may be running stale code even after a package update. Clear the cache with: 
npx clear-npx-cache
Or force a fresh download on the next run: 
npx -y userintuition-mcp@latest

​
ChatGPT OAuth connector setup

The ChatGPT connector uses the Streamable HTTP transport and requires OAuth. Before you can add the MCP server URL, you must enable developer mode in ChatGPT:
  1. Open Settings → Apps & Connectors → Advanced.
  2. Toggle Enable Developer Mode.
  3. Go to Settings → Connectors → Create and fill in:
    • Name: User Intuition
    • MCP Server URL: https://mcp.userintuition.ai/mcp
    • Authentication: OAuth (auto-discovered)
If Developer Mode is not enabled, the MCP Server URL field will not appear.

​
Tools not visible after editing config

Most MCP clients (Claude Desktop, Cursor, VS Code) load MCP servers only at startup. If you edit your config file to add or update the userintuition server block, the new tools will not appear until you fully restart the client application. Reload or restart the client after any config change.

​
Getting help

  • Use the contact_support MCP tool directly — it sends a support request and CCs you on the confirmation email.
  • Email support@userintuition.ai for account or billing issues.