Thoughtspot
MCP Server for ThoughtSpot - provides OAuth authentication and tools for querying data
Connector by thoughtspot.appOfficial · Domain verified by the MCP Registry
Install
Works with Claude Code, VS Code, Cursor, Windsurf. Read the repository before you give any tool access to your data.
npx agentmarket install connector/thoughtspot-app-mcp-server
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Remote endpoints
https://agent.thoughtspot.app/mcpRemote (HTTP)https://agent.thoughtspot.app/sseRemote (SSE)https://agent.thoughtspot.app/bearer/mcpRemote (HTTP)https://agent.thoughtspot.app/bearer/sseRemote (SSE)
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Use cases: data-analysis, data-visualization
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.
- Tools
- 14 read · 6 write · 0 delete
- Secrets
- 1 (API keys, tokens or passwords)
- Install scripts
- Nothing to install (hosted)
- Runs as
- Hosted (remote endpoint)
Tools by what they do 20
Read from the source code; the running server may list different tools.
Read 14 · Look things up without changing anything.
check_connectivitycreate_analysis_sessionget_dashboard_statusget_dataget_model_updatesget_session_updatesgetAnswergetDataSourceSuggestionsgetRelevantQuestionslist_orgspingsearch_objects
Show 2 more tools
send_session_messageswitch_org
Write 6 · Create, change, send or run things.
create_dashboardcreate_model_sessioncreateLiveboardfinalize_modelmodify_dashboardsend_model_message
Secrets and settings it asks for
Secrets: values you paste in that let it act as you.
Authorization
Other settings (environment variables or headers).
X-TS-Host
Network hosts it talks to 1
agent.thoughtspot.app· found in remote endpoint, install command
Tools (20)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
check_connectivityCheck Connectivityread-onlyPing tool to test connectivity and authentication. You can use this if other tool calls are failing to verify if the connection is working.
create_analysis_sessionCreate Analysis Sessionread-onlyStart an analytical session with the Analytics Agent. This is the first step in a three-step workflow: create a session, send a message, then poll for updates. Once created, you can use the returned `analytical_session_id` to send analytical questions via `send_session_message` and retrieve answers via `get_session_updates`. Sessions are conversational, so you can ask follow-up questions in the same session without creating a new one. Using a single analytical session is preferable, because it reuses the same data source selection. When the user's intent is to create a dashboard, use the first…
create_dashboardCreate DashboardCreate a dashboard from a list of answers, allowing the user to revisit the results later. You can use this if the user asks for a dashboard or liveboard, or asks to save the results from the analysis. This can be a useful way to save the results to revisit later, or present them to other users.
create_model_sessionStart Model SessionStart a session with the ThoughtSpot model builder, to build a NEW data model or to EDIT an existing one. Returns a model_session_id used by send_model_message, get_model_updates and finalize_model. - NEW model: pass `connection_identifier`, the warehouse connection to build on. Ask the user which connection to use and confirm the exact GUID with them before calling this; it should not be guessed, reused from a previous model, or assumed from a default. - EDIT an existing model: pass `model_identifier` instead (confirm which model with the user first). Creating a session does not build anythin…
createLiveboardCreate Liveboard from AnswersCreate a liveboard from a list of answers
finalize_modelSave ModelSave the model. Call first WITHOUT confirm to get a summary for review, then let the user decide: to make more changes, go back to send_model_message; to save, call again with confirm=true to persist and get the URL. confirm=true is the only step that saves. Don't finalize until the model is actually built — if the builder has only returned a plan (an mrd update) and nothing has been built, there is nothing to save.
get_dashboard_statusGet Dashboard Statusread-onlyContinue waiting for a dashboard that is still being built or changed. Call this when `create_dashboard` or `modify_dashboard` returned `status: "in_progress"`, passing the `task_id` they gave you. Each call waits a short while before returning, so calling it repeatedly is the correct way to wait. Keep calling until `status` is `completed`, `needs_input` or `failed`. Do not start a new `create_dashboard` or `modify_dashboard` call for the same work, or you will create duplicate dashboards. Check `status`: `completed` (give the user `dashboard_url`), `in_progress` (call `get_dashboard_status`…
get_dataGet Dataread-onlyFetch the full data (columns and rows) of a saved Answer or Liveboard, identified by its GUID — typically an object found via `search_objects`. Use this to explain, describe, summarize, analyze, or interpret what a ThoughtSpot object, Liveboard, Answer, or visualization actually shows. When the user wants to explain, describe, summarize, analyze, or interpret what a specific object contains or shows, an accurate answer comes from this tool's data, so you should fetch it first with the object's `id` and answer from the returned rows. Runs the object's saved question (its existing filters and co…
get_model_updatesBuilding Model…read-onlyGet the model builder's new updates for the instruction in progress. Call it repeatedly until is_done is true. A full build takes 1–2 minutes, so an empty batch with is_done=false means it is still working, not stalled. React to the update types: - `mrd` — a proposed plan (Model Requirements Document). This is a HARD STOP: show the plan to the user and WAIT for their explicit approval (or edits). NEVER auto-approve it or send a 'build it'/'yes' message yourself. (If a build starts without any `mrd` — a backend config that skips the plan step — tell the user the plan step was skipped rather tha…
get_session_updatesGet Analysis Session Updatesread-onlyGet the latest updates from the Analytics Agent. You can call this after `send_session_message` to retrieve the Agent's response. If `is_done` is false, you can call this tool again to continue polling, as the Agent is still generating a response. Even if `is_done` is false, you can use the updates to show status updates or progress to the user, so that they are informed about the ongoing process. An empty `session_updates` list while `is_done` is false is normal; it means the Agent is still thinking. When `is_done` is true, the Agent has finished and the results in `session_updates` are compl…
getAnswerGet Answer for a Questionread-onlyGet the answer to a question from ThoughtSpot database
getDataSourceSuggestionsGet Data Source Suggestions for a Queryread-onlyGet data source suggestions for a query. Use this tool only if there is not datasource id provided in the context or the users query. If mulitple data sources are returned, and the confidence difference between the top two data sources is less than 0.3, ask the user to select the most relevant data source. Otherwise use the data source with the highest confidence to get the relevant questions and answers for the query.
getRelevantQuestionsGet Relevant Questions for a Queryread-onlyGet relevant data questions from ThoughtSpot database
list_orgsList Orgsread-onlyList the Orgs the authenticated user can access on the ThoughtSpot instance, including the ID, name, and description of each Org. The Org marked `is_active: true` is the one currently active for your account, which all tool calls operate against. Use this to tell the user which Org they are in. Only available when authenticated via OAuth. If the list is large , summarize or show only the most relevant orgs (e.g. the active one and a few others) rather than listing all of them, unless the user explicitly asks to see all orgs.
modify_dashboardModify DashboardChange an existing dashboard. It can rearrange and restyle what is already there, add new charts, add short explanatory text, and organise charts into groups or tabs. `dashboard_id` is always required. Add `task_id` as well to continue something you already started, which is how you answer a question the designer asked you or send a follow-up instruction about the same dashboard. Pass the change in `instructions` in the user's words. If it is too vague to act on, the designer comes back with a question. New charts use the data sources the dashboard already has unless you say otherwise. Chan…
Show 5 more tools
pingTest Connectionread-onlySimple ping tool to test connectivity and Auth
search_objectsSearch Objectsread-onlySearch for objects (Answers, Liveboards, Worksheets) in ThoughtSpot matching a given search term. Supports optional filters (types, owner, tag, modified_since, verified_only) and pagination (limit, cursor). Returns `results` (ranked), plus `next_cursor`. Each result carries: object_id, title, type (LIVEBOARD | ANSWER | LIVEBOARD_VIZ | WORKSHEET; LIVEBOARD_VIZ is a viz pinned on a Liveboard — render it as 'Liveboard viz'), author_name, description, tags, last_modified (ISO-8601), verified, external_link, query (Answer/viz sage tokens; null for Liveboards) and confidence. Returns identifiers and…
send_model_messageBuild ModelSend an instruction to the model builder — a description of the model to build (e.g. 'create a model for sales from the ORDERS and CUSTOMERS tables'), a follow-up correction, or `selected_option_ids` to answer a clarification it asked. Returns as soon as the instruction is accepted; call get_model_updates to read the builder's response. The builder drives the conversation — don't invent your own questions. BEFORE ADDING FORMULAS: first tell the user the specific formulas you intend to add and get their confirmation — never have formulas added without the user signing off on them. Only one inst…
send_session_messageSend Analysis Session Messageread-onlySend a message to a session with the Analytics Agent. The Agent may take some time to think and generate a response, so the response will not be returned immediately. Instead, you can use the `get_session_updates` tool to query for the latest updates on the session. After the Agent finishes responding (when `get_session_updates` returns `is_done: true`), you can send another message to the same session to ask follow-up questions without creating a new session. Do not send a new message until the Agent has finished responding to the previous message (when `get_session_updates` returns `is_done:…
switch_orgSwitch Orgread-onlySwitch the active Org. After switching, all subsequent tool calls (analysis sessions, answers, data sources, dashboards) operate against the selected Org. Pass an `org_id` returned by `list_orgs`. If you do not have access to the Org, the switch fails and the active Org is unchanged. The selection is durable and shared across all of your sessions — it persists across reconnects and applies to your other active conversations; it resets only on re-authentication or after prolonged inactivity. Only available when authenticated via OAuth.
Signals
- Stars
- 34
- Forks
- 12
- Open issues
- 2
- Contributors
- 11
- Last commit
- Oct 20, 2026 (9 days ago)
- Last release
- Sep 17, 2025 (1 year ago)
From GitHub (fetched Oct 24, 2026).
Details
- Registry name
app.thoughtspot/mcp-server- Version
- 1.0.1
- Auth
- Auth not stated, Bearer token
- License
- License unknown
- Repository
- github.com/thoughtspot/mcp-server
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
Cite this page
Thoughtspot MCP server. Agent Mart. https://agentmart.dev/connectors/thoughtspot-app-mcp-server (last updated 2026-10-24)