Skip to content
Contact us
  • There are no suggestions because the search field is empty.

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

Support

For support, contact: support@centiment.co

Server information

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