Skip to main content
The User Intuition CLI is the same binary as the MCP server, invoked as a plain command-line tool. Every tool the MCP server exposes — create_study, list_studies, launch_panel, generate_report, and all 33 entries in list — is reachable as a direct subcommand. No MCP client required.

​
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. The Python build (uvx userintuition-mcp) speaks MCP only — use the REST API for Python-first shell work.

​
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.