Skip to main content
The User Intuition CLI is the same binary as the MCP server, invoked as a plain command-line tool. Its 49 direct commands include create_study, list_studies, launch_panel, generate_report, search_research, and answer_research. The review_study app is MCP-only. No MCP client is required for direct commands.

​
When to reach for the CLI

  • Shell scripts and CI jobs. Pipe study results into jq, write a cost-gate before launching a Panel study, automate cleanup of test studies.
  • Cron and scheduled work. Run nightly status sweeps, refresh cached reports, alert on long-running studies.
  • Ad-hoc debugging. Pin down whether a problem is the tool, the backend, or your MCP client — by isolating the call from the agent.
  • Onboarding a teammate. A browser login and one userintuition-mcp list_studies command are enough to get started.

​
When to use the MCP server instead

If an AI agent should choose the tool and fill in arguments (Claude, ChatGPT, Cursor), use the MCP server. The CLI assumes you already know which tool and which arguments.

​
What you get

The CLI ships with the Node build of the MCP server (@userintuition-ai/mcp on npm). It uses the same OAuth service, API keys, input validation, public API endpoints, and response shapes — the only thing that changes is the transport.
The CLI is Node-only. For Python integrations, use the REST API.

​
Next steps

Quickstart

Install the binary and make your first call in under two minutes.

Command reference

Every subcommand, every flag, with examples.

Recipes

Practical patterns — CI cost gates, lifecycle scripts, batch operations.

Troubleshooting

Auth errors, missing binaries, common pitfalls.