Connect AI agents to the ListenLabs MCP server

Vendor MCP

The ListenLabs MCP connector routes your AI agent's tool calls to ListenLabs's own MCP server through Scalekit. Each user signs in to ListenLabs once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 13 tools.

Tools: 13
What they doRead · write · destructive: 7 · 4 · 27 read4 write2 destructive
Users sign in with: OAuth
OAuth app: Scalekit's or your own

Setup

Install the SDK
- Node.js
- Python
Terminal window
npm install @scalekit-sdk/node dotenv
Terminal window
pip install scalekit-sdk-python python-dotenv
Set your credentials
Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.
.env
```
SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
SCALEKIT_CLIENT_ID=<your-client-id>
SCALEKIT_CLIENT_SECRET=<your-client-secret>
```
Create the ListenLabs MCP connection
In AgentKit > Connections, create a ListenLabs MCP connection. The name you give it is the connection_name your code passes. See Configure connections.
Scalekit credentials are available for ListenLabs MCP server, so you don't need to register an OAuth app.

Authorize a user and make your first call

Node.js
Python

1
import { ScalekitClient } from '@scalekit-sdk/node'
2
import 'dotenv/config'
3
import { createInterface } from 'node:readline/promises'
4

5
const scalekit = new ScalekitClient(
6
  process.env.SCALEKIT_ENVIRONMENT_URL,
7
  process.env.SCALEKIT_CLIENT_ID,
8
  process.env.SCALEKIT_CLIENT_SECRET,
9
)
10
const actions = scalekit.actions
11

12
const connector = 'listenlabsmcp'
13
const identifier = 'user_123'
14

15
// Generate an authorization link for the user
16
const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
17
console.log('Authorize ListenLabs MCP:', link)
18
const rl = createInterface({ input: process.stdin, output: process.stdout })
19
await rl.question('Press Enter after authorizing...')
20
rl.close()
21

22
// Make your first call
23
const result = await actions.executeTool({
24
  connector,
25
  identifier,
26
  toolName: 'listenlabsmcp_list_creatable_orgs',
27
  toolInput: {},
28
})
29
console.log(result)

npx tsx quickstart.mts

1
import os
2
from scalekit import ScalekitClient
3
from dotenv import load_dotenv
4
load_dotenv()
5

6
scalekit_client = ScalekitClient(
7
    env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
8
    client_id=os.getenv("SCALEKIT_CLIENT_ID"),
9
    client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
10
)
11
actions = scalekit_client.actions
12

13
connection_name = "listenlabsmcp"
14
identifier = "user_123"
15

16
# Generate an authorization link for the user
17
link_response = actions.get_authorization_link(
18
    connection_name=connection_name,
19
    identifier=identifier,
20
)
21
print("Authorize ListenLabs MCP:", link_response.link)
22
input("Press Enter after authorizing...")
23

24
# Make your first call
25
result = actions.execute_tool(
26
    tool_input={},
27
    tool_name="listenlabsmcp_list_creatable_orgs",
28
    connection_name=connection_name,
29
    identifier=identifier,
30
)
31
print(result)

python quickstart.py

Each user signs in once. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool

Try in Playground Request a tool

