Dot MCP server
Commit Nov 12, 2026Allows AI clients to query data warehouses using plain English to generate SQL, data answers, and charts.
Also known as Snowboard-Software/getdot, getdot
- Stars
- 1
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.2
- Last commit
- Nov 12, 2026
- License
- MIT
What is Dot MCP?
Dot allows AI clients to query data warehouses using plain English to generate SQL, data answers, and charts.
Summary generated from the project's README
About Dot MCP server
Dot acts as an AI data analyst that connects AI clients to your company data warehouses. It allows users to query information using plain English, which the system translates into SQL to find the correct tables and execute queries. The server provides results through explanations, SQL code, data previews, and visual charts. It maintains security by applying the same permissions established in your Dot workspace.
Developers can integrate this server with various clients including Claude, Claude Code, Codex, Cursor, Gemini CLI, and Windsurf. Setup involves connecting to a specific URL via MCP or using OAuth for signing in. For clients that do not support OAuth, you can generate an API token to use in the X-API-KEY header. The service is available in both US and EU regions, requiring specific server URLs depending on your workspace location.
What you can do with it
- 1Query data with natural languageAsk your AI agent to find specific business metrics like total sales without writing any code.
- 2Automate data analysis in workflowsUse the CLI to list available tables or check business context notes used for answering questions.
- 3Validate data accuracy in CIRun evaluation suites to ensure AI-generated answers match trusted numbers during continuous integration.
Written from the project's README. Every use case is checked against a quote from it.
How to install Dot MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Dot MCP in Claude Code
$ claude mcp add --transport http getdot https://app.getdot.ai/ai/mcpInstall Dot MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"getdot": {
"url": "https://app.getdot.ai/ai/mcp"
}
}
}Install Dot MCP in VS Code
.vscode/mcp.json
{
"servers": {
"getdot": {
"type": "http",
"url": "https://app.getdot.ai/ai/mcp"
}
}
}Install Dot MCP in VS Code CLI
$ code --add-mcp '{"name":"getdot","type":"http","url":"https://app.getdot.ai/ai/mcp"}'Install Dot MCP in Codex
$ codex mcp add getdot --url https://app.getdot.ai/ai/mcpInstall Dot MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.getdot] url = "https://app.getdot.ai/ai/mcp"
Install Dot MCP in Gemini CLI
$ gemini mcp add -s user --transport http getdot https://app.getdot.ai/ai/mcpInstall Dot MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"getdot": {
"url": "https://app.getdot.ai/ai/mcp",
"type": "http"
}
}
}Configuration
DOT_API_BASE_URLDOT_API_TOKEN
| Name | Description | |
|---|---|---|
| DOT_API_BASE_URL | — | |
| DOT_API_TOKEN | — |
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablesnowboard-software/getdot is public and reachablegithub.com/snowboard-software/getdot ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-12github.com/snowboard-software/getdot ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubDot CLI and agent skill
Query your company's data from Claude, Claude Code, Codex, Cursor, Gemini CLI or the terminal with Dot (getdot.ai), the AI data analyst.
Ask a question in plain English. Dot finds the right tables, writes and runs SQL on your own warehouse, and answers with the result, the SQL it ran, and charts. It applies the same permissions as your Dot workspace.
Install
macOS and Linux:
curl https://app.getdot.ai/install | sh # US region
curl https://eu.getdot.ai/install | sh # EU region
Windows (PowerShell):
irm https://app.getdot.ai/install.ps1 | iex # US region
irm https://eu.getdot.ai/install.ps1 | iex # EU region
The installer downloads the current dot binary from your Dot server and adds the Dot skill (SKILL.md in this repository) to the AI coding agents it finds. Then sign in:
dot login
Don't have a workspace yet? Start free: 300 credits, no credit card.
Ask questions
dot "What were total sales last month?"
dot "Break down by region" --chat <chat-id>
dot catalog
Each answer prints the explanation, the SQL query, a data preview and a link to the full analysis in Dot. Charts and CSV files are saved locally, so your coding agent can read them.
Manage your workspace
dot notes list # business context Dot uses to answer
dot tables list # tables Dot can query
dot env list # environments for testing changes before Production
dot apps pull <id> # data apps as code
dot eval run suite.json # check answers against trusted numbers, for example in CI
Run dot --help for every command.
Use Dot from AI agents
Claude
Open your Dot profile and click Add to Claude. Or add it by hand: in Claude, go to Customize → Connectors → Add custom connector and paste https://app.getdot.ai/ai/mcp. This works on claude.ai, Claude Desktop and Cowork.
Claude Code
claude plugin install dot --marketplace Snowboard-Software/getdot
The plugin bundles Dot's MCP connector and the Dot skill. Run /mcp in a session to sign in. On Claude Code before 2.1.292, run claude plugin marketplace add Snowboard-Software/getdot, then claude plugin install dot@getdot.
Already added Dot in Claude? Claude Code picks up that connector when you sign in with your Claude account. The plugin uses the same server, so you see one set of Dot tools.
Codex
codex mcp add dot --url https://app.getdot.ai/ai/mcp
Codex opens your browser to sign in. The ChatGPT desktop app and the IDE extension read the same configuration.
Or install the plugin, which also adds the Dot skill:
codex plugin marketplace add Snowboard-Software/getdot
codex plugin add dot@getdot
codex mcp login dot
Other agents
npx skills add https://github.com/Snowboard-Software/getdot
This adds the Dot skill to Cursor, Gemini CLI and other agents. The CLI installer above adds it too.
Connect Cursor, Windsurf or any MCP client to https://app.getdot.ai/ai/mcp. ChatGPT has its own URL: https://app.getdot.ai/chatgpt/mcp.
EU workspaces
The plugins connect to the US server. For a workspace on eu.getdot.ai, add the EU server directly:
claude mcp add --transport http --scope user dot https://eu.getdot.ai/ai/mcp
codex mcp add dot --url https://eu.getdot.ai/ai/mcp
In Claude, use Add to Claude on your EU profile, or paste https://eu.getdot.ai/ai/mcp. ChatGPT: https://eu.getdot.ai/chatgpt/mcp. Add the skill with npx skills add above.
Clients without OAuth
Claude, Codex, ChatGPT, Cursor and Windsurf sign in with OAuth. Clients without OAuth send an MCP token in the X-API-KEY header. To get one, open your Profile in Dot, go to Use Dot elsewhere > MCP, open Client can't do OAuth? Use an API token and click Generate token. Setup for each client: MCP docs. The server is listed in the MCP Registry as io.github.zurferr/dot.
CI and headless servers
Set the token through your CI secret store and choose the regional server:
export DOT_API_BASE_URL="https://app.getdot.ai"
export DOT_API_TOKEN="YOUR_API_TOKEN"
See Evaluations in CI.
Links
- Website: https://www.getdot.ai
- Docs: CLI, MCP, API
- Security: https://www.getdot.ai/security (SOC 2 Type II, GDPR)
This repository holds the Dot plugin for Claude Code and Codex (plugins/dot), the agent skill and an early version of the CLI source. The installer always fetches the current CLI binary from your Dot server.
Maintainers: bump version in plugins/dot/.claude-plugin/plugin.json with every change to the plugin, or installed copies keep the old one.
License
MIT
Dot MCP questions
How do I add Dot MCP to Claude Code?
Run claude mcp add --transport http getdot https://app.getdot.ai/ai/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Dot MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What happens when I ask a question in plain English?
Dot identifies the correct tables, writes and executes SQL on your warehouse, and provides the result along with the SQL used and visual charts.
How do I authenticate if my client does not support OAuth?
You can generate an MCP token in your Dot Profile under 'Use Dot elsewhere > MCP' and provide it via the X-API-KEY header.