{"_id":"@thoughtspot/mcp-server","_rev":"6-ecd579d5a70a15be62b864a8b8fcdaa8","name":"@thoughtspot/mcp-server","dist-tags":{"latest":"0.5.0"},"versions":{"0.4.0":{"name":"@thoughtspot/mcp-server","version":"0.4.0","keywords":[],"author":"","license":"ThoughtSpot End user license agreement","_id":"@thoughtspot/mcp-server@0.4.0","maintainers":[{"name":"tse-developers","email":"tse-developers@thoughtspot.com"},{"name":"ashubham","email":"ashubham@gmail.com"},{"name":"bhanu.jupally","email":"bhanu.jupally@thoughtspot.com"},{"name":"mouryab","email":"mourya.b@gmail.com"},{"name":"pallavp","email":"pallav.pandey2011@gmail.com"},{"name":"prashant.patilts","email":"prashant.patil@thoughtspot.com"},{"name":"utsavkapoor","email":"utsav.kapoor@asu.edu"},{"name":"priyanshu.kumar","email":"priyanshu.kumar@thoughtspot.com"},{"name":"mdabdullasulaiman","email":"abdullasulaiman@gmail.com"},{"name":"divyam.lamiyan","email":"divyam.lamiyan@thoughtspot.com"},{"name":"sastaachar","email":"justinjohnmathew100@gmail.com"},{"name":"ruchi9897","email":"ruchianand52@gmail.com"},{"name":"prateekagr98","email":"prateekagr98@gmail.com"}],"bin":{"mcp-server":"node --import tsx ./src/stdio.ts"},"dist":{"shasum":"c0de138796126f3b1d9d88db07127ef56f2dd560","tarball":"https://registry.npmjs.org/@thoughtspot/mcp-server/-/mcp-server-0.4.0.tgz","fileCount":24,"integrity":"sha512-OJvy5NsYUFiFSfE+QvxMhwTkuLA22KaVCBgFyJ7s3K0qQZOn4f4dCZtf25bNZK2rSwZmtIuPS0gvA1SHs5ABUg==","signatures":[{"sig":"MEQCIELShigjZIs9DcdYdz5ZaYw8aO0bCpwXIcWRwsAMb/2DAiBTvBrKwMo8qX12MPSk2NXfkhtKm+cxRQ/6K6bAxUoJOg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":314579},"main":"src/index.ts","type":"module","gitHead":"216c427104477eb2a745ff639659926e5b7d2a73","private":false,"scripts":{"dev":"wrangler dev","test":"vitest run","start":"wrangler dev","deploy":"wrangler deploy","format":"biome format --write","lint:fix":"biome lint --write","test:bin":"node --import tsx ./src/stdio.ts","cf-typegen":"wrangler types","test:watch":"vitest","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"ashubham","email":"ashubham@gmail.com"},"_npmVersion":"10.9.2","description":"MCP Server for ThoughtSpot","directories":{},"_nodeVersion":"22.15.0","dependencies":{"zod":"^3.24.3","hono":"^4.7.8","yaml":"^2.7.1","agents":"^0.0.75","zod-to-json-schema":"^3.24.5","@modelcontextprotocol/sdk":"^1.10.2","@thoughtspot/rest-api-sdk":"^2.13.1","@cloudflare/workers-oauth-provider":"^0.0.5"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.1","vitest":"^3.1.2","wrangler":"^4.12.0","node-fetch":"^2.6.0","typescript":"^5.8.3","@types/node":"^22.15.3","workers-mcp":"^0.0.13","@biomejs/biome":"^1.9.4","mcp-testing-kit":"^0.2.0","@types/node-fetch":"^2.6.0","@vitest/coverage-v8":"^3.1.2","@cloudflare/workers-types":"^4.20250430.0","@vitest/coverage-istanbul":"^3.1.2","@cloudflare/vitest-pool-workers":"^0.8.24"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.4.0_1747871174830_0.3772442251301873","host":"s3://npm-registry-packages-npm-production"}},"0.5.0":{"name":"@thoughtspot/mcp-server","version":"0.5.0","keywords":[],"author":"","license":"ThoughtSpot End user license agreement","_id":"@thoughtspot/mcp-server@0.5.0","maintainers":[{"name":"tse-developers","email":"tse-developers@thoughtspot.com"},{"name":"ashubham","email":"ashubham@gmail.com"},{"name":"bhanu.jupally","email":"bhanu.jupally@thoughtspot.com"},{"name":"mouryab","email":"mourya.b@gmail.com"},{"name":"pallavp","email":"pallav.pandey2011@gmail.com"},{"name":"prashant.patilts","email":"prashant.patil@thoughtspot.com"},{"name":"utsavkapoor","email":"utsav.kapoor@asu.edu"},{"name":"priyanshu.kumar","email":"priyanshu.kumar@thoughtspot.com"},{"name":"mdabdullasulaiman","email":"abdullasulaiman@gmail.com"},{"name":"divyam.lamiyan","email":"divyam.lamiyan@thoughtspot.com"},{"name":"sastaachar","email":"justinjohnmathew100@gmail.com"},{"name":"ruchi9897","email":"ruchianand52@gmail.com"},{"name":"prateekagr98","email":"prateekagr98@gmail.com"}],"bin":{"mcp-server":"node --import tsx ./src/stdio.ts"},"dist":{"shasum":"9d6c8fc841dfe471fe74011c8f9c32e9d74b364c","tarball":"https://registry.npmjs.org/@thoughtspot/mcp-server/-/mcp-server-0.5.0.tgz","fileCount":30,"integrity":"sha512-k03bcPbOH37d+usmfetTC8jB4+NPGAhnuCHByhCSbu8pMpqGXj7Ms6KewrpQqyA0coxphR5kxw3+N+iVjN8/Mw==","signatures":[{"sig":"MEUCIQDLoawp6oyYXyCc41P9jtR5N43q9wgwJ0OUEhqKia6LhgIgSvHAmUmOBPZhdb79bThq5fbxeoIGcDeyvOe4XakbI8Y=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":331679},"main":"src/index.ts","type":"module","gitHead":"f36b7b0bb6fa092fe88d99fcb3a9ca462d9578a9","private":false,"scripts":{"bin":"node --import tsx ./src/stdio.ts","dev":"wrangler dev","lint":"biome lint","test":"vitest run","start":"wrangler dev","deploy":"wrangler deploy","format":"biome format --write","lint:fix":"biome lint --write","cf-typegen":"wrangler types","test:watch":"vitest","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"ashubham","email":"ashubham@gmail.com"},"_npmVersion":"10.9.2","description":"MCP Server for ThoughtSpot","directories":{},"_nodeVersion":"22.15.0","dependencies":{"zod":"^3.24.3","hono":"^4.7.8","yaml":"^2.7.1","agents":"^0.0.95","zod-to-json-schema":"^3.24.5","@modelcontextprotocol/sdk":"^1.12.1","@thoughtspot/rest-api-sdk":"^2.13.1","@cloudflare/workers-oauth-provider":"^0.0.5"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.1","vitest":"^3.1.2","wrangler":"^4.12.0","node-fetch":"^2.6.0","typescript":"^5.8.3","@types/node":"^22.15.3","workers-mcp":"^0.0.13","@biomejs/biome":"^1.9.4","mcp-testing-kit":"^0.2.0","@types/node-fetch":"^2.6.0","@vitest/coverage-v8":"^3.1.2","@types/mixpanel-browser":"^2.60.0","@cloudflare/workers-types":"^4.20250430.0","@vitest/coverage-istanbul":"^3.1.2","@cloudflare/vitest-pool-workers":"^0.8.24"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.5.0_1749170488444_0.6658853359456063","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2025-05-21T23:46:14.747Z","modified":"2026-02-27T03:29:05.979Z","0.4.0":"2025-05-21T23:46:15.043Z","0.5.0":"2025-06-06T00:41:28.632Z"},"license":"ThoughtSpot End user license agreement","keywords":[],"description":"MCP Server for ThoughtSpot","maintainers":[{"email":"tse-developers@thoughtspot.com","name":"tse-developers"},{"email":"ashubham@gmail.com","name":"ashubham"},{"email":"bhanu.jupally@thoughtspot.com","name":"bhanu.jupally"},{"email":"aditya.mittal@thoughtspot.com","name":"aditya.mittal"},{"email":"mourya.b@gmail.com","name":"mouryab"},{"email":"pallav.pandey2011@gmail.com","name":"pallavp"},{"email":"prashant.patil@thoughtspot.com","name":"prashant.patilts"},{"email":"utsav.kapoor@asu.edu","name":"utsavkapoor"},{"email":"priyanshu.kumar@thoughtspot.com","name":"priyanshu.kumar"},{"email":"abdullasulaiman@gmail.com","name":"mdabdullasulaiman"},{"email":"nakshatra.mukhopadhyay1994@gmail.com","name":"n0x3u5"},{"email":"justinjohnmathew100@gmail.com","name":"sastaachar"},{"email":"ruchianand52@gmail.com","name":"ruchi9897"}],"readme":"<p align=\"center\">\n    <img src=\"https://raw.githubusercontent.com/thoughtspot/visual-embed-sdk/main/static/doc-images/images/TS-Logo-black-no-bg.svg\" width=120 align=\"center\" alt=\"ThoughtSpot\" />\n</p>\n\n<br/>\n\n# ThoughtSpot MCP Server <br/> ![MCP Server](https://badge.mcpx.dev?type=server 'MCP Server') ![Static Badge](https://img.shields.io/badge/cloudflare%20worker-deployed-green?link=https%3A%2F%2Fdash.cloudflare.com%2F485d90aa3d1ea138ad7ede769fe2c35e%2Fworkers%2Fservices%2Fview%2Fthoughtspot-mcp-server%2Fproduction%2Fmetrics) ![GitHub branch check runs](https://img.shields.io/github/check-runs/thoughtspot/mcp-server/main) [![Coverage Status](https://coveralls.io/repos/github/thoughtspot/mcp-server/badge.svg?branch=main)](https://coveralls.io/github/thoughtspot/mcp-server?branch=main) <a href=\"https://developer.thoughtspot.com/join-discord\" target=\"_blank\"> <img alt=\"Discord: ThoughtSpot\" src=\"https://img.shields.io/discord/1143209406037758065?style=flat-square&label=Chat%20on%20Discord\" /> </a>\n\n\nThe ThoughtSpot MCP Server provides secure OAuth-based authentication and a set of tools for querying and retrieving relevant data from your ThoughtSpot instance. It's a remote server hosted on Cloudflare.\n\nIf you do not have a Thoughtspot account, create one for free [here](https://thoughtspot.com/trial).\n\nLearn more about [ThoughtSpot](https://thoughtspot.com).\n\nJoin our [Discord](https://developers.thoughtspot.com/join-discord) to get support.\n\n## Table of Contents\n\n- [MCP Client Configuration](#mcp-client-configuration)\n- [Features](#features)\n  - [Supported transports](#supported-transports)\n- [Contributing](#contributing)\n  - [Local Development](#local-development)\n  - [Endpoints](#endpoints)\n- [Configuration](#configuration)\n- [Stdio support (fallback)](#stdio-support-fallback)\n  - [How to obtain a TS_AUTH_TOKEN](#how-to-obtain-a-ts_auth_token)\n- [Troubleshooting](#troubleshooting)\n\n## MCP Client Configuration\n\nTo configure this MCP server in your MCP client (such as Claude Desktop, Windsurf, Cursor, etc.), add the following configuration to your MCP client settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"ThoughtSpot\": {\n      \"command\": \"npx\",\n      \"args\": [\n         \"mcp-remote\",\n         \"https://agent.thoughtspot.app/sse\"\n      ]\n    }\n  }\n}\n```\n\nSee the [Troubleshooting](#troubleshooting) section for any errors.\n\n## Features\n\n- **OAuth Authentication**: Access your data, as yourself.\n- **Tools**:\n  - `ping`: Test connectivity and authentication.\n  - `getRelevantQuestions`: Get relevant data questions from ThoughtSpot analytics based on a user query.\n  - `getAnswer`: Get the answer to a specific question from ThoughtSpot analytics.\n  - `createLiveboard`: Create a liveboard from a list of answers.\n- **MCP Resources**:\n   - `datasources`: List of ThoughtSpot Data models the user has access to.\n\n### Supported transports\n\n- SSE [/sse]()\n- Streamed HTTP [/mcp]()\n\n## Contributing\n\n### Local Development\n\n1. **Install dependencies**:\n   ```sh\n   npm install\n   ```\n2. **Set up environment variables**:\n   - Copy `.dev.vars` and fill in your ThoughtSpot instance URL and access token.\n3. **Start the development server**:\n   ```sh\n   npm run dev\n   ```\n\n### Endpoints\n\n- `/mcp`: MCP HTTP Streaming endpoint\n- `/sse`: Server-sent events for MCP\n- `/api`: MCP tools exposed as HTTP endpoints\n- `/authorize`, `/token`, `/register`: OAuth endpoints\n\n## Configuration\n\n- **wrangler.jsonc**: Configure bindings, secrets, and compatibility.\n\n\n## Stdio support (fallback)\n\nIf you are unable to use the remote MCP server due to connectivity restrictions on your Thoughtspot instance. You could use the `stdio` local transport using the `npm` package.\n\nHere is how to configure `stdio` with MCP Client:\n\n```json \n{\n  \"mcpServers\": {\n    \"ThoughtSpot\": {\n      \"command\": \"npx\",\n      \"args\": [\n         \"@thoughtspot/mcp-server\"\n      ],\n      \"env\": {\n         \"TS_INSTANCE\": \"<your Thoughtspot Instance URL>\",\n         \"TS_AUTH_TOKEN\": \"<ThoughtSpot Access Token>\"\n      }\n    }\n  }\n}\n```\n\n#### How to obtain a `TS_AUTH_TOKEN` ?\n\n- Go to ThoughtSpot => _Develop_ => _Rest Playground v2.0_\n- _Authentication_ => _Get Full access token_\n- Scroll down and expand the \"body\"\n- Add your \"username\" and \"password\".\n- Put whatever \"validity_time\" you want the token to be.\n- Click on \"Try it out\" on the bottom right.\n- You should get a token in the response, thats the bearer token.\n\n#### Alternative way to get `TS_AUTH_TOKEN`\n- Login to the ThoughtSpot instance as you would normally.\n- Opem in a new tab this URL:\n  - https://your-ts-instance/api/rest/2.0/auth/session/token\n- You will see a JSON response, copy the \"token\" value (without the quotes).\n- This is the token you could use.\n\n### Troubleshooting\n\n> Oauth errors due to CORS/SAML.\n\nMake sure to add the following entries in your ThoughtSpot instance:\n\n*CORS*\n\n- Go to ThoughtSpot => _Develop_ => Security settings\n- Click \"Edit\"\n- Add \"agent.thoughtspot.app\" to the the \"CORS whitelisted domains\". \n\n*SAML* (need to be Admin)\n\n- Go to ThoughtSpot => _Develop_\n- Go to \"All Orgs\" Tab on the left panel if there is one.\n- Click \"Security settings\"\n- Click \"Edit\"\n- Add \"agent.thoughtspot.app\" to the the \"SAML redirect domains\". \n\n\n\nMCP Server, © ThoughtSpot, Inc. 2025","readmeFilename":"README.md"}