> ## Documentation Index
> Fetch the complete documentation index at: https://basedash.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP server

> Connect any MCP client to Basedash for AI-powered data analysis

Basedash provides a [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server that lets you connect any compatible AI client to your Basedash workspace. This gives AI assistants like Claude Code, ChatGPT, Cursor, Windsurf, and others the ability to analyze data and look up information across all your connected data sources.

For a product overview, see the Basedash [MCP server](https://www.basedash.com/features/mcp-server) page or the guide to [BI tools with MCP server support](https://www.basedash.com/blog/bi-tools-that-let-you-use-an-mcp-server-in-september-2025).

<Note>
  If you want to connect external MCP servers to Basedash, see [MCP
  connectors](/data-sources/mcp-connectors). This page is only for connecting
  MCP clients to the Basedash MCP server.
</Note>

## How it works

MCP is an open standard that allows AI applications to connect to external tools and data sources. By adding the Basedash MCP server to your AI client, you give it the ability to:

* Query your connected databases and data sources
* Generate charts and visualizations
* Look up business metrics and KPIs
* Analyze trends across your data

All queries respect the same permissions and [access controls](/features/data-source-access-control) configured in your Basedash workspace.

## Installation

Add the following URL as a remote MCP server in your client:

```
https://charts.basedash.com/api/public/mcp
```

When you connect for the first time, an OAuth flow will open in your browser to authenticate with your Basedash account.

### Claude Code

```bash theme={"dark"}
claude mcp add basedash --transport http https://charts.basedash.com/api/public/mcp
```

### Cursor

1. Open Cursor settings
2. Navigate to **MCP**
3. Click **Add new MCP server**
4. Set the type to **streamable-http** and enter the URL `https://charts.basedash.com/api/public/mcp`

### ChatGPT

1. Open ChatGPT settings
2. Navigate to **Connections** and click **Add connection**
3. Enter the URL `https://charts.basedash.com/api/public/mcp`

### Other clients

Any MCP client that supports remote servers can connect using the URL above. Refer to your client's documentation for how to add a remote MCP server.

## Available tools

Once connected, your AI client will have access to the following tools:

<AccordionGroup>
  <Accordion title="Ask question" icon="comments">
    Ask a question about your data in plain English and get an answer back from Basedash's AI data analyst. It has access to all of your connected data sources and can handle everything from quick lookups (like "how many signups did we get yesterday?") to deeper analysis (like trends, comparisons, and strategic insights).

    Each question can start a new chat or continue an existing one, so your AI client can have a back-and-forth conversation about your data.
  </Accordion>

  <Accordion title="Get data sources" icon="database">
    Lists all the data sources connected to your Basedash workspace, including databases, warehouses, and SaaS applications connected through Fivetran or MCP connectors. This helps your AI client understand what data is available before asking questions.
  </Accordion>
</AccordionGroup>

All tools respect the same permissions and [access controls](/features/data-source-access-control) as your Basedash workspace, so your AI client can only see data you already have access to.

## Troubleshooting

<AccordionGroup>
  <Accordion title="The connection fails or times out">
    Double-check that you entered the URL exactly as shown:

    ```
    https://charts.basedash.com/api/public/mcp
    ```

    Make sure your client is set to use the **streamable HTTP** transport (not stdio or SSE). If your client supports selecting a transport type, pick HTTP or streamable-http.
  </Accordion>

  {" "}

  <Accordion title="The OAuth login window never opens">
    Some clients only open the OAuth window the first time you connect. Try
    removing the Basedash MCP server from your client and adding it again. Also
    make sure pop-ups aren't blocked in your browser.
  </Accordion>

  {" "}

  <Accordion title="I get a “Forbidden” or “not a member” error">
    This usually means you authenticated with an account that isn't part of the
    Basedash workspace you're trying to query. Sign out of Basedash in your
    browser, reconnect the MCP server in your client, and log in with the correct
    account during the OAuth flow.
  </Accordion>

  {" "}

  <Accordion title="The AI can't see one of my data sources">
    Basedash respects your workspace [access
    controls](/features/data-source-access-control). If your account doesn't have
    access to a particular data source, the MCP server won't expose it either. Ask
    a workspace admin to grant you access, then try again.
  </Accordion>

  <Accordion title="Answers look wrong or incomplete">
    The AI data analyst uses the same engine as Basedash chat. If something looks off, try:

    * Asking a more specific question (include time ranges, metrics, or which data source to use)
    * Opening the chat in Basedash to inspect the SQL query and results
    * Making sure your data source's schema descriptions are up to date

    If issues persist, reach out to support from the Basedash app.
  </Accordion>

  <Accordion title="I hit a usage or billing limit">
    MCP questions count toward your workspace's AI usage. If you see a message about usage being blocked, a workspace admin can review your plan and usage in Basedash's billing settings.
  </Accordion>
</AccordionGroup>