> ## Documentation Index
> Fetch the complete documentation index at: https://docs.listenlabs.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Listen Labs MCP

> Connect AI assistants (Claude, ChatGPT, Codex, and other MCP clients) to your Listen Labs account.

Connect AI assistants — Claude, ChatGPT, Codex, and other MCP clients — to your Listen Labs account. Create, edit, and launch studies, ask questions about study results, browse respondent transcripts, and search across studies straight from your AI client.

## What you can do

| Capability       | Description                                                                                                                     |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| Create studies   | Describe a research goal and walk through a guided setup (goals, audience, interview mode, study guide)                         |
| Edit studies     | Change titles, questions, screeners, recruitment, interview mode, concepts, incentives, languages, and more in natural language |
| Launch studies   | Publish your latest edits and start recruitment when you're ready to go live                                                    |
| Browse studies   | List studies you can access, filter by title or status, see response counts and whether analysis is ready                       |
| Search research  | Find studies and themes by keyword across titles, goals, classifications, and analysis themes                                   |
| Read transcripts | Pull paginated respondent interview transcripts with deep links back to Listen Labs                                             |
| Read analysis    | Fetch AI-generated analysis reports (markdown) with sourced quotes                                                              |

## Requirements

* A Listen Labs account with access to at least one organization
* An MCP client that supports remote MCP servers with OAuth

## Quick Start

<CardGroup cols={1}>
  <Card icon="plug" href="/mcp-docs/connect" title="Connect your client">
    Add the Listen Labs MCP server to Claude, ChatGPT, or Codex and authenticate with OAuth.
  </Card>
</CardGroup>

## Permissions

When you approve access, the MCP integration can:

* View studies and their details in organizations you belong to
* Read completed respondent transcripts and analysis from those studies
* Create and edit studies where you have edit access
* Launch studies and start recruitment where you have permission to do so

The integration acts **as you** and respects the same permissions as the web app. It only sees and changes studies your Listen Labs user already has access to. Creating and editing require edit access on the study or organization, launching requires permission to start recruitment, and read-only tools require at least view access.

## Server URL

```
https://listenlabs.ai/mcp
```

You can also use `https://mcp.listenlabs.ai/mcp` (equivalent endpoint).

The server uses **stateless Streamable HTTP**: each request is independent. There are no long-lived MCP sessions to manage.