Mcp Analytics

SSE

by embeddedlayers

358 downloads Not rated yet

About

MCP server for data analytics — upload CSV files or connect Shopify, Stripe, GA4, and Search Console. 50+ statistical and ML tools including regression, clustering, time series, hypothesis testing, and customer analytics. Semantic tool discovery matches your question to the right

Details

Transport
SSE

Explore

- Authentication: OAuth2 via Auth0 with PKCE
- Encryption: TLS 1.3 for all data transfers
- Processing: Isolated Docker containers per analysis
- Data Handling: Ephemeral processing, no persistence
- Access Control: OAuth 2.0 scoped permissions with usage limits
- Audit Trail: Complete logging for compliance

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Mcp Analytics
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Add the following JSON snippet to your MCP client config (Claude Desktop, Cursor, VS Code Continue Extension, or Claude Code): "command": "npx", "args": ["-y", "mcp-remote@latest", "https://api.mcpanalytics.ai/auth0"]. Restart your IDE, authenticate via OAuth2, then ask analytics questions in natural language.

get_started_guide

Markdown walkthrough of the mcp-analytics workflow: adding sites, installing the tracker, querying analytics, custom events.

list_sites

List all sites on the authenticated account. Each entry contains: site_id, domain, privacy_mode, hits_this_month (current calendar month), plan_limit, created_at.

add_site

Register a new site. privacy_mode cannot be changed later.

get_tracking_snippet

Return the HTML <script> snippet for a given site_id.

remove_site

Soft-delete a site. Historical events remain until TTL expires.

get_overview

