---
title: MCP server
description: Connect Claude, ChatGPT, or other LLMs to your Centiment account to browse organizations, workspaces, surveys, and survey responses through the Model Context Protocol (MCP).
---

[Skip to content](https://help.centiment.co/mcp-server#main-content)

[![centiment](https://help.centiment.co/hubfs/centiment-logo-white-1.svg)](https://www.centiment.co/)

Open main navigation

Close main navigation

- [Contact us](https://www.centiment.co/forms/contact-us)

[Contact us](https://www.centiment.co/forms/contact-us)

 Hello. How can we help you?

- There are no suggestions because the search field is empty.

1. [Help Center](https://help.centiment.co/?hsLang=en)
2. [Survey Platform](https://help.centiment.co/survey-platform?hsLang=en)

# MCP server

## Connect Claude, ChatGPT, or other AI assistants to your Centiment account and query your survey data directly through the Model Context Protocol (MCP).

### Overview

The Centiment MCP server provides secure, read-only access to survey data in Centiment. It supports analysis workflows inside Claude, ChatGPT, and other assistants, including:

- Listing organizations you belong to
- Listing workspaces in an organization
- Listing surveys in a workspace
- Retrieving survey responses for analysis

All available tools are read-only. Each query retrieves your current survey responses at the time you ask. Nothing syncs continuously, and earlier analysis does not update on its own.

### Features

- OAuth 2.0 authentication
- Read-only survey data access
- Organization, workspace, and survey discovery
- Paginated response retrieval
- Compatible with remote MCP clients such as Claude and ChatGPT

### Authentication

Centiment MCP uses OAuth 2.0 Authorization Code flow.

To connect:

1. In Centiment, open Account settings and choose MCPs.
2. Copy your MCP URL: https://core.centiment.co/mcp
3. In Claude or ChatGPT, add Centiment as a custom connector using that URL.
4. Approve access when prompted. Centiment uses OAuth 2.0, so no API key is needed.
5. Ask your assistant to list your Centiment organizations to confirm the connection works.

### Available tools

#### `ListOrganizations`

Returns a paginated list of organizations for the authenticated user.

**Inputs**

- `page` (optional)
- `perPage` (optional, min 5, max 50)

**Returns** an organization list with each organization having:

- organization UUID
- organization name

---

#### `ListWorkspaces`

Returns a paginated list of workspaces for a given organization. Can optionally include external workspaces.

**Inputs**

- `organization` (required, UUID)
- `external` (optional, boolean)
- `page` (optional)
- `perPage` (optional, min 5, max 50)

**Returns** Workspace list with each workspace having:

- workspace UUID
- workspace name

---

#### `ListSurveys`

Returns a paginated list of surveys in a workspace the user can access.

**Inputs**

- `workspace` (required, UUID)
- `page` (optional)
- `perPage` (optional, min 5, max 50)

**Returns** Survey list with each survey having:

- survey UUID
- survey name

---

#### `ListResponses`

Returns a paginated list of responses for a published survey the user can access.

**Inputs**

- `uuid` (required, survey UUID)
- `page` (optional)
- `perPage` (optional, min 5, max 100)

**Returns**

- paginated survey responses

### Recommended usage flow

For best results, query data in this order:

1. List organizations
2. List workspaces for the relevant organization
3. List surveys for the relevant workspace
4. List responses for the relevant survey

This helps avoid unnecessary data requests and keeps analysis focused.

### Usage examples

#### Example 1: Find my organizations

**Prompt**

> Show me the organizations available in my Centiment account.

**What Claude will do**

- Call `ListOrganizations`
- Return the organizations you can access

---

#### Example 2: Find surveys in a workspace

**Prompt**

> Show me surveys in workspace `WORKSPACE_UUID`.

**What Claude will do**

- Call `ListSurveys` with the workspace UUID
- Return the surveys in that workspace

---

#### Example 3: Review responses for a survey

**Prompt**

> Get the latest responses for survey `SURVEY_UUID`.

**What Claude will do**

- Call `ListResponses` with the survey UUID
- Return paginated response data for that survey

---

#### Example 4: Analyze customer feedback

**Prompt**

> Pull responses for survey `SURVEY_UUID` and summarize the top themes.

**What Claude will do**

- Call `ListResponses`
- Analyze the returned survey responses
- Summarize common themes, trends, or issues

### Permissions and data access

The Centiment MCP server only returns data that the authenticated user is allowed to view.

Access is limited by Centiment permissions, including:

- organization membership
- workspace access
- survey visibility

If a user does not have access to a workspace or survey, the tool will return an error.

### Limitations

- The server is read-only
- Responses are paginated
- Survey responses are only available for published surveys
- Users can only access data they already have permission to view in Centiment

### Error handling

Common error cases include:

- invalid organization UUID
- invalid workspace UUID
- invalid survey UUID
- insufficient access to a workspace or survey
- requesting responses for an unpublished survey

### Legal

- Privacy policy: [https://www.centiment.co/legal/privacy-policy](https://www.centiment.co/legal/privacy-policy)
- Terms of Use: [https://www.centiment.co/legal/terms-of-use](https://www.centiment.co/legal/terms-of-use)

### Support

For support, contact: [support@centiment.co](mailto:support@centiment.co)

### Server information

- Server name: `Centiment Server`
- Transport: Streamable HTTP
- Authentication: OAuth 2.0
- Scope: `mcp:use`

- [Survey Platform](https://help.centiment.co/survey-platform?hsLang=en#main-content)

    - [Getting started](https://help.centiment.co/survey-platform?hsLang=en#getting-started)
    - [Build your survey](https://help.centiment.co/survey-platform?hsLang=en#build-your-survey)
    - [Integrations and updates](https://help.centiment.co/survey-platform?hsLang=en#integrations-and-updates)
    - [Logic and data quality](https://help.centiment.co/survey-platform?hsLang=en#logic-and-data-quality)
    - [Share and collect responses](https://help.centiment.co/survey-platform?hsLang=en#share-and-collect-responses)
    - [Support](https://help.centiment.co/survey-platform?hsLang=en#support)
    - [Results and reporting](https://help.centiment.co/survey-platform?hsLang=en#results-and-reporting)
    - [Test and launch](https://help.centiment.co/survey-platform?hsLang=en#test-and-launch)
    - [Workspace and account](https://help.centiment.co/survey-platform?hsLang=en#workspace-and-account)
    - [Connections](https://help.centiment.co/survey-platform?hsLang=en#connections)
- [Panel Collection](https://help.centiment.co/panel-collection?hsLang=en#main-content)

    - [Link a SurveyMonkey Survey](https://help.centiment.co/panel-collection?hsLang=en#link-a-surveymonkey-survey)
    - [Link an Alchemer Survey](https://help.centiment.co/panel-collection?hsLang=en#link-an-alchemer-survey)
    - [Link a Qualtrics Survey](https://help.centiment.co/panel-collection?hsLang=en#link-a-qualtrics-survey)
    - [Link a Typeform Survey](https://help.centiment.co/panel-collection?hsLang=en#link-a-typeform-survey)
- [Analysis](https://help.centiment.co/analysis?hsLang=en)
- [Accounting & Billing](https://help.centiment.co/accounting-billing?hsLang=en)
- [Legal & Security](https://help.centiment.co/legal-security?hsLang=en)
- [Glossary](https://help.centiment.co/glossary?hsLang=en)

[![Chill listening crop-3](https://help.centiment.co/hubfs/centiment-logo-color-1.svg "Chill listening crop-3")](http://www.centiment.co)

 

[Help center](https://help.centiment.co/?hsLang=en)

[Audience Panel](https://centiment.co/audience-panel)

[Survey Platform](https://app.centiment.co/)

[Research Services](https://centiment.co/research-services)

Copyright © 2026, Centiment