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

# Studies

> 14 MCP tools to create, update, list, and manage studies — the central object driving recruit-and-interview and the AI interviewer's prompt.

Studies are the central object in User Intuition's research platform. Every interview, screener, and panel order flows through a study. 14 tools.

| Tool                             | Description                                                                                                             |
| -------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `list_studies`                   | List your studies                                                                                                       |
| `get_study`                      | Fetch a single study (always call BEFORE `update_study`)                                                                |
| `create_study`                   | Create a new study (requires `is_panel` — Panel vs BYOP, see below)                                                     |
| `update_study`                   | PATCH a study (screener\_questions REPLACES the full list)                                                              |
| `delete_study`                   | Soft-delete a study                                                                                                     |
| `stop_panels`                    | Cancel all active panel surveys for a study                                                                             |
| `upload_concept_link`            | Add a concept-test external link (dedups by label)                                                                      |
| `delete_concept_link`            | Remove a concept-test link by id                                                                                        |
| `list_available_panel_questions` | Catalog of standard panel screener questions (`{id, name}`; call BEFORE adding panel screeners)                         |
| `get_panel_question`             | Fetch one panel question **with its answer options** — needed to disqualify on a specific answer (e.g. Job Title = CEO) |
| `list_available_languages`       | Supported voice/interview ISO language codes                                                                            |
| `list_available_modes`           | Voice / chat / video mode catalog                                                                                       |
| `list_study_types`               | Catalog of study TYPES (Win/Loss, Churn, NPS+CSAT, Onboarding, Brand Health, etc.) with per-user `recommended_slug`     |
| `get_study_type`                 | Fetch a single study type by slug                                                                                       |

## Response shaping

**Response shaping.** `get_study` returns a lean summary by default:

* `view` — `"summary"` (default) or `"full"` (raw record).
* `include` — array of heavy fields to expand, e.g. `["screener_questions"]`.
* `fields` — exact allowlist of top-level fields (`id` always returned); overrides `view`/`include`.

By default large screener option lists are truncated. Pass `include` or `view: "full"` to fetch the omitted data.

## Panel vs BYOP study type

Every study is one of two types, set by the **required** `is_panel` flag on `create_study`:

* **Panel study** (`is_panel: true`) — respondents are recruited from the paid panel. Only Panel studies can field a panel via [`create_panel`](/mcp-server/tools/integrations-panels). Respondent rewards are handled by the panel — **don't** set `incentive_amount`; the reward cost/hold is previewed by the `create_panel` dry-run.
* **BYOP study** (`is_panel: false`) — "bring your own participant": you invite your own participants via `create_invite`. `create_panel` is **not** available. Incentives are **BYOP-only**: set `incentive_amount` / `is_offering_enabled`, then pay completers via `send_reward`.

Because `is_panel` is required, an agent should ask the user which type they want before calling `create_study`.

## How User Intuition handles this

Studies are the central object in User Intuition's research platform — every interview, screener, and panel order flows through them. Use `list_study_types` and `list_available_modes` to configure the right study shape before calling `create_study`. See [`/platform/agentic-research/`](https://www.userintuition.ai/platform/agentic-research/) for how agents orchestrate the full study lifecycle end to end.