TL;DR for the period: headline metrics (pageviews, visitors, sessions, bounce rate, avg session duration) plus pageviews_change_pct vs the previous equivalent window, top page, top traffic source, bot share, and top 3 custom events. Designed so a single call answers 'how did <period> go?' without chaining other tools. Volume metrics (pageviews / visitors / sessions / bot_share) include AI-mediated human browsing (ai_user_action — Claude/ChatGPT fetching on a user's behalf); attribution metric…

get_timeseries

Time-bucketed metric over a period. pageviews/visitors/sessions include AI-mediated human browsing (ai_user_action) — see traffic_class_breakdown to see the AI-vs-direct split.

top_pages

Most-viewed URL paths. Counts both direct browser visits and AI-mediated human browsing (ai_user_action) — see traffic_class_breakdown if you need to separate them.

top_referrers

Top referring hosts. Attribution metric — counts direct browser visits only ('user' class). AI-mediated traffic (Claude/ChatGPT fetching on a user's behalf) is excluded because the AI sets its own host as referrer or strips it; including it would inflate 'direct' or 'claude.ai' without telling you where the human attention actually came from.

top_sources

Top UTM source/medium/campaign combinations. Attribution metric — counts direct browser visits only ('user' class). AI-mediated traffic loses original UTM tags so it would only add noise.

breakdown

Breakdown of visits by browser, os, device_type, or country (country empty in MVP). Volume metric — counts include AI-mediated human browsing (ai_user_action).

list_events

All event names with counts (includes 'pageview' and custom events). Volume metric — counts include AI-mediated human browsing (ai_user_action).

event_details

Details for one event. Optionally break down by a custom property. Volume metric — counts include AI-mediated human browsing (ai_user_action).

compare_periods

Compare a metric between two periods. Volume metric — counts include AI-mediated human browsing (ai_user_action).

top_user_agents

Top User-Agent strings with their traffic_class. Default analytics queries hide everything except real visitors; this tool surfaces the rest so you can see who is actually fetching the site. Pass traffic_class to filter to one bucket. The 8 classes (Phase 2 Cloudflare-compatible taxonomy): - user: real human visitor with their own browser - ai_user_action: live AI browse — a human is chatting with ChatGPT/Claude/Perplexity/Copilot and the assistant fetched the page on their behalf (counts as…

traffic_class_breakdown

Hit counts and percentages by traffic_class for the period. Sorted by hits descending. Classes with zero hits are omitted (a missing class means no hits in that period, treat as zero). The 8 classes (Phase 2 Cloudflare-compatible taxonomy): - user: real human visitor with their own browser - ai_user_action: live AI browse — a human is chatting with ChatGPT/Claude/Perplexity/Copilot and the assistant fetched the page on their behalf. Counts as human attention, just AI-mediated. - ai_search: …

top_timezones

Top IANA timezones (Europe/Berlin, America/New_York, ...) of visitors. Quasi-geo signal without IP-based lookups — captured client-side via Intl.DateTimeFormat.

top_languages

Top browser languages (de-DE, en-US, ...) of visitors. From navigator.language.

color_scheme_breakdown

Share of visitors with prefers-color-scheme: dark vs light. Useful for product decisions ('should we default to dark mode?').

viewport_breakdown

Pageviews bucketed by viewport width: mobile_xs (<480), mobile (<768), tablet (<1024), desktop (<1440), desktop_xl (≥1440). Real usable viewport, not screen resolution.

engagement_overview

Real reading time + scroll depth from the engagement beacon (fired on pagehide). Returns engaged_pages count, avg/median/p90 engagement seconds, and avg/median scroll-depth percentage. Better signal than session duration which counts inactive tabs.

get_account

Account info — email, current plan, total active sites, total_hits_this_month (across all sites), plan_limit, and api_token_first_chars (first 10 chars of the legacy API token, for identification only — not enough to authenticate).

The platform provides a complete suite of MCP tools for end-to-end analytics:

- discover_tools - Natural language tool discovery (5-signal semantic search)
- tools_run - Execute an analysis module on your data
- tools_info - Get tool documentation and schema
- tools_schema - Inspect column requirements for a tool

- billing - Usage and subscription management
- about - Platform information and status

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp analytics": {
            "mcp-analytics": {
                "command": "npx",
                "args": [
                    "@anthropic/mcp-analytics"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-analytics": {
        "command": "npx",
        "args": [
            "@anthropic/mcp-analytics"
        ]
    }
}

MCP server for data analytics — Shopify, Stripe, WooCommerce, eBay, CSV files, and more. Run statistical analysis, forecasting, and machine learning directly in Claude or Cursor. Ask a question, upload your data, get an interactive report.

> This is the public listing and documentation repository. Issues, feature requests, and examples live here. The API server code is maintained separately.

Sample Reports → • Try Demo → • Pricing →

<div align="center">

Version
Platform
License
Docs
Auth

Every analysis starts with a question. We handle the rest.

🚀 Quick Start • 🔄 How It Works • 🛠️ MCP Tools • 🛡️ Security • 📖 Documentation

</div>

---

The Formula

<div align="center">
<h3>Question + Dataset = Analytics</h3>
<p>Transform business questions into actionable insights through intelligent discovery</p>
</div>

Overview

MCP Analytics Suite is an intelligent analytics platform that understands what you want to analyze and automatically selects the right approach. No statistics degree required — just describe your business question and let our AI-powered discovery handle the complexity.

Upload any CSV — Shopify orders, Stripe exports, WooCommerce reports, eBay data, ad platform reports, or any tabular data. Connect live data from Google Analytics 4 and Google Search Console via native connectors. Run regression, forecasting, clustering, A/B testing, customer LTV, churn prediction, and hundreds of other statistical methods. Get back interactive HTML reports with charts and AI-written insights.

Why MCP Analytics?

- Intelligent Discovery: Automatically finds the right analytical approach
- Complete Workflow: From question to insight in one seamless flow
- Zero Setup: Cloud-based processing, works instantly
- Enterprise Security: OAuth2, encryption, isolated processing
- Comprehensive Suite: Full range of analytical capabilities
- Interactive Reports: Shareable visualizations with AI insights

Quick Start

Installation

For Claude Desktop

Add to your config file:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mcp-analytics": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://api.mcpanalytics.ai/auth0"]
    }
  }
}
For Cursor

