# ThoughtSpot MCP server

> Connects an AI client to a ThoughtSpot instance so it can query live business data and return answers.

- Repository: https://github.com/thoughtspot/mcp-server
- Page: https://hostedmcp.org/servers/thoughtspot/mcp-server
- Transport: remote
- Stars: 35
- Latest version: 1.0.1

## Install

### Claude Code

```sh
claude mcp add --transport http mcp-server https://agent.thoughtspot.app/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "mcp-server": {
      "url": "https://agent.thoughtspot.app/mcp"
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "mcp-server": {
      "type": "http",
      "url": "https://agent.thoughtspot.app/mcp"
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"mcp-server","type":"http","url":"https://agent.thoughtspot.app/mcp"}'
```

### Codex

```sh
codex mcp add mcp-server --url https://agent.thoughtspot.app/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.mcp-server]
url = "https://agent.thoughtspot.app/mcp"
```

### Gemini CLI

```sh
gemini mcp add -s user --transport http mcp-server https://agent.thoughtspot.app/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "mcp-server": {
      "url": "https://agent.thoughtspot.app/mcp",
      "type": "http"
    }
  }
}
```

## FAQ

### How does the ThoughtSpot MCP server handle authentication?

It uses OAuth to connect to your ThoughtSpot instance and handles authentication securely. Clients without dynamic registration can register a client manually and supply the OAuth client ID and secret.

### What can I do with the ThoughtSpot MCP server?

It provides tools for querying and retrieving relevant data from your ThoughtSpot instance. Answers come from your own live data.

### Can I associate the MCP client with a specific ThoughtSpot instance?

Yes. Manual client registration lets you set the ThoughtSpot URL so users don't have to enter the instance URL during authorization.

### How do I register the ThoughtSpot MCP server manually?

Go to the ThoughtSpot clients page, register a new client, and copy the OAuth Client Id and Client Secret into your MCP client. The details are shown only once.
