• RAW DATA
  • SEGMENTS
  • TRENDS
  • HUMAN

How to query custom analytics data with your AI

Connect Piwik PRO to your AI client once. After that, you can ask for specific data points without opening the Piwik PRO dashboard.

Ask AI about this page

Short answer

How do I pull specific Piwik PRO metrics using my AI?

Your AI uses JSON-based queries to fetch the exact dimensions and metrics you ask for. You get precise data breakdowns for any segment or period you define. Here is how the data moves from your analytics to your chat.

Data outcomes

What you get from your queries

The specific results your AI delivers after running a query.

RAW DATA

Specific metric sets

The AI pulls the exact numbers you requested. You get clean lists of visits, pageviews, or conversion rates.

SEGMENTS

Filtered audience insights

The AI isolates specific user groups. You can see how different segments behave without manual filtering.

TRENDS

Time-based comparisons

Your agent compares metrics across different dates. It identifies shifts in traffic or engagement patterns.

HUMAN

Strategic decisions

The AI provides the numbers, but you decide what they mean for your business. You interpret the results to plan your next move.

The workflow

What your AI does when you ask for data.

The AI translates your natural language into a structured request that Piwik PRO understands.

  1. Parse the request

    Your AI looks at your question to figure out which dimensions and metrics you actually need.

    query_piwik_analytics

  2. Build the query

    The agent constructs a JSON-based query containing your requested filters and timeframes.

    query_piwik_analytics

  3. Fetch the data

    The AI sends the query to Piwik PRO and waits for the specific data payload.

    query_piwik_analytics

  4. Format the answer

    The agent takes the raw JSON response and turns it into a readable summary or table for you.

    query_piwik_analytics

Try it

Copy these to start.

Use these prompts to begin querying your data.

Starting points

Swap out the website names or date ranges to match your actual Piwik PRO setup.

Piwik PRO Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_2nFq807K667osyvr1pMGgBD7kRPIjzFgWQR6riUy/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Piwik PRO capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "piwik-pro-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_2nFq807K667osyvr1pMGgBD7kRPIjzFgWQR6riUy/mcp"
    }
  }
}
Copy into chat04

  • Show me the total pageviews for my main website from last week.

  • Which device types had the highest conversion rate on my landing page yesterday?

  • Compare the number of unique visitors from organic search versus social media this month.

  • List the top 5 most visited pages on my site for the last 30 days.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Piwik PRO once, then ask.

Just follow the link to authorize the connection. Your credentials stay encrypted, and you can immediately start chatting with your analytics data.

Connect Piwik PRO to your AI

FAQ

How this task behaves

  • 01

    Can my AI change my Piwik PRO settings?

    No. The AI can only read data through the query tool. It cannot modify your tracking code or site settings.

  • 02

    Does the AI delete any of my analytics data?

    No. This connection is read-only. Your data stays exactly as it is in Piwik PRO.

  • 03

    Can I ask for data that isn't in my Piwik PRO account?

    No. The AI can only access the data that is already being collected and stored in your Piwik PRO instance.

  • 04

    Do I need to write JSON to get answers?

    No. You talk to your AI in plain English. It handles the JSON query construction for you.

  • 05

    Can the AI create new custom reports in the dashboard?

    No. The AI pulls data for your chat session, but it does not create or save new report objects in the Piwik PRO interface.

  • More questions about Piwik PRO? The Connector page answers them. See everything the Piwik PRO Connector can do

Connect Piwik PRO to Claude, Cursor, ChatGPT & more