Skip to main content

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.

Basedash provides a Model Context Protocol (MCP) 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.
If you want to connect external MCP servers to Basedash, see MCP connectors. This page is only for connecting MCP clients to the Basedash MCP server.

​
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 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

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:
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.
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.
All tools respect the same permissions and access controls as your Basedash workspace, so your AI client can only see data you already have access to.

​
Troubleshooting

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.
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.
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.
Basedash respects your workspace access controls. 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.
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.
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.