> For the complete documentation index, see [llms.txt](https://docs.selectstar.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.selectstar.com/features/mcp-server.md).

# MCP Server

## Overview

The Select Star MCP Server enables MCP Clients like Cursor and Claude Desktop to access your Select Star MCP tools. Using the Model Context Protocol (MCP), your AI assistant can search for tables, dashboards, and columns, retrieve detailed asset information, and help you understand your data lineage.

## What is MCP?

Model Context Protocol (MCP) is a standard that allows AI assistants to connect to external systems and data sources securely. When you configure the Select Star MCP Server, your AI assistant gains the ability to:

* Answer questions about your data catalog
* Find relevant tables and columns for your analysis
* Provide context about data sources and their relationships
* Help you understand data lineage and dependencies
* Support dbt development workflows with schema discovery and production usage insights

## Getting started

#### Prerequisites

Before you can use the Select Star MCP Server, you'll need:

1. [Select Star API Token](/select-star-api/authentication.md)
2. MCP Client (Claude Desktop, Cursor IDE, etc.)
3. When using `mcp-remote@latest` in the configuration: Node.js (version 18 or higher)
   * Download and install Node.js from [nodejs.org](https://nodejs.org/en/download)
   * Follow the installation guide for your operating system
   * Verify installation by running `node --version` in your terminal

#### Quick Setup

The Select Star MCP Server works with any MCP Client. Here's how to configure it:

#### Cursor IDE

In Cursor, you need to configure the MCP server in your settings:

1. Open Cursor Settings
2. Navigate to "Tools & Integrations" → Click on "New MCP Server"
3. Add the following configuration to your MCP servers section:

```json
{
  "mcpServers": {
    "select-star": {
      "url": "https://mcp.production.selectstar.com/mcp",
      "headers": {
        "Authorization": "Bearer <your_actual_api_token_here>"
      }
    }
  }
}
```

**Important:** Replace `<your_actual_api_token_here>` with your Select Star API token.

#### Claude Code

For Claude Code, run this command in your terminal to add within the user scope:

```bash
claude mcp add --transport http select-star https://mcp.production.selectstar.com/mcp --header "Authorization: Bearer <your_actual_api_token_here>" -s user
```

**Important:** Replace `<your_actual_api_token_here>` with your Select Star API token.

#### Claude Desktop

For Claude Desktop, you need to modify the configuration file. You can follow the guide [here](https://modelcontextprotocol.io/quickstart/user) or:

1. Open Claude Settings
2. Navigate to "Developer" → Click on "Edit Config"
3. Add the following configuration to your MCP servers section in `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "select-star": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.production.selectstar.com/mcp",
        "--header",
        "Authorization:${SELECT_STAR_TOKEN}"
      ],
      "env": {
        "SELECT_STAR_TOKEN": "Bearer <your_actual_api_token_here>"
      }
    }
  }
}
```

**Important:** Replace `<your_actual_api_token_here>` with your Select Star API token.

#### Other MCP Clients

This server follows the standard MCP protocol and should work with any MCP Client. Adapt the configuration format to match your client's requirements while using the same connection details.

## Available Tools

We're continuously expanding the MCP Server's capabilities. If you need functionality that isn't currently available, please reach out to us at <support@getselectstar.com> - we'd love to understand your use case and may be able to prioritize it in our roadmap.

### `search_metadata`

Search across all data catalog metadata with advanced filtering capabilities.

### `get_asset_details`

Retrieve comprehensive information about a specific data asset.

### `get_table_info`

Retrieve detailed table schema and usage information.

### `traverse_lineage`

Explore data lineage relationships and dependencies.

### `get_asset_queries`

Retrieve data warehouse queries connected to tables or columns.

### `search_semantic_models`

Search for semantic models in the data catalog.

### `get_semantic_model_details`

Retrieve complete details about a specific semantic model, including YAML content.

## Troubleshooting

#### Authentication Failed

1. Verify your API token is correct
2. Ensure the token is properly formatted with "Bearer " prefix

#### Node.js Issues

1. Ensure Node.js version 18 or higher is installed
2. Try running `npx --version` to verify npx is available
3. Clear npx cache with `npx --cache-dir clear` if you encounter package issues

#### Connection Issues

1. Verify your internet connection
2. Check if your firewall allows connections to `https://mcp.production.selectstar.com/mcp`
3. Try running the npx command manually in your terminal to test connectivity


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.selectstar.com/features/mcp-server.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.