Mcp Analytics
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:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Mcp AnalyticsCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- 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">
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 | ✅ | ❌ | ❌ | ❌ |
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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.


