401 Unauthorized
For hosted Streamable HTTP, confirm the client is connected tohttps://mcp.userintuition.ai/mcp, then reconnect OAuth from the client.
For stdio, confirm USERINTUITION_API_KEY is visible to the process that launches the MCP server and starts with ui_sk_. Create or rotate keys under Settings → API Keys at app.userintuition.ai. A valid credential can still receive 403 or 404 for a resource the account does not own.
A tool is unavailable
Confirm that the client connects to the intended MCP profile. The full endpoint exposes every tool; core, read-only, compact, and directory profiles offer different subsets. Check the tool reference for the tool name and inputs. Hosted clients discover tools through the MCP endpoint. Local stdio clients launch the server with:A tool returns a domain error
Not every non-success response is an authentication problem. Examples include:- report generation on a study with no usable interviews
- reward delivery for an ineligible or unknown participant
- direct Panel launch below 10% incidence
- editing a fielding Panel study before pausing or stopping it
400, 403, 404, or 409 domain response.
Invalid tool inputs return validation_error with a correct_input hint. If a report has not been generated, no_report_yet points to generate_report; if the study has no completed interviews, no_completed_interviews points to finishing interviews first. A 404 for an interview or study means that resource could not be found or accessed. Check its public ID and account access before retrying.
A study plan change does not appear
Usecustomize_study for the plan, expected duration, audience, screeners, and concept material. Continue the conversation whenever it returns response_type: "question", then call get_study to verify the persisted result. update_study is only for ordinary metadata. If a Panel study is actively fielding, call pause_study or stop_study before editing.

