pirsch-mcp

[](https://www.npmjs.com/package/@joelwmale/pirsch-mcp) [](LICENSE)

A Model Context Protocol (MCP) server for Pirsch Analytics, enabling natural language analytics queries, period comparisons, and trend analysis for your website traffic.

• 🔐 Smart Authentication - OAuth client credentials with automatic token caching and refresh
• 📊 Core Analytics - Comprehensive stats including visitors, page views, bounce rates, and conversion rates
• 📈 Time Series Data - Flexible visitor trends with day/week/month/year granularity
• 🔄 Period Comparisons - Compare metrics across different time periods with calculated deltas
• ⚡ Real-time Insights - Active visitor tracking with configurable time windows
• 🎯 Advanced Filtering - Full support for Pirsch query parameters including UTM, referrers, and dimensions
• 🌍 Multi-domain Support - Manage analytics across multiple websites from one interface

The simplest way - no need to install anything globally:

claude mcp add pirsch-mcp \
  -e PIRSCH_CLIENT_ID=your_client_id \
  -e PIRSCH_CLIENT_SECRET=your_client_secret \
  -- npx -y @joelwmale/pirsch-mcp

Install once, use anywhere:

# Install globally
npm install -g @joelwmale/pirsch-mcp

# For Claude Code
claude mcp add pirsch-mcp \
  -e PIRSCH_CLIENT_ID=your_client_id \
  -e PIRSCH_CLIENT_SECRET=your_client_secret \
  -- pirsch-mcp

For contributing or customization:

# Clone and install
git clone https://github.com/joelwmale/pirsch-mcp.git
cd pirsch-mcp
npm install
npm run build

1. Log into your [Pirsch Analytics Dashboard](https://pirsch.i