@kieksme/swetrix-statistics-mcp

MCP server for the Swetrix Statistics API — 34 read-only tools for querying traffic, performance, errors, funnels, goals, and more.

Installation

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "swetrix-statistics": {
      "command": "npx",
      "args": ["-y", "@kieksme/swetrix-statistics-mcp"],
      "env": {
        "SWETRIX_API_KEY": "your-api-key",
        "SWETRIX_API_BASE_URL": "https://analytics.example.com"
      }
    }
  }
}

Claude Code

claude mcp add swetrix-statistics -e SWETRIX_API_KEY=your-key -e SWETRIX_API_BASE_URL=https://analytics.example.com -- npx -y @kieksme/swetrix-statistics-mcp

Environment variables

| Variable | Required | Description | |---|---|---| | SWETRIX_API_KEY | Yes | Your Swetrix API key (Account Settings → API keys) | | SWETRIX_API_BASE_URL | No | Custom API base URL for self-hosted Swetrix (default: https://api.swetrix.com) |

HTTP transport

By default the server communicates over stdio, as used above. It can instead be run as a standalone HTTP server speaking the MCP Streamable HTTP transport — useful for remote/containerized deployments.

| Variable | Required | Description | |---|---|---| | MCP_TRANSPORT | No | Set to http to enable the HTTP transport (default: stdio) | | PORT | No | Port to listen on in HTTP mode (default: 3000) | | MCP_HTTP_ENDPOINT | No | Path the server listens on in HTTP mode (default: /mcp) | | MCP_HTTP_AUTH_TOKEN | Yes, in HTTP mode | Bearer token clients must send; the server refuses to start without it |

MCP_TRANSPORT=http PORT=3000 MCP_HTTP_AUTH_TOKEN=change-me SWETRIX_API_KEY=your-key node dist/index.js

Every request must include Authorization: Bearer <MCP_HTTP_AUTH_TOKEN>; requests without a valid token receive 401 Unauthorized.

curl -X POST http://localhost:3000/mcp \
  -H "Authorization: Bearer change-me" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"0.0.0"}}}'

Docker

docker build -f packages/swetrix-statistics-mcp-server/Dockerfile -t swetrix-statistics-mcp:http .
docker run --rm -p 3000:3000 \
  -e SWETRIX_API_KEY=your-key \
  -e MCP_HTTP_AUTH_TOKEN=change-me \
  swetrix-statistics-mcp:http

Note: the build context is the repository root (this is a pnpm workspace).

Pre-built images are also published to the GitHub Container Registry on every release, tagged with the released package version and latest:

docker pull ghcr.io/kieksme/swetrix-statistics-mcp:latest

Tools

Traffic

| Tool | Description | |---|---| | swetrix_get_traffic | Aggregated traffic analytics (dashboard view): visitors, pageviews, bounce rate, session duration | | swetrix_get_traffic_chart | Time-series traffic chart data for a given period and interval | | swetrix_get_sessions | Paginated list of individual sessions with geo and device info | | swetrix_get_session_detail | Full event log for a single session | | swetrix_get_live_visitors | Current live visitor count | | swetrix_get_birdseye | Birdseye overview: top pages, countries, referrers, devices |

Performance

| Tool | Description | |---|---| | swetrix_get_performance | Web Vitals and performance metrics (LCP, FID, CLS, TTFB, etc.) | | swetrix_get_performance_chart | Time-series performance chart | | swetrix_get_performance_birdseye | Performance breakdown by page, country, browser, device |

Errors

| Tool | Description | |---|---| | swetrix_get_errors | Paginated list of error groups | | swetrix_get_error_detail | Full detail for a specific error including stack trace | | swetrix_get_error_overview | Error trend chart over time | | swetrix_get_error_sessions | Sessions in which a specific error occurred | | swetrix_get_errors_filters | Available filter values for error queries |

Custom Events

| Tool | Description | |---|---| | swetrix_get_event_meta | Metadata keys and values for a specific custom event | | swetrix_get_property | Aggregated stats for a custom event property | | swetrix_get_custom_events | All custom events with counts and trends | | swetrix_get_heartbeats | Heartbeat event data | | swetrix_get_keywords | Search keyword referrals |

Funnels

| Tool | Description | |---|---| | swetrix_get_funnel | Conversion funnel with per-step visitor and drop-off counts | | swetrix_get_funnel_sessions | Sessions that entered a specific funnel | | swetrix_get_user_flow | User flow / Sankey diagram data between pages |

Goals

| Tool | Description | |---|---| | swetrix_get_goal_stats | Conversion statistics for a goal (rate, trend, total) | | swetrix_get_goal_chart | Goal conversion chart over time | | swetrix_get_feature_flag_stats | Feature flag exposure and conversion stats | | swetrix_get_feature_flag_profiles | Visitor profiles that saw a feature flag | | swetrix_get_captcha | CAPTCHA solve statistics |

Visitor Profiles

| Tool | Description | |---|---| | swetrix_get_profiles | Paginated list of visitor profiles | | swetrix_get_profile_detail | Full profile for a single visitor | | swetrix_get_profile_sessions | All sessions for a specific visitor profile |

Filters

| Tool | Description | |---|---| | swetrix_get_filters | Available values for a filter dimension (browser, country, OS, etc.) | | swetrix_get_filter_versions | Browser or OS version values for a given filter column |

Example prompts

• "Show me the traffic for project abc123 over the last 7 days."
• "What are the top 5 error groups in my project this month?"
• "How is the checkout funnel performing — where are users dropping off?"
• "What's the current live visitor count for project abc123?"

License

GPL-3.0-only — see LICENSE