Piwik PRO

Provides an MCP server to query analytics data, manage Piwik PRO resources, and configure Tag Manager, audiences, and settings via an MCP client.

other

7

GitHub Stars

other

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "piwikpro-mcp": {
      "command": "uvx",
      "args": [
        "piwik-pro-mcp"
      ],
      "env": {
        "PIWIK_PRO_HOST": "ACCOUNT.piwik.pro",
        "PIWIK_PRO_CLIENT_ID": "CLIENT_ID",
        "PIWIK_PRO_CLIENT_SECRET": "CLIENT_SECRET"
      }
    }
  }
}

You can run and interact with the Piwik PRO MCP Server to control your analytics resources via a Model Context Protocol (MCP) client. This server exposes a conversational interface to query data, manage analytics configurations, and create audience segments, all while being configurable through simple MCP client setups and environment variables.

How to use

To use the MCP server, you connect with an MCP client configured to start the server process locally. You can then ask natural language questions about visitors, page views, conversions, and other analytics data. Use prompts to list apps, view top pages, inspect conversion trends, manage tags and annotations, and adjust segmentation rules. Start in safe mode to explore the capabilities without risking changes, then gradually disable safe mode to perform create, update, or delete actions.

How to install

Prerequisites: ensure you have a runtime capable of running MCP configurations. You will use either UV (uvx) or Docker to start the MCP server. You also need to obtain API credentials from your Piwik PRO account.

Step 1: Prepare credentials in your account and note the three required values. They are the host, client ID, and client secret.

Step 2: Create a configuration file for MCP with the appropriate environment variables and the chosen runtime command.

Step 3: Start the MCP server using the selected option below. The configuration snippets show how to wire the environment variables and the start command.

Additional configuration and usage notes

You can keep sensitive values out of your configuration file by placing them in a separate environment file and referencing it in your MCP configuration with an environment file flag.

Telemetry and resource checks can be controlled via environment variables. You can disable telemetry or skip template validation during experimentation by setting the corresponding variables to 0.

If you need to restart after changes, restart your MCP client so that the new configuration takes effect.

Available tools

Query API

Interact with your analytics data using natural language queries to retrieve metrics, dimensions, and insights with flexible date ranges and filters.

Analytics Management

Manage annotations, goals, and custom dimensions to organize and enrich analytics data.

Tag Manager

Create tags, define triggers, store variables, and publish changes with version control for your tracking setup.

Customer Data Platform

Build and manage audience segments with rules based on user behavior and on-the-fly updates.

Configuration & Settings

Tune app management, tracker settings, and container configuration to fit your deployment needs.