# ThoughtSpot Spotter MCP Server changelog

> For the complete documentation index, see [llms.txt](https://developers.thoughtspot.com/docs/llms.txt)

Source: https://developers.thoughtspot.com/docs/mcp-server-changelog

# ThoughtSpot Spotter MCP Server changelog

This changelog lists the new features, enhancements, and other changes introduced in the released versions of the ThoughtSpot Spotter MCP Server. For information about Spotter MCP Server integration, see the [MCP Server integration guide]({{navprefix}}/{{mcp-integration}}).

## August 2026

**API version string:** `?api-version=2026-05-01`  
**Upgrade notes**: Existing integrations using `?api-version=2026-05-01` or `?api-version=latest` will be automatically upgraded.

<table class="tableblock frame-none grid-none stretch cl-table"><colgroup><col style="width: 20%;"> <col style="width: 80%;"></colgroup><tbody><tr><td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph cl-label"><p><strong>2026-05-01</strong></p></div></div></td><td class="tableblock halign-left valign-top"><div class="content"><h4 id="_search_objects_mcp_tool" class="discrete"><code>search_objects</code> MCP tool</h4><div class="paragraph"><p>The new <code>search_objects</code> MCP tool lets agents search for existing ThoughtSpot content by name or description and return matching objects with their metadata and deep links. For more information, see <a href="{{navprefix}}/{{mcp-tool-reference-spotter3}}#search_objects">search_objects</a>.</p></div><hr><h4 id="_step_headings_in_get_session_updates_responses" class="discrete">Step headings in <code>get_session_updates</code> responses</h4><div class="paragraph"><p>Spotter now reports each step it works through while processing a question. <code>get_session_updates</code> returns these as <code>session_update</code> objects with <code>type: "step_notification"</code> and a short heading in the <code>text</code> field, such as <code>Searching data models</code> or <code>Running query</code>. For more information, see <a href="{{navprefix}}/{{mcp-tool-reference-spotter3}}#get_session_updates">get_session_updates response</a>.</p></div><hr><h4 id="_full_tool_response_via_url_flag" class="discrete">Full tool response via URL flag</h4><div class="paragraph"><p>You can now receive the raw Spotter event stream from <code>get_session_updates</code> by appending <code>enable-raw-session-updates=true</code> to your MCP endpoint URL. The full response includes granular metadata about Spotter’s internal tool calls, such as the columns in the data model used to answer the question, formulas, parameters, and subqueries. For guidance on when to use the full response and how to enable it, see <a href="{{navprefix}}/{{mcp-connect-custom-chatbot}}#accessing-full-tool-responses">Accessing full tool responses</a>. For the response format reference, see <a href="{{navprefix}}/{{mcp-tool-reference-spotter3}}#full-response">Full response (raw event stream)</a>.</p></div><hr><h4 id="_thoughtspot_skill_for_skill_aware_llm_clients" class="discrete">ThoughtSpot skill for skill-aware LLM clients</h4><div class="paragraph"><p>A companion skill, <code>analyzing-data-with-thoughtspot</code> is now available for LLM clients that support skills, such as Claude. Install the skill alongside the ThoughtSpot Spotter MCP Server to improve how the client orchestrates ThoughtSpot MCP tools, including smarter routing of data questions, real-time progress narration during polling, and surfacing ThoughtSpot-generated visualization links instead of regenerating charts.</p></div><div class="paragraph"><p>For more information, see <a href="{{navprefix}}/{{mcp-server-client-connection}}#_using_the_thoughtspot_skill_with_skill_aware_clients">Using the ThoughtSpot skill with skill-aware clients</a>.</p></div></div></td></tr></tbody></table>

## July 2026

**API version string:** `?api-version=2026-05-01`  
**Upgrade notes**: Existing integrations using `?api-version=2026-05-01` or `?api-version=latest` will be automatically upgraded.

<table class="tableblock frame-none grid-none stretch cl-table"><colgroup><col style="width: 20%;"> <col style="width: 80%;"></colgroup><tbody><tr><td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph cl-label"><p><strong>2026-05-01</strong></p></div></div></td><td class="tableblock halign-left valign-top"><div class="content"><h4 id="_org_switching_tools" class="discrete">Org switching tools</h4><div class="paragraph"><p>The OAuth MCP Server endpoints support the following MCP tools to discover the user’s current Org and allow multi-Org users to switch to another Org mid-session without logging out or re-authenticating.</p></div><div class="ulist"><ul><li><p><code>list_orgs</code>: Returns a list of the Orgs that the ThoughtSpot account is currently an active member of, along with the Org used for the user session.</p></li><li><p><code>switch_org</code>: Switches the active Org for the current session.</p></li></ul></div><div class="paragraph"><p>For more information, see <a href="{{navprefix}}/{{mcp-tool-reference-spotter3}}#org-switching-tools">Org switching tools</a>.</p></div><blockquote><p><strong>IMPORTANT:</strong> The Org switching MCP tools are not available on Bearer-token connections.</p></blockquote></div></td></tr></tbody></table>

## May 2026

**API version string:** `?api-version=2026-05-01`.  
**Upgrade notes**: Recommended for new integrations. Introduces breaking changes to existing MCP Server integrations. See the [migration guidelines]({{navprefix}}/{{mcp-server-changelog}}#_migration_guidelines).

<table class="tableblock frame-none grid-none stretch cl-table"><colgroup><col style="width: 20%;"> <col style="width: 80%;"></colgroup><tbody><tr><td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph cl-label"><p><strong>2026-05-01</strong></p></div></div></td><td class="tableblock halign-left valign-top"><div class="content"><h4 id="_support_for_spotter_3" class="discrete">Support for Spotter 3</h4><div class="paragraph"><p>ThoughtSpot Spotter MCP Server now supports Spotter 3, enabling advanced analytics, forecasting, multi-step reasoning, and deep research. The new MCP tools support real-time streaming, session-based conversations, richer interactions, and direct embedding of visualizations in MCP-aware apps.<br>For more information, see <a href="{{navprefix}}/{{mcp-server-spotter3}}">MCP Server with Spotter 3</a>.</p></div><hr><h4 id="_mcp_server_url_changes_and_api_versioning_breaking" class="discrete">MCP Server URL changes and API versioning <span class="version-badge breaking">Breaking</span></h4><div class="paragraph"><p>Spotter MCP Server URLs now support date-based versioning, defined using the <code>?api-version=YYYY-MM-DD</code> parameter. Ensure that you update the <a href="{{navprefix}}/{{mcp-integration}}#_mcp_server_url">MCP Server URL</a> in your integrations as needed.</p></div><blockquote><p><strong>NOTE:</strong> The MCP Server URLs without the API version always point to the latest version and may introduce new tools. Pin your integration to a tested version using the ?api-version={YYYY-MM-DD} parameter. For example, ?api-version=2026-05-01. If the API version is set to a future date, the server returns the latest API version released before the date specified in the URL.</p></blockquote><hr><h4 id="_mcp_tools_and_processing_model_breaking" class="discrete">MCP tools and processing model <span class="version-badge breaking">Breaking</span></h4><div class="paragraph"><p>The MCP Server URL now points to the Spotter 3-powered MCP tools. With this enhancement, the legacy tools in your existing integrations will be replaced with new tools. If your app uses custom workflows, you must update your integrations to use the new MCP tools or pin a previous version using the <code>?api-version={YYYY-MM-DD}</code> parameter in the URL to preserve your existing changes.</p></div><h5 id="_migration_guidelines" class="discrete">Migration guidelines</h5><div class="paragraph"><p>Migrating from your existing setup to the new version requires updating the MCP client configuration to point to the new URL and rewriting tool-calling logic to use the new asynchronous, polling model.</p></div><div class="paragraph"><p>To update your integration to use Spotter 3 features and the new MCP tools:</p></div><div class="olist arabic"><ol class="arabic"><li><p>Rewrite your integration to use the new tools. Replace the old synchronous tool-calling pattern with the new asynchronous polling pattern. For code samples and tool reference, see the <a href="{{navprefix}}/{{mcp-tool-reference-guide}}">MCP tool reference guide</a>.</p></li><li><p>Configure the URL that points to the new MCP tools.</p></li><li><p>Test your integration end-to-end.</p></li><li><p>Roll out to production environments after validation.</p></li></ol></div></div></td></tr></tbody></table>

## April 2026

**API version string:** `?api-version=2026-04-30` or an earlier date string  
**Upgrade recommendation**: Supports the legacy MCP tools and URLs only. Upgrade your integrations to version 2026-04-30 or later.

<table class="tableblock frame-none grid-none stretch cl-table"><colgroup><col style="width: 20%;"> <col style="width: 80%;"></colgroup><tbody><tr><td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph cl-label"><p><strong>2026-04-30</strong></p></div></div></td><td class="tableblock halign-left valign-top"><div class="content"><h4 id="_mcp_tools_processing_model_and_answer_retrieval" class="discrete">MCP tools, processing model, and answer retrieval</h4><div class="paragraph"><p>Supports the following MCP tools released in the initial version of ThoughtSpot Spotter MCP Server.</p></div><div class="ulist"><ul><li><p><code>ping</code>: Tests connectivity and authentication.</p></li><li><p><code>getDataSourceSuggestions</code>: Returns available data source suggestions for a given query.</p></li><li><p><code>getRelevantQuestions</code>: Breaks a query into sub-questions. Returns answers synchronously.</p></li><li><p><code>getAnswer</code>: Returns the answer to a specific sub-question.</p></li><li><p><code>createLiveboard</code>: Creates a ThoughtSpot Liveboard from a list of answers.</p></li></ul></div><hr><h4 id="_mcp_server_urls" class="discrete">MCP Server URLs</h4><div class="paragraph"><p>Supports the following URLs:</p></div><div class="ulist"><ul><li><p><code>https://agent.thoughtspot.app/mcp</code> (OAuth Apps)</p></li><li><p><code>https://agent.thoughtspot.app/bearer/mcp</code> (Bearer Token Apps)</p></li><li><p><code>https://agent.thoughtspot.app/openai/mcp</code> (OpenAI-compatible clients)</p></li></ul></div><div class="paragraph"><p>These URLs are deprecated as of the MCP Server 2026-05-01 release. See the <a href="{{navprefix}}/{{mcp-server-changelog}}#_mcp_server_url_changes_and_api_versioning_breaking">changelog</a> for more information.</p></div></div></td></tr></tbody></table>