Thematic MCP Server

The Thematic MCP server lets AI assistants analyze your customer feedback data through natural conversation. Once connected, you can ask questions like "What are the top themes in our NPS survey?" or "Compare this quarter to last quarter" and the assistant will query Thematic on your behalf.

Server URL

This depends on the region your Thematic account is initialized in. This ensures that data remains in that region up till the point it is used by the calling LLM

Region

MCP Server URL
US https://mcp.client.getthematic.com  
ANZ https://mcp.client.anz.getthematic.com  
EU https://mcp.client.eu.getthematic.com  

Prerequisites

  • A Thematic account (password or SSO login)
  • Access to at least one organization with feedback data

Authentication

All clients use OAuth to authenticate. When you first connect, you'll be redirected to a login page where you enter your Thematic email, password (or SSO), and select your organization. After that, your session lasts for up to one year.

Available Tools

Once connected, the following tools are available to the AI assistant. You don't need to call these directly — just ask your questions naturally and the assistant will use the appropriate tools.

Tool

What it does
List Sources Shows available surveys and lenses in your organization
Get Source Info Gets metadata about a source: scores, filters, date range
Get Available Filters Lists all filter values for a source
Get Themes Analyzes themes in your feedback (the primary analysis tool)
Get Themes by Date Shows how themes trend over time
Compare Periods Compares themes between two time periods
Get Comments Retrieves individual feedback comments
Deep Dive Generates an AI-powered deep dive on a specific theme
Count Rows Returns the number of responses matching a set of filters
Get Scores by Dimension Breaks down score metrics across a chosen filter dimension
Switch Organization Changes the active organization (if you belong to multiple)

Troubleshooting

Authentication fails or loops

  • Clear your browser cookies for mcp.client.getthematic.com   and try again
  • If you use SSO, make sure your identity provider session is active

Tools don't appear after connecting

  • Start a new conversation — tools are loaded at conversation start
  • Check that the server shows as "Connected" in your client's MCP settings

"Organization not found" errors

  • Use the Switch Organization tool to verify your available organizations
  • Ask the assistant: "List my available organizations"

Session expired

  • Sessions last up to one year. If yours expires, disconnect and reconnect the server to re-authenticate.

Connecting your tools

This section details instructions on how to connect to the Thematic MCP server from your tool of choice.

Claude.ai

Claude.ai supports remote MCP servers natively through its Integrations settings.

  1. Go to claude.ai and sign in
  2. Click the ‘Customize’ button on the left panel
  3. Click ‘Connectors’
  4. Click the ‘+' button and choose 'Custom connector’
  5. Give it a name and enter the server URL from the table above. For example https://mcp.client.getthematic.com  
  6. Click Connect — you'll be redirected to the Thematic login page
  7. Enter your Thematic email and password (or sign in via SSO)
  8. Select your organization when prompted
  9. You'll be redirected back to Claude.ai with the integration active

Once connected, start a new conversation and Thematic tools will be available automatically. You can ask questions like:

"What are the main themes in our NPS survey?"

Claude Code (CLI)

Claude Code supports remote MCP servers via its settings file.

Option 1: Add via the CLI

Run this command in your terminal:

claude mcp add thematic --transport http https://mcp.client.getthematic.com  

When you next start a Claude Code session that uses Thematic tools, you'll be prompted to authenticate in your browser.

Option 2: Add manually to settings

Add the following to your ~/.claude/settings.json   (or project-level .claude/settings.json  ):

{  "mcpServers": {  "thematic": {  "type": "http",  "url": "https://mcp.client.getthematic.com"  }  } }  

Restart Claude Code after saving. You'll be prompted to authenticate on first use.

Cursor

Cursor supports remote MCP servers through its settings UI or configuration file.

Option 1: Via Settings UI

  1. Open Cursor

  2. Go to Settings > MCP

    Click + Add new MCP server

    Fill in:

    • Name: Thematic  
    • Type: HTTP  
    • URL: https://mcp.client.getthematic.com  
  3. Click Save
  4. You'll be prompted to authenticate in your browser on first use

Option 2: Via configuration file

Add the following to your .cursor/mcp.json   file (create it if it doesn't exist):

{  "mcpServers": {  "thematic": {  "type": "http",  "url": "https://mcp.client.getthematic.com"  }  } }  

Restart Cursor after saving. You'll be prompted to authenticate on first use.

ChatGPT

ChatGPT supports remote MCP servers for Plus, Pro, and Team users.

  1. Open chatgpt.com
  2. Open “Settings” by clicking on the account name in the bottom left
  3. Chose “Apps” and then “Advanced Settings”

  4. Make sure “developer” mode is turned on

    Select Create app

    Enter details:

    1. Name: Thematic MCP (or similar)
    2. URL https://mcp.client.getthematic.com  
    3. Click “I understand and want to continue”
  5. Click Create — you'll be redirected to the Thematic login page
  6. Enter your Thematic credentials and select your organization
  7. Return to ChatGPT and start asking questions

Note: MCP support in ChatGPT is relatively new and may have limitations compared to Claude-based clients. If you encounter issues, try disconnecting and reconnecting the server.