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.

Connecting your Agents to Thematic

Different tools require different methods of connection.

OAuth using dynamic client registration. This is the simplest and most modern. Claude, Copilot, ChatGPT and Cursor all use this
OAuth using explicit client registation. Gemini Enterprise requires this
Bearer tokens. Needed for when you can't auth in a browser and only have terminal access. Gemini CLI and Antigravity CLI require this if you only have a terminal.

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.

You shouldn't need to know the list below, the AI assistant has all this information and will make the choices on your behalf. It has a full description of all of the parameters

Management/Discovery Tools

Tool	What it does	Input
List Organizations	List all organizations you have access to
Switch Organization	Changes the active organization (if you belong to multiple). Will be saved and used as context for all future calls	organization_id
List Sources	Shows available surveys and lenses in your organization
Get Source Info	Gets metadata about a source: scores, filters, date range	source_id OR source_name
Get Available Filters	Lists all filter values for a source	source_id OR source_name filter_name

Analysis/Reporting Tools

The below tools are for creating reports and extracting data from Thematic

Common Filter Parameters

The tools below accept any of these optional filter parameters in addition to a source identifier:

text_search (string) — Free-text search term.
date_from (string) — Start date YYYY-MM-DD .
date_to (string) — End date YYYY-MM-DD .
segment_filters (object) — Map of filter name to value(s), e.g. {"Region": "US"} or {"Region": ["US", "EU"]} .
category (array of issue | request | question ) — Universally available feedback classification. Use for "how many issues / requests / questions" questions.
sentiment (array of positive | neutral | negative ) — Universally available sentiment bucket.
themes (array of strings) — Filter to comments tagged with specific themes (titles like price or codes like premium!price ). Call get_themes first to discover what's available.
score_id (string, where applicable) — Score to use (e.g. nps , average , sentiment ). See get_source_info . Defaults to the first available score.

Tool	What it does	Input
Get Themes	Analyzes themes in your feedback (the primary analysis tool)	source_id OR source_name filter score_id
Get Themes by Date	Shows how themes trend over time	source_id OR source_name filter score_id
Compare Periods	Compares themes between two time periods	source_id OR source_name filter period previous_period
Get Comments	Retrieves individual feedback comments	source_id OR source_name filter page_size
Deep Dive	Generates an AI-powered deep dive on a specific theme	source_id OR source_name filter focus_theme focus_query
Count Rows	Returns the number of responses matching a set of filters	source_id OR source_name filter
Get Scores by Dimension	Breaks down score metrics across a chosen filter dimension	source_id OR source_name filter dimension_name

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.

Was this article helpful?

Your feedback helps us improve our documentation.