Add to .cursor/config.json in your project root:

{
  "mcpServers": {
    "mcp-analytics": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://api.mcpanalytics.ai/auth0"]
    }
  }
}
For VS Code (Continue Extension)

Add to your Continue config at ~/.continue/config.json:

{
  "models": [{
    "provider": "anthropic",
    "model": "claude-3-5-sonnet",
    "mcpServers": {
      "mcp-analytics": {
        "command": "npx",
        "args": ["-y", "mcp-remote@latest", "https://api.mcpanalytics.ai/auth0"]
      }
    }
  }]
}
For Claude Code

Add to claude_code_config.json:

{
  "mcpServers": {
    "mcp-analytics": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://api.mcpanalytics.ai/auth0"]
    }
  }
}

How It Works

The MCP Analytics Workflow

1. Ask Your Question - Describe what you want to analyze in natural language
2. Intelligent Discovery - tools.discover finds the right analytical approach
3. Data Upload - datasets.upload securely processes your data
4. Automated Analysis - tools.run executes with optimal configuration
5. Interactive Results - reports.view delivers shareable insights

User: "What drives our sales growth?"
MCP Analytics:
  → Discovers regression and correlation methods
  → Configures analysis for your data structure
  → Runs multiple analytical approaches
  → Returns comprehensive report with insights

MCP Tools

The platform provides a complete suite of MCP tools for end-to-end analytics:

Core Analytics Tools

- discover_tools - Natural language tool discovery (5-signal semantic search) - tools_run - Execute an analysis module on your data - tools_info - Get tool documentation and schema - tools_schema - Inspect column requirements for a tool

Data Management

- datasets_upload - Secure data upload with encryption - datasets_list - List your uploaded datasets - datasets_read - Preview dataset contents - datasets_download - Download a dataset - datasets_update - Update dataset metadata

Connectors

- connectors_list - List available data source connections - connectors_query - Pull live data from a connected source

Reporting & Insights

- reports_view - Open an interactive HTML report - reports_list - List your reports - reports_search - Semantic search across past analyses - agent_advisor - Conversational AI that guides analysis and interprets results

Platform Tools

- billing - Usage and subscription management - about - Platform information and status

Features

Natural Language Interface

Just describe what you need:

"What drives our revenue growth?"
"Find customer segments in our data"
"Forecast next quarter's sales"
"Did our marketing campaign work?"

Comprehensive Analysis Suite

<table>
<tr>
<td width="50%">

Statistical Methods
- Regression Analysis
- Advanced Modeling
- Hypothesis Testing
- Survival Analysis
- Bayesian Methods

</td>
<td width="50%">

Machine Learning
- Ensemble Methods
- Boosting Algorithms
- Neural Networks
- Clustering
- Dimensionality Reduction

</td>
</tr>
<tr>
<td width="50%">

Time Series
- Forecasting
- Seasonal Analysis
- Trend Detection
- Multivariate Models
- Causal Analysis

</td>
<td width="50%">

Business Analytics
- Customer Analytics
- Market Analysis
- Pricing Models
- Predictive Analytics
- Experimental Design

</td>
</tr>
</table>

Seamless Workflow

graph LR
    A[Ask in Claude/Cursor] --> B[MCP Analytics]
    B --> C[Secure Processing]
    C --> D[Interactive Report]
    D --> E[Share Results]

Example Usage

Basic Regression

User: "I have a CSV with house prices. Can you predict price based on size and location?"
Claude: [Runs linear regression, provides R², coefficients, and diagnostic plots]

Customer Segmentation

User: "Segment my customers in sales_data.csv into meaningful groups"
Claude: [Performs k-means clustering, creates segment profiles with visualizations]

Time Series Forecasting

User: "Forecast next quarter's revenue using our historical data"
Claude: [Applies ARIMA, generates predictions with confidence intervals]

