matomo-mcp 2.0.0

package/README.md

@@ -0,0 +1,270 @@
+# Matomo MCP Server
+
+A Model Context Protocol (MCP) server that provides access to Matomo analytics data through AI assistants like Cursor, Claude Desktop, and Claude Code.
+
+## Features
+
+- **Website Analytics**: Get visits, page views, bounce rates, and visitor statistics
+- **Real-time Data**: Access live visitor counters and current activity
+- **Top Pages**: Retrieve most visited pages with detailed metrics
+- **Date Ranges**: Query data for specific periods or date ranges
+- **Secure**: API credentials stored in environment variables
+- **Extensible**: Easy to add more Matomo features as needed
+
+## Available Tools
+
+### `get-visits-summary`
+Get comprehensive website analytics summary including visits, page views, bounce rate, and more.
+
+**Parameters:**
+- `period` (optional): Time period - `day`, `week`, `month`, or `year` (default: `day`)
+- `date` (optional): Date - `yesterday`, `today`, `YYYY-MM-DD`, `last7`, `last30`, etc. (default: `yesterday`)
+
+### `get-live-counters`
+Get real-time visitor counters for the last 30 minutes.
+
+**Parameters:** None
+
+### `get-top-pages`
+Get the most visited pages on the website.
+
+**Parameters:**
+- `period` (optional): Time period - `day`, `week`, `month`, or `year` (default: `day`)
+- `date` (optional): Date - `yesterday`, `today`, `YYYY-MM-DD`, `last7`, `last30`, etc. (default: `yesterday`)
+- `limit` (optional): Maximum number of pages to return (1-100, default: 10)
+
+### `get-visits-summary-range`
+Get website analytics summary for a date range.
+
+**Parameters:**
+- `period` (optional): Time period - `day`, `week`, `month`, or `year` (default: `day`)
+- `date` (optional): Date range - `last7`, `last30`, `last90`, etc. (default: `last7`)
+
+## Installation
+
+1. **Clone or download this repository**
+   ```bash
+   git clone <repository-url>
+   cd matomo-mcp
+   ```
+
+2. **Install dependencies**
+   ```bash
+   npm install
+   ```
+
+3. **Configure environment variables**
+   ```bash
+   cp .env.example .env
+   ```
+   
+   Edit `.env` with your Matomo credentials:
+   ```
+   MATOMO_URL=https://your-matomo-instance.com
+   MATOMO_API_KEY=your_api_key_here
+   MATOMO_SITE_ID=your_site_id
+   ```
+
+4. **Build the project**
+   ```bash
+   npm run build
+   ```
+
+## Configuration
+
+### For Cursor
+
+1. Open Cursor settings
+2. Navigate to MCP Servers configuration
+3. Add the following configuration:
+
+```json
+{
+  "mcpServers": {
+    "matomo": {
+      "command": "node",
+      "args": ["/path/to/matomo-mcp/dist/index.js"],
+      "env": {
+        "MATOMO_URL": "https://your-matomo-instance.com",
+        "MATOMO_API_KEY": "your_api_key_here",
+        "MATOMO_SITE_ID": "your_site_id"
+      }
+    }
+  }
+}
+```
+
+### For Claude Desktop
+
+1. Open Claude Desktop settings
+2. Navigate to MCP Servers
+3. Add a new server with the same configuration as above
+
+### For Claude Code CLI
+
+Claude Code supports MCP servers through project-level configuration files.
+
+**Setup:**
+
+1. Ensure your `.env` file is configured with your Matomo credentials
+2. The project includes a `.mcp.json` file that references environment variables:
+   ```json
+   {
+     "mcpServers": {
+       "matomo": {
+         "command": "node",
+         "args": ["${PWD}/dist/index.js"],
+         "env": {
+           "MATOMO_URL": "${MATOMO_URL}",
+           "MATOMO_API_KEY": "${MATOMO_API_KEY}",
+           "MATOMO_SITE_ID": "${MATOMO_SITE_ID}"
+         }
+       }
+     }
+   }
+   ```
+3. When you start Claude Code in this project directory, you'll be prompted to approve the MCP server
+4. After approval, Claude Code can access your Matomo analytics directly
+
+**Verify Configuration:**
+```bash
+# List configured MCP servers
+claude mcp list
+
+# Get details about the Matomo server
+claude mcp get matomo
+```
+
+**Security Note:** The `.mcp.json` file uses environment variable references (`${MATOMO_API_KEY}`) instead of hardcoded values, making it safe to commit to version control. Your actual credentials remain in `.env` which is excluded from git.
+
+## Usage Examples
+
+Once configured, you can ask your AI assistant questions like:
+
+- "Show me yesterday's website analytics"
+- "What are the top 5 pages from last week?"
+- "How many visitors are currently on the site?"
+- "Give me a summary of visits for the last 7 days"
+- "What's the bounce rate for this month?"
+
+## Development
+
+### Project Structure
+
+```
+matomo-mcp/
+├── src/
+│   ├── index.ts          # Main MCP server implementation
+│   └── matomo-client.ts  # Matomo API client wrapper
+├── config/               # Client configuration examples
+├── dist/                 # Compiled JavaScript (after build)
+├── .mcp.json            # Claude Code CLI configuration (project-level)
+├── .env                 # Your credentials (DO NOT commit)
+├── .env.example         # Environment variables template
+├── claude.md            # Claude-specific integration guide
+└── README.md            # This file
+```
+
+### Adding New Tools
+
+To add new Matomo features:
+
+1. **Add API method to MatomoClient** (`src/matomo-client.ts`):
+   ```typescript
+   async getNewFeature(params: any): Promise<NewFeatureData> {
+     return this.makeApiCall<NewFeatureData>('NewModule.getMethod', params);
+   }
+   ```
+
+2. **Add tool definition** in `src/index.ts`:
+   ```typescript
+   {
+     name: 'get-new-feature',
+     description: 'Description of the new feature',
+     inputSchema: {
+       type: 'object',
+       properties: {
+         // Define parameters
+       },
+     },
+   }
+   ```
+
+3. **Add tool handler** in the `CallToolRequestSchema` handler:
+   ```typescript
+   case 'get-new-feature': {
+     const data = await this.matomoClient.getNewFeature(args);
+     return {
+       content: [{
+         type: 'text',
+         text: formatData(data),
+       }],
+     };
+   }
+   ```
+
+### Building and Testing
+
+```bash
+# Build the project
+npm run build
+
+# Run in development mode
+npm run dev
+
+# Run the built server
+npm start
+```
+
+## Security
+
+- API credentials are stored in environment variables
+- Never commit `.env` files to version control
+- Use HTTPS for your Matomo instance
+- Consider using read-only API keys for security
+
+## Troubleshooting
+
+### Common Issues
+
+1. **"Missing required environment variables"**
+   - Ensure `.env` file exists and contains all required variables
+   - Check that variable names match exactly
+
+2. **"Matomo API error: 401"**
+   - Verify your API key is correct
+   - Check that the API key has proper permissions
+
+3. **"Matomo API error: 404"**
+   - Verify your Matomo URL is correct
+   - Ensure the site ID exists
+
+4. **Server not starting**
+   - Run `npm run build` to compile TypeScript
+   - Check that all dependencies are installed
+
+### Debug Mode
+
+To enable debug logging, set the environment variable:
+```bash
+DEBUG=matomo-mcp
+```
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add tests if applicable
+5. Submit a pull request
+
+## License
+
+ISC License - see LICENSE file for details
+
+## Support
+
+For issues and questions:
+1. Check the troubleshooting section above
+2. Review Matomo API documentation
+3. Open an issue in this repository

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,314 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const matomo_client_js_1 = require("./matomo-client.js");
+class MatomoMCPServer {
+    constructor() {
+        this.server = new index_js_1.Server({
+            name: 'matomo-mcp',
+            version: '2.0.0',
+        }, {
+            capabilities: {
+                tools: {},
+            },
+        });
+        this.matomoClient = new matomo_client_js_1.MatomoClient();
+        this.setupToolHandlers();
+    }
+    setupToolHandlers() {
+        // Shared schema fragments
+        const siteIdParam = {
+            type: 'string',
+            description: 'Matomo site ID. Use list-sites to see available sites. Defaults to env MATOMO_SITE_ID.',
+        };
+        const segmentParam = {
+            type: 'string',
+            description: 'Matomo segment filter (e.g., "customVariableValue1==us-east-1"). See Matomo segment docs for syntax.',
+        };
+        const periodParam = {
+            type: 'string',
+            description: 'Time period (day, week, month, year)',
+            enum: ['day', 'week', 'month', 'year'],
+            default: 'day',
+        };
+        const dateParam = {
+            type: 'string',
+            description: 'Date or range (yesterday, today, YYYY-MM-DD, last7, last30, etc.)',
+            default: 'yesterday',
+        };
+        // List available tools
+        this.server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
+            return {
+                tools: [
+                    {
+                        name: 'list-sites',
+                        description: 'List all Matomo sites you have access to, with their IDs and URLs',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {},
+                        },
+                    },
+                    {
+                        name: 'get-visits-summary',
+                        description: 'Get website analytics summary — visits, page views, bounce rate, and more. Use date like "yesterday" for a single period or "last7"/"last30" for a daily breakdown over a range.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                period: periodParam,
+                                date: dateParam,
+                                site_id: siteIdParam,
+                                segment: segmentParam,
+                            },
+                        },
+                    },
+                    {
+                        name: 'get-live-counters',
+                        description: 'Get real-time visitor counters for the last 30 minutes',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                site_id: siteIdParam,
+                                segment: segmentParam,
+                            },
+                        },
+                    },
+                    {
+                        name: 'get-top-pages',
+                        description: 'Get the most visited pages on a website',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                period: periodParam,
+                                date: dateParam,
+                                limit: {
+                                    type: 'number',
+                                    description: 'Maximum number of pages to return',
+                                    default: 10,
+                                    minimum: 1,
+                                    maximum: 100,
+                                },
+                                site_id: siteIdParam,
+                                segment: segmentParam,
+                            },
+                        },
+                    },
+                    {
+                        name: 'get-referrers',
+                        description: 'Get traffic sources — channel overview (Direct, Search, Social, etc.) or campaign breakdown. Set type to "campaigns" to see campaign names and metrics.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                period: periodParam,
+                                date: dateParam,
+                                type: {
+                                    type: 'string',
+                                    description: 'Omit for channel overview, set to "campaigns" for campaign breakdown',
+                                    enum: ['campaigns'],
+                                },
+                                site_id: siteIdParam,
+                                segment: segmentParam,
+                            },
+                        },
+                    },
+                    {
+                        name: 'get-events',
+                        description: 'Get event analytics — categories overview or actions within a specific category. Useful for tracking feature adoption, user interactions, and custom events.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                period: periodParam,
+                                date: dateParam,
+                                category: {
+                                    type: 'string',
+                                    description: 'Event category to drill into (e.g., "Chat", "UI v2", "Feature"). Omit to see all categories.',
+                                },
+                                site_id: siteIdParam,
+                                segment: segmentParam,
+                            },
+                        },
+                    },
+                ],
+            };
+        });
+        // Handle tool calls
+        this.server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            const a = (args || {});
+            try {
+                switch (name) {
+                    case 'list-sites': {
+                        const sites = await this.matomoClient.listSites();
+                        let text = '## Available Matomo Sites\n\n';
+                        sites.forEach((site) => {
+                            text += `- **Site ${site.idsite}**: ${site.name} — ${site.main_url}\n`;
+                        });
+                        return { content: [{ type: 'text', text }] };
+                    }
+                    case 'get-visits-summary': {
+                        const period = a.period || 'day';
+                        const date = a.date || 'yesterday';
+                        const data = await this.matomoClient.getVisitsSummary(period, date, a.site_id, a.segment);
+                        // Range mode: date like "last7", "last30" returns { "2024-01-01": {...}, ... }
+                        const isRange = typeof data === 'object' && !('nb_visits' in data);
+                        if (isRange) {
+                            const rangeData = data;
+                            let text = `## Analytics Summary (${period}: ${date})\n\n`;
+                            for (const [dateKey, dayData] of Object.entries(rangeData)) {
+                                const uv = dayData.nb_uniq_visitors || dayData.nb_visitors || 0;
+                                text += `**${dateKey}**: ${dayData.nb_visits.toLocaleString()} visits, ${dayData.nb_actions.toLocaleString()} page views, ${uv.toLocaleString()} unique visitors, ${dayData.bounce_rate} bounce rate\n`;
+                            }
+                            return { content: [{ type: 'text', text }] };
+                        }
+                        // Single period mode
+                        const d = data;
+                        const uniqueVisitors = d.nb_uniq_visitors || d.nb_visitors || 0;
+                        const avgActionsPerVisit = d.nb_actions_per_visit || (d.nb_visits > 0 ? (d.nb_actions / d.nb_visits) : 0);
+                        const avgVisitDuration = d.avg_time_on_site || (d.nb_visits > 0 ? Math.round(d.sum_visit_length / d.nb_visits) : 0);
+                        const conversions = d.nb_conversions || d.nb_visits_converted || 0;
+                        const revenue = d.revenue || 0;
+                        return {
+                            content: [{
+                                    type: 'text',
+                                    text: `## Analytics Summary (${period}: ${date})\n\n` +
+                                        `- **Visits**: ${d.nb_visits.toLocaleString()}\n` +
+                                        `- **Page Views**: ${d.nb_actions.toLocaleString()}\n` +
+                                        `- **Unique Visitors**: ${uniqueVisitors.toLocaleString()}\n` +
+                                        `- **Bounce Rate**: ${d.bounce_rate}\n` +
+                                        `- **Avg Actions/Visit**: ${typeof avgActionsPerVisit === 'number' ? avgActionsPerVisit.toFixed(2) : avgActionsPerVisit}\n` +
+                                        `- **Avg Visit Duration**: ${avgVisitDuration}s\n` +
+                                        `- **Conversions**: ${conversions}\n` +
+                                        `- **Revenue**: $${revenue.toFixed(2)}`,
+                                }],
+                        };
+                    }
+                    case 'get-live-counters': {
+                        const data = await this.matomoClient.getLiveCounters(a.site_id, a.segment);
+                        const visitsConverted = data.visitsConverted || data.visits_conv || 0;
+                        return {
+                            content: [{
+                                    type: 'text',
+                                    text: `## Live Visitors (Last 30 min)\n\n` +
+                                        `- **Visitors**: ${data.visitors}\n` +
+                                        `- **Visits**: ${data.visits}\n` +
+                                        `- **Actions**: ${data.actions}\n` +
+                                        `- **Converted Visits**: ${visitsConverted}`,
+                                }],
+                        };
+                    }
+                    case 'get-top-pages': {
+                        const period = a.period || 'day';
+                        const date = a.date || 'yesterday';
+                        const limit = a.limit || 10;
+                        const data = await this.matomoClient.getTopPages(period, date, limit, a.site_id, a.segment);
+                        let text = `## Top Pages (${period}: ${date})\n\n`;
+                        data.forEach((page, index) => {
+                            text += `${index + 1}. **${page.label}**\n` +
+                                `   - Visits: ${page.nb_visits.toLocaleString()} | Views: ${page.nb_hits.toLocaleString()}\n` +
+                                `   - Bounce: ${page.bounce_rate} | Exit: ${page.exit_rate} | Avg Time: ${Math.round(page.avg_time_on_page)}s\n` +
+                                `   - ${page.url}\n\n`;
+                        });
+                        return { content: [{ type: 'text', text }] };
+                    }
+                    case 'get-referrers': {
+                        const period = a.period || 'day';
+                        const date = a.date || 'yesterday';
+                        if (a.type === 'campaigns') {
+                            const data = await this.matomoClient.getCampaigns(period, date, a.site_id, a.segment);
+                            let text = `## Campaigns (${period}: ${date})\n\n`;
+                            if (!data.length) {
+                                text += 'No campaign data found for this period.\n';
+                            }
+                            else {
+                                data.forEach((campaign) => {
+                                    text += `- **${campaign.label}**: ${campaign.nb_visits.toLocaleString()} visits, ${campaign.nb_actions.toLocaleString()} actions`;
+                                    if (campaign.bounce_rate)
+                                        text += `, ${campaign.bounce_rate} bounce`;
+                                    text += '\n';
+                                });
+                            }
+                            return { content: [{ type: 'text', text }] };
+                        }
+                        // Default: channel overview
+                        const data = await this.matomoClient.getReferrerTypes(period, date, a.site_id, a.segment);
+                        let text = `## Traffic Sources (${period}: ${date})\n\n`;
+                        if (!data.length) {
+                            text += 'No referrer data found for this period.\n';
+                        }
+                        else {
+                            data.forEach((ref) => {
+                                text += `- **${ref.label}**: ${ref.nb_visits.toLocaleString()} visits, ${ref.nb_actions.toLocaleString()} actions`;
+                                if (ref.bounce_rate)
+                                    text += `, ${ref.bounce_rate} bounce`;
+                                text += '\n';
+                            });
+                        }
+                        return { content: [{ type: 'text', text }] };
+                    }
+                    case 'get-events': {
+                        const period = a.period || 'day';
+                        const date = a.date || 'yesterday';
+                        if (a.category) {
+                            const data = await this.matomoClient.getEventActions(period, date, a.category, a.site_id, a.segment);
+                            let text = `## Event Actions — ${a.category} (${period}: ${date})\n\n`;
+                            if (!data.length) {
+                                text += `No actions found for category "${a.category}" in this period.\n`;
+                            }
+                            else {
+                                data.forEach((event) => {
+                                    text += `- **${event.label}**: ${event.nb_events} events, ${event.nb_visits} visits`;
+                                    if (event.avg_event_value != null)
+                                        text += `, avg value: ${event.avg_event_value}`;
+                                    text += '\n';
+                                });
+                            }
+                            return { content: [{ type: 'text', text }] };
+                        }
+                        // Default: category overview
+                        const data = await this.matomoClient.getEventCategories(period, date, a.site_id, a.segment);
+                        let text = `## Event Categories (${period}: ${date})\n\n`;
+                        if (!data.length) {
+                            text += 'No event data found for this period.\n';
+                        }
+                        else {
+                            data.forEach((event) => {
+                                text += `- **${event.label}**: ${event.nb_events} events, ${event.nb_visits} visits`;
+                                if (event.avg_event_value != null)
+                                    text += `, avg value: ${event.avg_event_value}`;
+                                text += '\n';
+                            });
+                        }
+                        return { content: [{ type: 'text', text }] };
+                    }
+                    default:
+                        throw new Error(`Unknown tool: ${name}`);
+                }
+            }
+            catch (error) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Error: ${error instanceof Error ? error.message : 'Unknown error occurred'}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        });
+    }
+    async run() {
+        const transport = new stdio_js_1.StdioServerTransport();
+        await this.server.connect(transport);
+        console.error('Matomo MCP server running on stdio');
+    }
+}
+// Start the server
+const server = new MatomoMCPServer();
+server.run().catch((error) => {
+    console.error('Fatal error in Matomo MCP server:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/matomo-client.d.ts

@@ -0,0 +1,97 @@
+export interface VisitsSummaryData {
+    nb_visits: number;
+    nb_actions: number;
+    nb_uniq_visitors?: number;
+    nb_visitors?: number;
+    nb_users?: number;
+    max_actions: number;
+    bounce_rate: string;
+    nb_visits_converted: number;
+    sum_visit_length: number;
+    bounce_rate_returning?: string;
+    nb_actions_returning?: number;
+    max_actions_returning?: number;
+    sum_visit_length_returning?: number;
+    nb_visits_converted_returning?: number;
+    revenue?: number;
+    revenue_returning?: number;
+    nb_conversions?: number;
+    nb_conversions_returning?: number;
+    conversions?: number;
+    conversions_returning?: number;
+    nb_visits_new?: number;
+    bounces?: number;
+    bounce_count?: number;
+    sum_visit_length_new?: number;
+    nb_actions_new?: number;
+    max_actions_new?: number;
+    bounce_rate_new?: string;
+    nb_visits_converted_new?: number;
+    revenue_new?: number;
+    nb_conversions_new?: number;
+    conversions_new?: number;
+    nb_actions_per_visit?: number;
+    avg_time_on_site?: number;
+}
+export interface LiveCountersData {
+    visits: number;
+    actions: number;
+    visitors: number;
+    visitsConverted?: number;
+    visits_conv?: number;
+    actions_conv?: number;
+    visitors_conv?: number;
+}
+export interface TopPagesData {
+    label: string;
+    nb_visits: number;
+    nb_hits: number;
+    sum_time_spent: number;
+    bounce_rate: string;
+    exit_rate: string;
+    avg_time_on_page: number;
+    url: string;
+}
+export interface SiteData {
+    idsite: string;
+    name: string;
+    main_url: string;
+}
+export interface ReferrerData {
+    label: string;
+    nb_visits: number;
+    nb_actions: number;
+    nb_uniq_visitors?: number;
+    bounce_rate?: string;
+    revenue?: number;
+}
+export interface EventData {
+    label: string;
+    nb_visits: number;
+    nb_events: number;
+    nb_uniq_visitors?: number;
+    sum_event_value?: number;
+    avg_event_value?: number;
+}
+export interface MatomoApiResponse<T> {
+    value: T;
+    date: string;
+    period: string;
+    segment: string;
+}
+export declare class MatomoClient {
+    private baseUrl;
+    private apiKey;
+    private defaultSiteId;
+    constructor();
+    private makeApiCall;
+    listSites(): Promise<SiteData[]>;
+    getVisitsSummary(period?: string, date?: string, siteId?: string, segment?: string): Promise<VisitsSummaryData | Record<string, VisitsSummaryData>>;
+    getLiveCounters(siteId?: string, segment?: string): Promise<LiveCountersData>;
+    getTopPages(period?: string, date?: string, limit?: number, siteId?: string, segment?: string): Promise<TopPagesData[]>;
+    getReferrerTypes(period?: string, date?: string, siteId?: string, segment?: string): Promise<ReferrerData[]>;
+    getCampaigns(period?: string, date?: string, siteId?: string, segment?: string): Promise<ReferrerData[]>;
+    getEventCategories(period?: string, date?: string, siteId?: string, segment?: string): Promise<EventData[]>;
+    getEventActions(period: string | undefined, date: string | undefined, category: string, siteId?: string, segment?: string): Promise<EventData[]>;
+}
+//# sourceMappingURL=matomo-client.d.ts.map

package/dist/matomo-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matomo-client.d.ts","sourceRoot":"","sources":["../src/matomo-client.ts"],"names":[],"mappings":"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"}

package/dist/matomo-client.js

@@ -0,0 +1,77 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MatomoClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+class MatomoClient {
+    constructor() {
+        this.baseUrl = process.env.MATOMO_URL || '';
+        this.apiKey = process.env.MATOMO_API_KEY || '';
+        this.defaultSiteId = process.env.MATOMO_SITE_ID || '';
+        if (!this.baseUrl || !this.apiKey || !this.defaultSiteId) {
+            throw new Error('Missing required environment variables: MATOMO_URL, MATOMO_API_KEY, MATOMO_SITE_ID');
+        }
+    }
+    async makeApiCall(method, params = {}, siteId, segment) {
+        try {
+            const callParams = {
+                module: 'API',
+                method,
+                idSite: siteId || this.defaultSiteId,
+                format: 'JSON',
+                token_auth: this.apiKey,
+                ...Object.fromEntries(Object.entries(params).map(([key, value]) => [key, String(value)])),
+            };
+            if (segment) {
+                callParams.segment = segment;
+            }
+            const formData = new URLSearchParams(callParams);
+            const response = await axios_1.default.post(`${this.baseUrl}/index.php`, formData, {
+                headers: {
+                    'Content-Type': 'application/x-www-form-urlencoded',
+                },
+            });
+            return response.data;
+        }
+        catch (error) {
+            if (axios_1.default.isAxiosError(error)) {
+                const errorMsg = error.response?.data?.message || error.response?.statusText;
+                throw new Error(`Matomo API error: ${error.response?.status} - ${errorMsg}`);
+            }
+            throw new Error(`Failed to call Matomo API: ${error}`);
+        }
+    }
+    async listSites() {
+        return this.makeApiCall('SitesManager.getAllSites');
+    }
+    async getVisitsSummary(period = 'day', date = 'yesterday', siteId, segment) {
+        return this.makeApiCall('VisitsSummary.get', { period, date }, siteId, segment);
+    }
+    async getLiveCounters(siteId, segment) {
+        const result = await this.makeApiCall('Live.getCounters', { lastMinutes: 30 }, siteId, segment);
+        // API returns an array with one object
+        return Array.isArray(result) ? result[0] : result;
+    }
+    async getTopPages(period = 'day', date = 'yesterday', limit = 10, siteId, segment) {
+        return this.makeApiCall('Actions.getPageUrls', { period, date, expanded: 1, filter_limit: limit }, siteId, segment);
+    }
+    async getReferrerTypes(period = 'day', date = 'yesterday', siteId, segment) {
+        return this.makeApiCall('Referrers.getReferrerType', { period, date }, siteId, segment);
+    }
+    async getCampaigns(period = 'day', date = 'yesterday', siteId, segment) {
+        return this.makeApiCall('Referrers.getCampaigns', { period, date }, siteId, segment);
+    }
+    async getEventCategories(period = 'day', date = 'yesterday', siteId, segment) {
+        return this.makeApiCall('Events.getCategory', { period, date }, siteId, segment);
+    }
+    async getEventActions(period = 'day', date = 'yesterday', category, siteId, segment) {
+        // Filter to a specific category using Matomo's segment syntax
+        const categorySegment = `eventCategory==${category}`;
+        const fullSegment = segment ? `${segment};${categorySegment}` : categorySegment;
+        return this.makeApiCall('Events.getAction', { period, date }, siteId, fullSegment);
+    }
+}
+exports.MatomoClient = MatomoClient;
+//# sourceMappingURL=matomo-client.js.map

package/dist/matomo-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matomo-client.js","sourceRoot":"","sources":["../src/matomo-client.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "matomo-mcp",
+  "version": "2.0.0",
+  "description": "MCP server that gives Claude access to Matomo analytics — visits, pages, referrers, events, and more",
+  "main": "dist/index.js",
+  "bin": {
+    "matomo-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "start": "node dist/index.js",
+    "dev": "ts-node src/index.ts",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": ["mcp", "matomo", "analytics", "model-context-protocol"],
+  "author": "amazee.io",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bonus414/matomo-mcp"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.20.1",
+    "axios": "^1.12.2",
+    "dotenv": "^17.2.3"
+  },
+  "devDependencies": {
+    "@types/node": "^24.8.1",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  }
+}