Dot (getdot.ai): AI Data Analyst

io.github.zurferrPublished by GitHub account zurferrv1.0.2Updated Oct 24, 2026

AI data analyst by getdot.ai. Ask your data warehouse in plain English; get SQL, answers and charts.

VerifiedStreamable HTTPWeb executableDatabasesData & Analytics

Overview

AI-generated overview

Dot (getdot.ai) is a remote AI data analyst that lets an assistant ask your data warehouse questions in plain English and get SQL, answers and charts.

What you can do
  • Ask business questions in plain English and receive the answer, the SQL that was run, a data preview and a link to the full analysis
  • Find the right tables in your own warehouse and run SQL against them under your Dot workspace permissions
  • Save charts and CSV results locally so a coding agent can read them
  • Inspect workspace context: business notes, queryable tables and environments
  • Pull data apps as code and run evaluation suites that check answers against trusted numbers
When to use it
Useful when you want an assistant to answer data questions from your company warehouse without writing SQL yourself, or to check answers against trusted numbers in CI. Also fits teams already using a Dot workspace who want the same data access from Claude, Codex, Cursor or other MCP clients.
Requirements
A remote MCP endpoint (US or EU region) and a Dot workspace account. OAuth sign-in for clients that support it; otherwise an MCP token sent in the X-API-KEY header, generated from the Dot profile. The CLI path needs a local install and a login; CI setups use the DOT_API_BASE_URL and DOT_API_TOKEN environment variables.
Before you install
The token in X-API-KEY grants access to your workspace data and should be stored as a secret. Queries run against your real warehouse under your Dot permissions, so results reflect whatever data you can already see. Charts and CSV files are written to local disk. Usage is credit-based, and a free workspace starts with 300 credits.

Installation

In SourceWeft

  1. Open Dot (getdot.ai): AI Data Analyst in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.zurferr%2Fdot/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "dot-getdot-ai-ai-data-analyst": {
      "type": "http",
      "url": "https://app.getdot.ai/ai/mcp"
    }
  }
}

README

Dot 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:

bash
curl https://app.getdot.ai/install | sh    # US regioncurl https://eu.getdot.ai/install | sh     # EU region

Windows (PowerShell):

powershell
irm https://app.getdot.ai/install.ps1 | iex    # US regionirm 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:

bash
dot login

Don't have a workspace yet? Start free: 300 credits, no credit card.

Ask questions

bash
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

bash
dot notes list          # business context Dot uses to answerdot tables list         # tables Dot can querydot env list            # environments for testing changes before Productiondot apps pull <id>      # data apps as codedot 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

bash
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

bash
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:

bash
codex plugin marketplace add Snowboard-Software/getdotcodex plugin add dot@getdotcodex mcp login dot

Other agents

bash
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:

bash
claude mcp add --transport http --scope user dot https://eu.getdot.ai/ai/mcpcodex 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:

bash
export DOT_API_BASE_URL="https://app.getdot.ai"export DOT_API_TOKEN="YOUR_API_TOKEN"

See Evaluations in CI.

Links

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

Source: README.md at commit 4310ffe

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

3
  1. v1.0.2LatestOct 17, 2026
  2. v1.0.1Oct 17, 2026
  3. v1.0.0Sep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts