Setup

Three steps to your first analysis

Get your API key

Sign up at app.mcpanalytics.ai, go to account settings, and click Reveal API Key. Copy the key — it starts with mcp_.

You get 2,000 free credits on signup — enough for ~15 reports. No credit card required.

Pick a connection method

Choose the option that fits your setup. All three connect to the same platform with the same tools.

Option A: npx install

Recommended

One-line install. Works everywhere. The npm package proxies to our API — no local dependencies beyond Node.js.

// ~/.claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcpanalytics": {
      "command": "npx",
      "args": ["-y", "@mcp-analytics/mcp-analytics"],
      "env": {
        "MCP_ANALYTICS_API_KEY": "mcp_your_key_here"
      }
    }
  }
}

// .cursor/mcp.json (or Settings > MCP Servers)

{
  "mcpServers": {
    "mcpanalytics": {
      "command": "npx",
      "args": ["-y", "@mcp-analytics/mcp-analytics"],
      "env": {
        "MCP_ANALYTICS_API_KEY": "mcp_your_key_here"
      }
    }
  }
}

# Add via Claude Code CLI

claude mcp add mcpanalytics \
  -- npx -y @mcp-analytics/mcp-analytics

# Then set your API key in the environment:
# MCP_ANALYTICS_API_KEY=mcp_your_key_here

Option B: Direct API key

No npm needed. Your MCP client connects directly to our API via HTTP. Requires a client that supports custom headers on Streamable HTTP transport.

// Claude Desktop config

{
  "mcpServers": {
    "mcpanalytics": {
      "url": "https://api.mcpanalytics.ai/mcp/api-key",
      "headers": {
        "X-API-Key": "mcp_your_key_here"
      }
    }
  }
}

Option C: OAuth2 (no API key)

Zero-config authentication. A browser window opens for login on first connection. No API key to manage. Works if your client supports MCP OAuth2.

// Claude Desktop config

{
  "mcpServers": {
    "mcpanalytics": {
      "url": "https://api.mcpanalytics.ai/auth0"
    }
  }
}

Browse tools first (no account needed)

Explore the full tool catalog before signing up. Public discovery endpoint — no authentication required. See every analysis available.

# Browse the tool catalog
curl -s https://api.mcpanalytics.ai/.well-known/mcp.json | jq '.tools'

# Or via MCP protocol (for MCP clients)
POST https://api.mcpanalytics.ai/mcp/discover
{"jsonrpc":"2.0","method":"tools/list","id":1,"params":{}}

Restart and analyze

Restart your MCP client. MCP Analytics is now available as a tool. Try one of these to get started:

Try saying:

"Upload sales.csv and find which products drive the most revenue"
"What statistical test should I use for this survey data?"
"Run customer segmentation on my Shopify export"
"Forecast next quarter's revenue from this time series"

Connect in 2 minutes

Three steps to your first analysis

Get your API key

Pick a connection method

Option A: npx install

Option B: Direct API key

Option C: OAuth2 (no API key)

Browse tools first (no account needed)

Restart and analyze

Try saying:

Go deeper

GitHub

Developer Docs

Full Documentation

Ready to start?