listenlabsmcp_get_responseDeep-dive into a single respondent's interview.Read-only
Get Response
Deep-dive into a single respondent's interview. Returns a structured transcript with question tracking, input types, multiple choice data, and source URLs for each message. Paginated for large interviews.
Inputs
readable_idnumberrequired
Respondent number from get_study_responses
study_idstringrequired
Study ID (UUID) from list_studies
cursorstring
Pagination cursor for long transcripts
listenlabsmcp_get_study_analysisGet the AI-generated analysis report for a study, rendered as markdown.Read-only
Get Study Analysis
Get the AI-generated analysis report for a study, rendered as markdown. Use list_studies first to find studies where has_analysis is true. The report includes sourced respondent quotes with deep-links to the original transcript messages.
Inputs
study_idstringrequired
Study ID (UUID) from list_studies
listenlabsmcp_get_study_responsesGet response transcripts for a study.Read-only
Get Study Responses
Get response transcripts for a study. Returns formatted interview transcripts with pagination. Each respondent answer includes a source link to that exact message in the transcript.
Inputs
study_idstringrequired
Study ID (UUID) from list_studies
cursorstring
Pagination cursor from previous response
max_responsesnumber
Maximum number of responses to return (default 10, max 50)default 10
question_numbersarray
Only include these question numbers in the transcript (1-indexed)
readable_idsarray
Filter to specific respondents by their readable ID numbers
listenlabsmcp_get_study_stateReturn the current state of a study — title, audience, study guide, questions, screener, and recruitment details.Read-only
Get Study State
Return the current state of a study — title, audience, study guide, questions, screener, and recruitment details. Also includes launch eligibility, credit balance, and per-recruitment cost. Call before edit_study or launch_study to inspect the current study configuration.
Inputs
studyIdstringrequired
UUID of the study to inspect
listenlabsmcp_list_creatable_orgsList organizations the user belongs to where they can create studies.Read-only
List Creatable Orgs
List organizations the user belongs to where they can create studies. Returns org ID, name, and role. Supports pagination and case-insensitive name search. Call before create_study when the user has not specified an organization.
Inputs
cursorstring
Pagination cursor from a previous call's nextCursor
limitinteger
Page size (default 10, max 25)
textHintstring
Case-insensitive substring to filter org names by
listenlabsmcp_list_studiesList studies accessible to the authenticated user.Read-only
List Studies
List studies accessible to the authenticated user. Returns study ID, name, status, creation date, response count, and whether analysis is available. Paginated (50 per page). Use textHint to filter by study title; use cursor for pagination.
Inputs
cursorstring
Pagination cursor from previous response
statusstring
Filter by study statusone of openclosed
textHintstring
Case-insensitive substring to filter study titles by
listenlabsmcp_search_across_studiesSearch across study metadata using a text query.Read-only
Search Across Studies
Search across study metadata using a text query. Returns matching studies with relevant context.
Inputs
querystringrequired
Search term to find across studies
max_resultsnumber
Maximum number of results to return (default 10)default 10
listenlabsmcp_create_studyStart a new guided user-interview study.Write
Create Study
Start a new guided user-interview study. Provide a plain-language description of the study goals and target audience. The platform's creation agent walks through onboarding stages; subsequent turns must use edit_study with the returned studyId and chatId.
Inputs
promptstringrequired
Plain-language description of the study to create (goals, who to interview, what to learn)
orgIdstring
Organization UUID when known (e.g. from list_creatable_orgs)
orgNamestring
Organization name to create the study in. Required when the user belongs to multiple organizations.
listenlabsmcp_edit_studySend a natural-language edit instruction or structured button event to the study creation agent.Write
Edit Study
Send a natural-language edit instruction or structured button event to the study creation agent. Use after create_study (pass the chatId) for guided onboarding, or with a fresh chatId for direct edits to an existing study. Supply either prompt or buttonClick, not both.
Inputs
studyIdstringrequired
UUID of the study to edit
buttonClickobject
Structured button event from the guided onboarding flow
chatIdstring
Chat session ID from create_study or a previous edit_study call. Omit on the first turn.
promptstring
Free-form instruction or user input for the study agent
listenlabsmcp_move_studyMove a study into a folder, or back out to the dashboard root.Write
Move Study
Move a study into a folder, or back out to the dashboard root. Pass folderName to move it into an existing folder; omit both folderName and folderId to move the study out of its folder and back to the dashboard root. The folder must already exist.
- Idempotent
Inputs
studyIdstringrequired
Study identifier: the UUID from list_studies, the short link id from a Listen Labs study URL (e.g. zy4GuhxP), or the full pasted URL (e.g. https://listenlabs.ai/p/zy4GuhxP/).
folderIdstring
Destination folder UUID from a previous move_study error. Use instead of folderName when selecting by ID.
folderNamestring
Existing destination folder name, or a "/"-separated path to pick between folders sharing a name (e.g. "Research / Q3 2026"). Rejected if no such folder exists. Omit to move the study to the dashboard root.
listenlabsmcp_publish_studyPublish the study's current draft revision so respondents see the latest version.Write
Publish Study
Publish the study's current draft revision so respondents see the latest version. No-op when the draft is identical to prod. Does not start recruitments — use launch_study to begin sourcing respondents.
- Idempotent
Inputs
studyIdstringrequired
UUID of the study to publish
listenlabsmcp_launch_studyPublish the study's draft revision (if needed) and start all unlaunched recruitments that fit the organization's credit balance.Destructive
Launch Study
Publish the study's draft revision (if needed) and start all unlaunched recruitments that fit the organization's credit balance. Recruitments are launched greedily in dashboard order. Returns launched and skipped recruitments with balance before/after. Safe to re-call — already-launched recruitments are skipped.
Inputs
studyIdstringrequired
UUID of the study to launch
listenlabsmcp_manage_folderCreate, rename, re-nest, or delete a dashboard folder.Destructive
Manage Folder
Create, rename, re-nest, or delete a dashboard folder. Folders only: it never creates, moves, or deletes a study. Use move_study to file a study in a folder. Delete only removes an EMPTY folder, and only when the user explicitly asked to delete it.
- Idempotent
Inputs
actionstringrequired
create makes a new folder, rename changes a folder's name, move re-nests it under another folder, delete permanently removes an empty one.one of createrenamemovedelete
folderNamestringrequired
The folder to act on, or a "/"-separated path for nested folders (e.g. "Research / Q3 2026"). For create, this is the folder to make.
folderIdstring
Folder UUID from list_studies folders[] or a previous error. Takes precedence over folderName; use it when a name was reported as ambiguous.
newNamestring
New folder name. Required for action="rename", ignored otherwise.
orgIdstring
Organization UUID when known (e.g. from list_creatable_orgs). Prefer orgName when the user gave a name.
orgNamestring
Organization name. Required when the user belongs to multiple organizations and did not specify one.
parentFolderIdstring
Destination folder UUID for action="move". Takes precedence over parentFolderName; use it when the parent name was reported as ambiguous.
parentFolderNamestring
Folder to nest under, matched like folderName. Used by action="move"; omit it to move the folder to the dashboard root.

Setup

Install the SDK

Set your credentials

Create the ListenLabs MCP connection

Authorize a user and make your first call

Tools

Call it

Returns

Get Response

Inputs

Get Study Analysis

Inputs

Get Study Responses

Inputs

Get Study State

Inputs

List Creatable Orgs

Inputs

List Studies

Inputs

Search Across Studies

Inputs

Create Study

Inputs

Edit Study

Inputs

Move Study

Inputs

Publish Study

Inputs

Launch Study

Inputs

Manage Folder

Inputs

Related: other Analytics connectors