English Français العربية

io.github.brownglasses/dotplot-mcp

Official registry Marketing and sales

Product analytics for user flows: aha moments, retention, funnels, per-user dot plots. YC method.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package dotplot-mcp
Claude Code 
claude mcp add dotplot-mcp -- uvx dotplot-mcp==0.1.4
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "dotplot-mcp": {
            "command": "uvx",
            "args": [
                "dotplot-mcp==0.1.4"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Dot Plot MCP
  2. Install
  3. Use
  4. Why this exists
  5. More

Dot Plot MCP

See individual users, not aggregate charts.

English | 한국어

Install

Paste this to your agent and it sets everything up:

Set up Dotplot (MCP + skills) — instructions are here https://dotplot-reports.vercel.app/setup.md

Or do it by hand

claude mcp add --scope user dotplot -- uvx dotplot-mcp

Use

Say this in any project:

"Analyze my product"

You get the report above. That's it.

Or use the slash commands:

/dotplot-analyze-product    full analysis and report
/dotplot-add-tracking       find and write the logging you're missing
/dotplot-whats-changed      compare with the previous report

Claude finds your data, picks the action that means "this user got value", and writes the report. No events table needed — your orders table already is one:

SELECT user_id, created_at::date AS date, 'purchase' AS event FROM orders
UNION ALL
SELECT user_id, added_at::date, 'add_to_wishlist' FROM wishlist_items

Nothing tracked yet? Say "add the tracking I'm missing" and Claude reads your code, writes the logging that's absent, and tells you when to come back.

No product to analyze yet? Try the sample

git clone https://github.com/brownglasses/dotplot-mcp && cd dotplot-mcp
uv run sample_data.py   # 40 fake users with a pattern planted in them
uv run harness.py       # watch the whole pipeline run

Why this exists

DAU/MAU charts go "up and to the right" as long as new users arrive — even when nobody stays. Until you have hundreds of users, the most informative dashboard is YC's dot plot (David Lieb): one row per user, one cell per day.

Four rules keep it honest:

  • Code computes, AI only interprets — same data, same numbers, every time
  • Small samples withhold judgment — under 5 users in a group, it says nothing
  • Correlation isn't cause — every finding ships with "test this before you believe it"
  • Vanity metrics are refused — pick open_app as your value event and the code says no

Reports come out in your language (English, 한국어, 日本語 built in; anything else translated on the fly with the numbers verified intact).

More

MIT

Frequently asked questions

What is io.github.brownglasses/dotplot-mcp?

Product analytics for user flows: aha moments, retention, funnels, per-user dot plots. YC method.

How do I install io.github.brownglasses/dotplot-mcp?

It runs on your machine. In Claude Code: claude mcp add dotplot-mcp -- uvx dotplot-mcp==0.1.4. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.brownglasses/dotplot-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.brownglasses/dotplot-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.brownglasses/dotplot-mcp?

It is published by brownglasses. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.