Security & Compliance

Enterprise Security Features

- Authentication: OAuth2 via Auth0 with PKCE
- Encryption: TLS 1.3 for all data transfers
- Processing: Isolated Docker containers per analysis
- Data Handling: Ephemeral processing, no persistence
- Access Control: OAuth 2.0 scoped permissions with usage limits
- Audit Trail: Complete logging for compliance

Privacy & Data Handling

- Data Privacy: Ephemeral processing, no data retention
- User Rights: Data deletion upon request
- Secure Processing: Isolated containers per analysis
- Enterprise Options: Contact us for compliance requirements

Read full security documentation →

Architecture

flowchart TB
    subgraph "Client Integration"
        CLI[CLI/SDK]
        Claude[Claude Desktop]
        Cursor[Cursor IDE]
        MCP[MCP Protocol]
    end

subgraph "API Gateway"
LB[Load Balancer]
Auth[OAuth 2.0/Auth0]
Rate[Rate Limiting]
end

subgraph "Processing Layer"
Router[Request Router]
Queue[Job Queue]
Workers[Processing Workers]
Docker[Docker Containers]
end

subgraph "Analytics Engine"
Stats[Statistical Methods]
ML[Machine Learning]
TS[Time Series]
Report[Report Generation]
end

subgraph "Data Layer"
Cache[Results Cache]
Storage[Secure Storage]
Encrypt[Encryption Layer]
end

CLI --> LB
Claude --> LB
Cursor --> LB
MCP --> LB

LB --> Auth
Auth --> Rate
Rate --> Router

Router --> Queue
Queue --> Workers
Workers --> Docker

Docker --> Stats
Docker --> ML
Docker --> TS

Stats --> Report
ML --> Report
TS --> Report

Report --> Cache
Cache --> Storage
Storage --> Encrypt

style Auth fill:#e8f5e9
style Docker fill:#fff3e0
style Report fill:#e3f2fd

Performance

- Dataset Size: Handles large datasets
- Processing Time: Fast cloud-based processing
- Secure Infrastructure: Isolated Docker containers
- API Access: RESTful API with authentication

Getting Started

Visit our website for pricing and signup →

Documentation

- Quick Start Guide - Get running in under a minute
- Architecture - How the platform works
- Connectors - GA4, GSC, and CSV data sources
- Pricing - Plans and limits
- Security - Security & compliance details
- API Reference - Complete API documentation
- Tutorials - Step-by-step guides

Support

- Issues: GitHub Issues
- Email: [email protected]
- Docs: mcpanalytics.ai/docs
- Enterprise: [email protected]

Comparison with Other MCP Servers

| Feature | MCP Analytics | Google Analytics MCP | PostgreSQL MCP | Filesystem MCP |
|---------|--------------|---------------------|----------------|----------------|
| Use Case | Statistical Analysis | Web Metrics | Database Queries | File Access |
| Setup Time | 30 seconds | OAuth + Config | Connection string | Path config |
| Data Sources | Any CSV/JSON/URL | GA4 Only | PostgreSQL Only | Local files |
| Analysis Tools | Full Suite | GA4 Metrics | SQL Only | Read/Write |
| Machine Learning | ✅ Full Suite | ❌ | ❌ | ❌ |
| Visualizations | ✅ Interactive | ✅ Dashboards | ❌ | ❌ |
| Shareable Reports | ✅ | ❌ | ❌ | ❌ |

Detailed comparison →

About MCP Analytics

MCP Analytics is built by data scientists and engineers passionate about making advanced statistical analysis accessible through AI assistants. The platform runs validated, deterministic analysis modules — the same data and tool produce the same result every time, unlike LLM code generation.

Testing & Support

Testing Your Connection

After installation, restart your IDE and look for "MCP Analytics" in the available tools. On first use, you'll be prompted to authenticate via OAuth 2.0.

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.